All Documents
Current Document

Content is empty

If you don't find the content you expect, please try another search term

Documentation

Get Bucket Replication

Last updated:2021-09-14 16:18:08

Description

You can call this operation to query the replication rule of a source bucket and obtain the result in XML format.

Permission

To call this operation, you must have the GETBucketReplication permission on the bucket.

Request

Request syntax

GET /?crr HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}  

Request parameters

This operation does not involve request parameters.

Request headers

This operation involves only common request headers. For more information, see Public Request Header.

Request body

This operation does not involve a request body.

Response

Response headers

This operation involves only common response headers. For more information, see Public Response Header.

Response body

This operation returns a response in XML format, which may contain the following parameters.

Parameter Description Required
Replication The container of the replication rule. You can configure only one rule for a source bucket.
Type: Container
Child node: none
Parent node: none
Yes
prefix The prefix for matching objects. Only the objects matching the prefix are replicated. You can add up to 10 prefixes for a replication rule, and the prefixes must be unique.
Type: String
Parent node: Replication
No
DeleteMarkerStatus Specifies whether to enable deletion replication. If this parameter is set to Enabled, deletion replication is enabled. When an object is deleted from the source bucket, the object replica in the destination bucket is also deleted. If this parameter is set to Disabled or is unspecified, deletion replication is disabled.
Type: String
Parent node: Replication
No
targetBucket The destination bucket for replication.
Type: String
Parent node: Replication
Yes

Operation-specific errors

Error code Description HTTP status code
NoSuchBucketReplicationConfiguration No replication rule is configured for the bucket. 404 Not Found

Examples

Sample request

GET /?crr HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyuncs.com
Date: Wed, 14 May 2014 02:11:21 GMT
Content-MD5: xxx 
Authorization: authorization string
Content-Length: yyy
Content-type: application/xml

In this example, a replication rule is configured for a bucket, two prefixes abc and xyz are configured for the replication rule, deletion replication is enabled, and the destination bucket is targetbucket.

Sample response

HTTP/1.1 200 OK  
Content-Length: 0  
Date: Tue, 19 Jul 2017 09:14:23 GMT  
Server: Tengine  
x-kss-request-id: 6af24440694b4d00b8de063ccbe86336  
<Replication xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> 
    <prefix>abc</prefix>  
    <prefix>xyz</prefix>   
    <DeleteMarkerStatus>Enabled</DeleteMarkerStatus>   
    <targetBucket>bucketname</targetBucket>  
</Replication>
On this page
Pure ModeNormal Mode

Pure Mode

Click to preview the document content in full screen
Feedback