# GET service replication

Lists information about replication configuration for the specified bucket.

### Requests <a href="#kanchor121" id="kanchor121"></a>

#### Syntax <a href="#kanchor122" id="kanchor122"></a>

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

#### Parameters <a href="#kanchor123" id="kanchor123"></a>

| Parameter | Description                                                        | Required |
| --------- | ------------------------------------------------------------------ | -------- |
| `bucket`  | <p>Bucket name.</p><p>Type: string.</p><p>Default value: none.</p> | Yes      |

#### Headers <a href="#kanchor124" id="kanchor124"></a>

This implementation uses only common request headers.

### Responses <a href="#kanchor125" id="kanchor125"></a>

#### Headers <a href="#kanchor126" id="kanchor126"></a>

| 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 <a href="#kanchor127" id="kanchor127"></a>

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 <a href="#kanchor128" id="kanchor128"></a>

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>
```