GetBucketReplication
Updated at:2025-11-03
API description
This API retrieves data synchronization details for a specified bucket ID, including the source bucket name, destination bucket name, storage class, whether historical replication is activated, synchronization policy, destination region, and more.
Request
-
Request syntax
Plain Text1GET /?replication&id=sample-bucket HTTP/1.1 2Host: <BucketName>.bj.bcebos.com 3Date: <GMT Date> 4Authorization: AuthorizationString -
Request headers
No special parameters
-
Request parameters
No special parameters
Response
| Parameters | Description |
|---|---|
| id | Rule name of replication |
| status | Is it effective |
| resource | Effective prefix of replication |
| destination | Destination location configuration of replication |
| +bucket | Destination Bucket name |
| +storageClass | Storage class of destination object. If the storage class is to be consistent with that of the source Bucket, this parameter is left empty; STANDARD indicates the standard storage class, STANDARD_IA indicates the infrequent access storage class, COLD indicates the cold storage class; if it is a multi-AZ type bucket, the available values are MAZ_STANDARD_IA and MAZ_STANDARD. |
| replicateHistory | Historical file replication. Its existence indicates it is enabled. |
| +storageClass | The storage class of the destination object. It defaults to REMAIN and can be set to STANDARD, STANDARD_IA, COLD,MAZ_STANDARD_IA, MAZ_STANDARD. |
| replicateDeletes | It indicates whether Delete synchronization function is enabled. It is enabled{-2-} or {-3-}disabled. |
| create_time | Creation time of replication rule |
| destRegion | Destination region |
Example
-
Request example
Plain Text1GET /?replication&id=sample-bucket HTTP/1.1 2Host: BucketName.bj.bcebos.com 3Date: Thu, 15 May 2017 00:17:23 GMT 4Authorization: AuthorizationString -
Response example
Plain Text1HTTP/1.1 200 OK 2Date: Thu, 15 May 2017 00:17:23 GMT 3Server: BceBos 4x-bce-request-id: xxxx-xxxxx-xxxx 5Connection: keep-alive 6Content-Length: xxx 7{ 8 "status": "enabled", 9 "resource": [ 10 "src-bucket-name/abc", 11 "src-bucket-name/cd*" 12 ], 13 "destination": { 14 "bucket": "dst-bucket-name", 15 "storageClass": "COLD" 16 }, 17 "replicateHistory": { 18 "storageClass": "COLD" 19 }, 20 "replicateDeletes": "enabled", 21 "id": "sample-bucket", 22 "create_time": 1583060606, 23 "destRegion":"bj" 24}
