Enumerate All Replication Synchronization Rules of Bucket
Enumerate All Replication Synchronization Rules of Bucket
Last Updated:2021-09-13
Interface Description
This interface is used to get all replication synchronization rules of the bucket.
Request URI
GET /v1/{bucketName}/?replication&list
Parameter Name
Parameter Type
Required
Description
Example Value
Parameter Position
bucketName
String
Yes
Bucket name
"bucketName_example"
Path
Request Body Parameters
Instructions for Data Structure of Request Body Field
Response Body Parameters
Instructions for Data Structure of Response Body Field
Parameter name
Parameter type
Description
Example value
rules
List
Replication rule list
Introductions for Data Structure of Rules Field
Parameter Name
Parameter Type
Description
Example Value
status
String
Effective?
enabled
resource
List
Replication effective prefix
destination
Destination
Replicated destination configuration
replicateHistory
ReplicateHistory
Historical file replication. If there is such item, it is considered as “Enabled”
replicateDeletes
String
Whether or not to enable the synchronous deletion. It can be “Enabled” or “Disabled”
enabled
id
String
Replication rule name
sample-bucket-replication-config
create_time
Integer
Replication rule creation time
1583060606
destRegion
String
Destination region
bj
Introductions for Data Structure of Destination Field
Parameter Name
Parameter Type
Description
Example Value
bucket
String
Destination bucket name
dst-bucket-name
storageClass
String
Storage type of the destination object. If the storage class 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, MAZ_STANDARD_IA represents the multi-AZ infrequent access, MAZ_STANDARD represents the multi-AZ standard storage, and it cannot be other values.
COLD
Introductions for Data Structure of ReplicateHistory Field
Parameter Name
Parameter type
Description
Example value
storageClass
String
Storage class of the destination object, which is REMAIN by default and can be STANDARD, STANDARD_IA, COLD, MAZ_STANDARD, and MAZ_STANDARD_IA.
COLD
Request Example
GET /v1/bucketName_example/?replication&list
Common Request Header
{}
Response Example
HTTP/1.1200 OK
<Common response header>
{"rules":[{"destRegion":"bj","create_time":1583060606,"resource":["src-bucket-name/abc","src-bucket-name/abc"],"destination":{"bucket":"dst-bucket-name","storageClass":"COLD"},"id":"sample-bucket-replication-config","replicateHistory":{"storageClass":"COLD"},"replicateDeletes":"enabled","status":"enabled"},{"destRegion":"bj","create_time":1583060606,"resource":["src-bucket-name/abc","src-bucket-name/abc"],"destination":{"bucket":"dst-bucket-name","storageClass":"COLD"},"id":"sample-bucket-replication-config","replicateHistory":{"storageClass":"COLD"},"replicateDeletes":"enabled","status":"enabled"}]}