Baidu AI Cloud
中国站

百度智能云

Object Storage

GetBucketReplication

Interface Description

This interface is used to get the data synchronization information of the bucket specified ID, including source bucket name, destination bucket name, storage type, historical replication, data synchronization policy, and destination region.

Request

  • Request syntax

    GET /?replication&id=sample-bucket HTTP/1.1
    Host: <BucketName>.bj.bcebos.com
    Date: <GMT Date>
    Authorization: AuthorizationString
  • Request header field

    No special parameters.

  • Request parameters

    No special parameters.

Response

  • Response element

    Parameters Description
    id Replication rule name
    status Effective?
    resource Replication effective prefix
    destination Replicated destination configuration
    +bucket Destination bucket name
    +storageClass Storage type of target object. If the storage type is consistent with that of the source bucket, this parameter is empty. STANDARD represents the standard storage, STANDARD_IA represents the infrequent access, and COLD represents the cold storage. If it is a multi-AZ bucket, the values can be MAZ_STANDARD_IA and MAZ_STANDARD.
    replicateHistory Historical file replication. If such item exists, it is considered as “Enabled”
    +storageClass Storage type of the destination object, which is REMAIN by default and can be STANDARD, STANDARD_IA, COLD, MAZ_STANDARD_IA or MAZ_STANDARD.
    replicateDeletes Is the synchronous deletion enabled? It can be enabled or disabled.
    create_time Replication rule creation time
    destRegion Destination region
  • Response header field

    No special parameters.

Example

  • Request example

    GET /?replication&id=sample-bucket HTTP/1.1
    Host: BucketName.bj.bcebos.com
    Date: Thu, 15 May 2017 00:17:23 GMT
    Authorization: AuthorizationString
  • Response example

    HTTP/1.1 200 OK
    Date: Thu, 15 May 2017 00:17:23 GMT
    Server: BceBos
    x-bce-request-id: xxxx-xxxxx-xxxx
    Connection: keep-alive
    Content-Length: xxx
    
    {
       "status": "enabled",
       "resource": [
           "src-bucket-name/abc",
           "src-bucket-name/cd*"
       ],
       "destination": {
           "bucket": "dst-bucket-name",
           "storageClass": "COLD"
       },
       "replicateHistory": {
           "storageClass": "COLD"
       },
       "replicateDeletes": "enabled",
       "id": "sample-bucket",
       "create_time": 1583060606,
       "destRegion":"bj"
    }
Previous
DeleteBucketReplication
Next
GetBucketReplicationProgress