GetBucketReplication
Last Updated:2021-12-08
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, andCOLD
represents the cold storage. If it is a multi-AZ bucket, the values can beMAZ_STANDARD_IA
andMAZ_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 beSTANDARD
,STANDARD_IA
,COLD
,MAZ_STANDARD_IA
orMAZ_STANDARD
.replicateDeletes Is the synchronous deletion enabled? It can be enabled
ordisabled
.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" }