PUT service replication
Sets replication configuration for the specified bucket.
PUT /?replication HTTP/1.1
Host: <bucket>.<host>
Date: <date>
Authorization: <authorization_string>
Parameter | Description |
|---|---|
bucket | Bucket name. Type: string. |
user_id | ID of the user that is used to replicate objects on your behalf. Type: string.
The ID can always be taken from the Access Key by dropping the last 4 digits. |
destination_bucket | The name of the bucket where you want to store the results. Type: string. |
<authorization_string> | <authorization_string>: To get the authorization string in the request, you will need to use the AWS Signature Version 4 signing process. This process involves creating a signature using your AWS access key and secret key, along with information from the request, such as the date, the host, and the specific API endpoint you are trying to access. You can find more information on how to create this signature and add it to your request in the AWS documentation: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
https://datafetcher.com/aws-signature-version-4-calculator |
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>
Header | Description |
|---|---|
x-amz-geo-endpoint | Endpoint of the remote region where to replicate objects to.
ZRH1: os.zrh1.flow.swiss
ALP1: os.alp1.flow.swiss |
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. |
This implementation uses only common response headers.
Empty.
Sets replication configuration for the bucket.
test.PUT/?replication HTTP/1.1
Host: test.os.zrh1.flow.swiss
Date: Tu, 13 Jan 2023 14:08:55 GMT
Authorization: <authorization_string>
x-amz-geo-endpoint: os.alp1.flow.swiss
x-amz-geo-access-key: <access_key>
x-amz-geo-access-secret: <access-secret>
<ReplicationConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Role>arn:aws:iam::<user_id>: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:::os.alp1.flow.swiss</Bucket>
</Destination>
</Rule>
</ReplicationConfiguration>
Sample response
HTTP/1.1 200 OK
Transfer-encoding : chunked
Server : nginx/1.8.1
Connection: closed
x-amz-request-id : 80000000000000030005c8caec96d65b
Date : Tu, 21 Jan 2021 14:08:56 GMT
Last modified 7mo ago