Batch Operation

Last updated: 2020-12-28 15:04:57


    The COS batch operation feature allows you to perform large-scale batch operations on objects in a bucket. Currently, you can perform the following batch operations:

    • Replicating objects
    • Restoring archived objects

    You can generate an inventory file for the objects on which to perform a batch operation using either COS inventory (you need to first enable inventory feature), or the CSV format you specify. COS will then perform this batch operation based on the inventory file. For more information on batch operations, please see Overview.


    1. Log in to the COS console and click Batch Operation on the left sidebar to enter the batch operation management page.
    2. Click Create Job to create a batch operation job and configure the following:
      • Job Region: select a region for the job. It must be the same as the bucket region where the objects in your inventory file reside; otherwise the job will fail.


        Currently, COS batch operation is only available in public cloud regions in Chinese mainland.

      • Inventory Format: select a format for the objects to be inventoried from the following two options:
        Inventory Format Field Description
        COS inventory report - Please select this format if you want to generate the inventory file by using COS inventory.
        CSV Bucket Bucket name
        Key Name of an object in a bucket. If you use this format, the object name is URL-encoded and must be decoded before use.
        VersionId Object version ID. If versioning is enabled for a bucket, COS will assign a version ID to each object added to the bucket. If you do not want to inventory the latest version of an object, you can specify a particular version ID.
      • Inventory Bucket: select the bucket where the inventory file is stored.
      • Inventory File Path: specify the path of COS inventory report or CSV file in the format of directory/manifest.json or directory/manifest.csv, respectively. For example, if you have an inventory stored in the examplebucket-1250000000 root directory, the inventory path will be manifest.json.
    3. Click Next to enter the operation configuration page, select the task type, and configure the configuration items as follows:
      • Batch Data Copy:
        • Destination Bucket: select the bucket to store the object copies.
        • Prefix Operation: you can choose to add, replace, or delete the prefix on the object copies.
        • Storage Class: specify the storage class for object copies. Valid values: STANDARD, STANDARD_IA, ARCHIVE.
        • Server-Side Encryption: specify whether to encrypt the object copies. Valid values: None, SSE-COS.
        • Access Permission: set access permissions to the object copies. Valid values: Copy all permissions, Replace all permissions, Add new permissions.
        • Object Metadata: configure metadata for the object copies. Valid values: Copy all metadata, Replace all metadata, Add new metadata.
        • Object Tag: configure tags for the object copies. Valid values: Copy all tags, Replace all tags, Add new tags.
      • Restored archived objects in batches:
        • Restoration Mode: you can select either standard or bulk mode. For more information on restoration modes, please see Restoring an Archived Object.
        • Validity: specify the number of days after which the object copies will expire and be automatically deleted. This value ranges from 1 to 365.
    4. Click Next to enter the "Other Configuration" page where you should configure the following:
      • Job Description (Optional): description of the job. This field is optional.
      • Job Priority: a job of a higher priority will be performed first. The value must be a positive integer. A larger value indicates a higher priority.
      • Job Report: select whether to generate a job report.
      • CAM Role: you can create a CAM role or select an existing role to grant operation permissions to COS.


        For COS to perform batch operations, you need to use a CAM role to grant permissions. For more information on CAM roles, please see Role Overview.

    5. Click Next to check all the information you have configured. If you need to make a change, click Modify or Previous accordingly. After confirming that everything is correct, click Created.
    6. Once completed, find the new job in the job list, and click Pending > Confirm under Status. To cancel the job, click Cancel Job under Operation.