Links

GET service replication

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

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: os.zrh1.flow.swiss
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>