Image Search:Upload images

Ossimport

ossimport is an Object Storage Service (OSS) tool for migrating data to an OSS bucket. You can deploy it on a local server or an ECS instance to migrate data from on-premises storage or other cloud services to OSS.

Limitations

• An image can be up to 4 MB in size.

• An image's width and height must be from 101 to 4,096 pixels.

Procedure

• Step 1: Download ossimport

• Step 2: Activate Object Storage Service (OSS)

• Step 3: Create a bucket

• Step 4: Create the increment.meta file

• Step 5: Grant Image Search access to OSS

• Step 6: Upload images

Step 1: Download ossimport

Step 2: Activate OSS

For more information, see Activate OSS.

Step 3: Create a bucket

Step 4: Create the increment.meta file

{"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"}

Step 5: Grant access to OSS

Batch operations require Image Search to access your OSS resources. Grant this authorization the first time you use this feature. Skip this section if already authorized.

Step 6: Upload images

1. Log in to the Image Search console.

2. Select the target service type and instance.

3. Click the Batch Operation tab.

4. Click Create Batch Task.

   In the Create Batch Task dialog box, set the required Bucket Name and Path, confirm the Meta File, optionally provide a Callback on Completion URL, and click OK.

5. • Region

     The region where the instance resides.

   • Bucket Name

     The name of the bucket that you created in OSS.

     Important

     The OSS bucket must be in the same region as your Image Search instance.

   • Path

     The storage path for the images and the increment.meta file.

     For example, if your bucket imagesearch1 in China (Shanghai) has images and increment.meta in the imagesearch/ folder, enter that path.

   • Meta File

     The file that lists the images to be processed. The system checks if the file, named increment.meta, exists.

   • Callback on Completion

     Enter a callback URL. Only HTTP and HTTPS URLs are supported.

     {
       "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
     }

     Field	Description
     finishTime	The task completion time (second-level precision).
     instanceName	The name of the Image Search instance.
     instanceId	The ID of the Image Search instance.
     status	The task result: NORMAL (success) or FAIL (failure).
     taskId	The task ID.
     message	Result description. success indicates a successful operation.
     processResultUrl	URL to download the error report.