本文档介绍如何批量新增和删除图片。
背景信息
批量操作流程
- 开通OSS服务。
- 将图片导入到OSS中。
- 新建increment.meta文件。
- 授予图像搜索服务访问OSS的权限。
- 在图像搜索上创建批量任务。
开通OSS服务
将图片导入到OSS中
导入图片
具体操作请参见上传文件。
说明 图片存放路径可以自定义,只需要在创建批量任务时设置图片路径即可。
新建increment.meta文件
在OSS服务中存放图片的路径下,新建increment.meta文件,该文件用来存储批量任务相关内容。
文件参考示例如下:
说明 increment.meta文件中涉及的图片必须和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": "DELETE","ProductId": "1004","PicName": "fengyi.jpg"}
{"OperationType": "DELETE","ProductId": "1005"}
每个图片由JSON格式表示,具体字段含义如下表所示:
参数 | 类型 | 是否必选 | 说明 |
---|---|---|---|
OperationType | String | 是 | 操作类型。
|
ProductId | String | 是 | 图片唯一标识符。 |
PicName | String | 是 | 图片名称。OSS的Bucket中图片名称。
说明 每行最多只允许填写1个图片名称。若同一个ProductId,对应多个PicName则需要填写多行。
|
CategoryId | Integer | 否 | 类目参考。
|
CustomContent | String | 是 | 用户自定义内容。最多支持4096个字符。 |
IntAttr | Integer | 否 | 整数类型属性。用于查询时设置过滤。 |
StrAttr | String | 否 | 字符串类型属性。最多支持128字符。用于查询时设置过滤。 |
Crop | Boolean | 否 | 是否进行主体识别。默认为ture。
|
Region | String | 否 | 图片的主体区域。格式为x1,x2,y1,y2 ,其中x1和y1是左上角的点,x2和y2是右下角的点。
说明 若设置了该参数,则Crop参数不生效,以该设置为准。
|
授予图像搜索服务访问OSS的权限
图像搜索服务通过OSS来实现数据批量操作,需要您通过STS(Security Token Service)为图像搜索服务账号授权。
- 创建RAM角色。
- 创建权限策略。
- 进行授权。
新建批量任务
后续步骤

- 如果提示信息为“部分照片处理失败,已为您分离,点击下载”,则表明该增量任务中有部分图片处理失败,用户可以下载相应文件查看处理失败的原因。
- 如果提示信息为成功,则表明该任务中所有的图片均已处理成功。