ListBucketReplication
Updated at:2025-11-03
API description
This API is designed to retrieve all replication synchronization rules of a bucket.
Request
-
Request syntax
Plain Text1GET /?replication&list 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 |
|---|---|
| rules | replication rule list |
| +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, STANDARD_IA indicates the infrequent access storage, COLD indicates the cold storage; if it is a multi-AZ type bucket, MAZ_STANDARD_IA indicates multi-AZ infrequent access storage, and MAZ_STANDARD indicates multi-AZ standard storage, rather than other options. |
| +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, MAZ_STANDARD_IA. |
| +replicateDeletes | It indicates whether Delete synchronization function is enabled. It is enabled or disabled. |
| +create_time | Creation time of replication rule |
| +destRegion | Destination region |
Example
-
Request example
Plain Text1GET /?replication&list 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 "rules": [ 9 { 10 "status": "enabled", 11 "resource": [ 12 "src-bucket-name/abc", 13 "src-bucket-name/cd*" 14 ], 15 "destination": { 16 "bucket": "dst-bucket-name", 17 "storageClass": "COLD" 18 }, 19 "replicateHistory": { 20 "storageClass": "COLD" 21 }, 22 "replicateDeletes": "enabled", 23 "id": "sample-bucket-replication-config", 24 "create_time: 1583060606, 25 "destRegion":"bj" 26 } 27 ] 28}
