百度智能云

All Product Document

          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