GET service replication

Description

Lists information about replication configuration for the specified bucket.

Requests

Syntax

GET /?replication HTTP/1.1
Host: <bucket>.<host>
Date: <date>
Authorization: <authorization_string>

Parameters

GET service replication parameters

Parameter	Description	Required
bucket	Bucket name. Type: string. Default value: none.	Yes

Headers

This implementation uses only common request headers.

Responses

Headers

Header	Description
x-amz-geo-endpoint	Endpoint of the remote region where to replicate objects to.
x-amz-geo-access-key	Access key of a user of the remote region used to replicate objects.
x-amz-geo-access-secret	Access secret of a user of the remote region used to replicate objects.

Body

An XML replication configuration in the following format:

<?xml version="1.0" encoding="UTF-8"?>
<ReplicationConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
   <Role>arn:aws:iam::<user_id>:role/s3-replication-role</Role>
   <Rule>
      <Status>Enabled|Disabled</Status>
      <Priority>1</Priority>
      <DeleteMarkerReplication>
         <Status>Enabled|Disabled</Status>
      </DeleteMarkerReplication>
      <Filter>
         <Prefix />
      </Filter>
      <Destination>
         <Bucket>arn:aws:s3:::<destination_bucket></Bucket>
      </Destination>
   </Rule>
</ReplicationConfiguration>

Examples

Sample request

Returns replication configuration of the bucket test.

GET /?replication HTTP/1.1
Host: test.s3.example.com
Date: Tu, 18 Jan 2021 14:08:55 GMT
Authorization: <authorization_string>

Sample response

HTTP/1.1 200 OK
Transfer-encoding : chunked
Server : nginx/1.8.1
Connection: closed
x-amz-request-id : 80000000000000030005c8caec96d65b
Date : Thu, 07 Apr 2016 14:08:56 GMT
Content-type : application/xml
<ReplicationConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
   <Role>arn:aws:iam::850b4943d62191a5:role/s3-replication-role</Role>
   <Rule>
      <Status>Enabled</Status>
      <Priority>1</Priority>
      <DeleteMarkerReplication>
         <Status>Disabled</Status>
      </DeleteMarkerReplication>
      <Filter>
         <Prefix />
      </Filter>
      <Destination>
         <Bucket>arn:aws:s3:::AWSDOC-EXAMPLE-BUCKET2</Bucket>
      </Destination>
   </Rule>
</ReplicationConfiguration>