Replication

Replication Configuration of a Bucket

GetBucketReplication

get

Returns the replication configuration of a bucket.

The replication configuration may take a while to propagate to all IONOS Object Storage systems. For example, when you apply a new configuration with a PUT request or delete a configuration using a DELETE request. Similarly, a GET request may retrieve the previous state of the configuration, or it may still exist if you use a DELETE request.

Permissions

You must be the contract owner or an administrator to perform this operation. If not, they can grant you permission to perform the s3:GetBucketReplication operation using Bucket Policy.

S3 API Compatibility

• The x-amz-expected-bucket-owner header isn't supported.

Authorizations

Path parameters

Bucketstring · min: 3 · max: 63Required

The bucket name.

Example: my-bucket

Query parameters

replicationboolean · enumRequiredPossible values:

Responses

200

Successful operation

application/xml

get

HTTPcURLJavaScriptPython

GET /{Bucket} HTTP/1.1
Host: s3.eu-central-3.ionoscloud.com
Authorization: YOUR_API_KEY
Accept: */*

200

Successful operation

<?xml version="1.0" encoding="UTF-8"?>
<ReplicationConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Role>this field is ignored</Role>
  <Rule>
    <ID>My rule for replication</ID>
    <Status>Enabled</Status>
    <Prefix></Prefix>
    <Destination>
      <Bucket>arn:aws:s3:::my-destination-bucket</Bucket>
    </Destination>
  </Rule>
</ReplicationConfiguration>