批量操作

批量操作流程

1. 开通OSS服务。

2. 将图片导入到OSS中。

3. 新建increment.meta文件。

4. 图像搜索服务授权。

5. 新建批量任务。

开通OSS服务

将图片导入到OSS中

新建increment.meta文件

{"OperationType": "ADD","ProductId": "1000","PicName": "girl_cloth1.jpg","CategoryId": 0,"IntAttr": 0,"StrAttr": "value1","CustomContent": "k1:v1,k2:v2,k3:v3","Region": "20,40,60,80"}
{"OperationType": "ADD","ProductId": "1000","PicName": "girl_cloth2.jpg","CategoryId": 0,"IntAttr": 0,"StrAttr": "value2","CustomContent": "k1:v1,k2:v2,k3:v3","Region": "20,40,60,80"}
{"OperationType": "ADD","ProductId": "1001","PicName": "girl_cloth3.jpg","CategoryId": 1,"CustomContent": "k1:v1,k2:v2,k3:v3"}
{"OperationType": "ADD","ProductId": "1002","PicName": "girl_cloth4.jpg","CategoryId": 0,"CustomContent": "k1:v1,k2:v2,k3:v3","Crop": false}
{"OperationType": "ADD","ProductId": "1003","PicName": "girl_cloth7.jpg","CustomContent": "https://www.aliyun.com/imagesearch/girl_cloth7.jpg"}
{"OperationType": "ADD","ProductId": "1003","PicName": "girl_cloth6.jpg","CustomContent": "k1:v1,k2:v2,k3:v3"}
{"OperationType": "ADD","ProductId": "1006","PicName": "girlCloth/girl_cloth10.jpg","CustomContent": "k1:v1,k2:v2,k3:v3"}
{"OperationType": "DELETE","ProductId": "1004","PicName": "fengyi.jpg"}
{"OperationType": "DELETE","ProductId": "1005"}

图像搜索服务授权

图像搜索服务通过OSS来实现数据批量操作，首次使用需完成账号一键授权。如已完成授权，可跳过此步骤。

1. 登录图像搜索管理控制台。

2. 选择目标服务类型和目标实例。

3. 单击批量操作页签。

   单击后，进入批量操作页面，页面左上方有新建批量任务按钮，下方为任务列表，包含所属区域、Bucket 名称、数据路径、任务状态、提示信息、最新修改时间、批量处理结果和操作列。

4. 单击新建批量任务，在对话框单击确认一键授权。

5. 在云资源访问授权页面单击确认授权。

   页面显示授权角色为 AliyunImageSearchAccessingOSSRole，权限策略为 AliyunImageSearchAccessingOSSRolePolicy（系统策略）。

新建批量任务

1. 登录图像搜索管理控制台。

2. 选择目标服务类型和目标实例。

3. 单击批量操作页签。

   进入批量操作页面，左上方显示新建批量任务按钮，下方为批量任务列表，包含Bucket名称、数据路径、任务状态、批量处理结果等列。

4. 单击新建批量任务。

   在 新建批量任务 页面，配置以下参数：Bucket 名称（必填，从下拉框选择）、数据路径（必填，需以 / 开头）、meta文件（必填，默认为 increment.meta）、完成后信息回调（选填，输入 HTTP(S) 通知回调地址），然后单击 确认。

5. 设置批量任务参数。

   • 所属区域

     实例所在区域。

   • Bucket名称

     OSS上创建的相应的Bucket名称。

     重要

     请确保开通的OSS服务以及创建的Bucket与已购买的图像搜索服务在同一个地域。

   • 数据路径

     需要上传的图片和increment.meta文件的存储路径。

     在OSS管理控制台的文件管理页面中，确认Bucket名称为imagesearch1，区域为华东2（上海），图片和increment.meta文件存放在imagesearch/文件夹下。

   • meta文件

     需要处理图片的列表文件，支持检测是否存在，文件名为increment.meta。

   • 完成后信息回调

     输入回调地址，仅支持HTTP或者HTTPS开头。

     {
       "finishTime": "2021-05-19 17:50:00",
       "instanceId": "imagesearch-cn-xxxx",
       "instanceName": "instanceName",
       "message": "success",
       "processResultUrl": "https://image-search-task-info.oss-cn-shanghai.aliyuncs.com/yyyyyyyyyy",
       "status": "NORMAL",
       "taskId": 111
     }

     字段名	描述
     finishTime	完成时间，精确到秒。
     instanceName	图像搜索实例名称。
     instanceId	图像搜索实例ID。
     status	任务执行结果，NORMAL为正常，FAIL为执行失败。
     taskId	任务ID。
     message	信息描述；success为成功。
     processResultUrl	错误结果下载。

取消批量任务

1. 如需取消“处理中”的批量任务，请单击取消。在批量操作页签的任务列表中，找到目标批量任务，在其操作列单击取消。

2. 阅读弹窗内容，单击确定，开始终止批量任务。在弹出的警告对话框中单击确定确认取消，需等待约2分钟。

3. 批量任务取消后，已执行部分会保留，任务状态变为终止。单击结果下载，查看具体执行情况。