Upload images

Introduction to the OSSImport tool

OSSImport is a tool that is provided by Alibaba Cloud Object Storage Service (OSS) to migrate data to OSS buckets. You can deploy OSSImport on your Elastic Compute Service (ECS) instance in the cloud or on your local server to migrate data that is stored locally or in another cloud storage system to OSS.

Image limits

• The size of each image to be uploaded cannot exceed 2 MB.
• The length and width of each image must range from 100 pixels to 4,096 pixels.

Procedure

1. Step 1: Download the OSSImport tool
2. Step 2: Activate the OSS service
3. Step 3: Create an OSS bucket
4. Step 4: Import the images that are specified in the increment.meta file
5. Step 5: Grant Image Search the permission to access OSS
6. Step 6: Upload images

Step 1: Download the OSSImport tool

Step 2: Activate the OSS service

For more information, see Activate OSS.

Step 3: Create an OSS bucket

Step 4: Import the images that are specified in 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": "DELETE","ProductId": "1004","PicName": "fengyi.jpg"}
{"OperationType": "DELETE","ProductId": "1005"}

Step 5: Grant Image Search the permission to access OSS

Image Search provides the batch operation feature based on OSS. You must use Security Token Service (STS) to grant your Image Search account permissions to access OSS.

1. Create a RAM role.
   1. Log on to the RAM console.
   2. In the left-side navigation pane, choose RAM Roles > Create RAM Role.
      
   3. In the Create RAM Role pane, select Alibaba Cloud Service for the Trusted entity type parameter, and then click Next.
      
   4. Configure role information.
      • Role Type: Select Normal Service Role.
      • RAM Role Name: Enter a RAM role name. The role name is imagesearch-test in this example.
      • Select Trusted Service: Select Image Search from the drop-down list.

      
2. Create a policy.
   1. In the left-side navigation pane, choose Permissions > Policies.
   2. On the Policies page, click Create Policy.
      
   3. Edit the policy content.
      • Enter a policy name.
      • Set the Configuration Mode parameter to Script. In the following example, the policy content is provided.

        {
          "Version": "1",
          "Statement": [
            {
              "Effect": "Allow",
              "Action": [
                "oss:GetObject"
              ],
              "Resource": [
                "acs:oss:*:*:${bucket}/${path}/*"
              ]
            }
          ]
        }

        • ${bucket}: the bucket that you create in OSS to store your images, for example, imagesearch-increment
        • ${path}: the path where your increment.meta file is stored, for example, /increment

      
3. Grant permissions.
   1. In the left-side navigation pane of the RAM console, click RAM Roles.
   2. Click the name of the RAM role that you create.
      
   3. On the Permissions tab, click Add Permissions.
      
   4. In the Add Permissions pane, click Custom Policy and select the policy that you create.
      
   5. Go back to the Permissions tab. You can view the custom policy that is attached to the RAM role.
      

Step 6: Upload images

1. Log on to the Image Search console.
2. Select the service type and click the name of your instance.
3. Click the Batch Operation tab.
   
4. Click Create Batch Task.
   
5. Specify the following parameters for the batch task:
   • ARN
     The following figure shows the location where you can view the value of the ARN parameter.
   • Bucket Name
     This parameter specifies the name of the bucket that you create in OSS.

     Note Make sure that your OSS instance and Image Search instance reside in the same region.
   • Path
     This parameter specifies the path where the images to be uploaded and the increment.meta file are stored.

     Note The path must start with a forward slash (/), for example, /imagesearch.