> For the complete documentation index, see [llms.txt](https://docs.ionos.com/cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ionos.com/cloud/api-reference/storage-and-backup/ionos-object-storage/ionos-object-storage-for-user-owned-buckets/replication.md).
# Replication
Replication Configuration of a Bucket
## GetBucketReplication
> Returns the replication configuration of a bucket.\
> \
> The replication configuration may take a while to propagate to all IONOS CLOUD 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]\(#tag/Policy/operation/PutBucketPolicy).\
> \
> \#### S3 API Compatibility\
> \- The \`x-amz-expected-bucket-owner\` header isn't supported.
```json
{"openapi":"3.0.3","info":{"title":"IONOS CLOUD Object Storage API for user-owned buckets","version":"2.0.16"},"tags":[{"name":"Replication","description":"Replication Configuration of a Bucket"}],"servers":[{"url":"https://s3.eu-central-1.ionoscloud.com","description":"URL for `de` (Frankfurt, Germany)"},{"url":"https://s3.de-central.profitbricks.com","description":"Legacy URL for `de` (Frankfurt, Germany)"},{"url":"https://s3.eu-central-2.ionoscloud.com","description":"URL for `eu-central-2` (Berlin, Germany)"},{"url":"https://s3.eu-south-2.ionoscloud.com","description":"URL for `eu-south-2` (Logroño, Spain)"}],"security":[{"hmac":[]}],"components":{"securitySchemes":{"hmac":{"type":"apiKey","name":"Authorization","in":"header","description":"IONOS CLOUD Object Storage API requests are authenticated using the AWS signature. \nThe IONOS CLOUD Object Storage API authenticates users using a customized HTTP scheme based on a [keyed-HMAC](https://en.wikipedia.org/wiki/HMAC) (Hash Message Authentication Code).\nThe process of generating the proper Authorization header is somewhat involved. We recommend that you make use of a tool such as Postman.\n\nIn the **Authorization** tab for a request, select **AWS Signature** from the **Type** dropdown list.\nSpecify where Postman should append your authorization data using the **Add authorization data to** drop-down menu.\n\n* If you select **Request Headers**, Postman populates the **Headers** tab with Authorization and `X-Amz-` prefixed fields.\n\n* If you select **Request URL**, Postman populates the **Params** tab with authentication details prefixed with `X-Amz-`.\n\n\n**Note:** The parameters listed below contain confidential information. We recommend using variables to keep this data secure while working in a collaborative environment.\n\n* For **Access Key**, enter your `access key` directly in the fields or through variables for added security.\n\n* For **Secret Key**, enter your `secret key` directly in the fields or through variables for added security.\n\nAdvanced fields are optional, but Postman will attempt to generate them automatically if necessary.\n* For **AWS Region**, enter one of the [regions](#section/Endpoints) (`eu-central-3`) where your bucket is hosted.\n\n* For **Service Name**, enter `s3`. The name of the service that receives the requests.\n\n* For **Session Token**, **leave the field blank**. This is only required when temporary security credentials are used.\n"}},"schemas":{"GetBucketReplicationOutput":{"type":"object","properties":{"ReplicationConfiguration":{"$ref":"#/components/schemas/ReplicationConfiguration"}}},"ReplicationConfiguration":{"type":"object","required":["Role","Rules"],"properties":{"Role":{"description":"The Resource Name of the Identity and Access Management (IAM) role that IONOS CLOUD Object Storage assumes when replicating objects.","type":"string"},"Rules":{"allOf":[{"$ref":"#/components/schemas/ReplicationRules"},{"xml":{"name":"Rule"},"description":"A container for one or more replication rules. A replication configuration must have at least one rule and can contain a maximum of 1,000 rules. "}]}},"description":"A container for replication rules. You can add up to 1,000 rules. The maximum size of a replication configuration is 2 MB."},"ReplicationRules":{"type":"array","items":{"$ref":"#/components/schemas/ReplicationRule"},"xml":{"wrapped":false}},"ReplicationRule":{"description":"Specifies which IONOS CLOUD Object Storage objects to replicate and where to store the replicas.","type":"object","required":["Status","Destination"],"properties":{"ID":{"$ref":"#/components/schemas/ID"},"Prefix":{"description":"An object key name prefix that identifies the subset of objects to which the rule applies.\nReplace the Object keys containing special characters, such as carriage returns, when using XML requests.\n","type":"string"},"Status":{"description":"Specifies whether the rule is enabled.","type":"string","enum":["Enabled","Disabled"]},"Destination":{"$ref":"#/components/schemas/Destination"}}},"ID":{"type":"integer","description":"Container for the Contract Number of the owner.","xml":{"name":"ID"}},"Destination":{"description":"A container for information about the replication destination.\n","type":"object","required":["Bucket"],"properties":{"Bucket":{"description":"Use the same \"Bucket\" value formatting as in the API specification, that is, `arn:aws:s3:::{Bucket}`.\n","type":"string","minLength":3,"maxLength":63},"StorageClass":{"$ref":"#/components/schemas/StorageClass"}}},"StorageClass":{"description":"Currently, only one storage class is available – `STANDARD`. \n","type":"string","enum":["STANDARD"]},"BucketName":{"description":"The bucket name.","type":"string","minLength":3,"maxLength":63,"xml":{"name":"Name"}}}},"paths":{"/{Bucket}?replication":{"get":{"tags":["Replication"],"summary":"GetBucketReplication","operationId":"GetBucketReplication","description":"Returns the replication configuration of a bucket.\n\nThe replication configuration may take a while to propagate to all IONOS CLOUD Object Storage systems.\nFor example, when you apply a new configuration with a PUT request or delete a configuration using\na DELETE request. Similarly, a GET request may retrieve the previous state of the configuration,\nor it may still exist if you use a DELETE request.\n\n#### Permissions\nYou must be the contract owner or an administrator to perform this operation. If not, they can grant you permission\nto perform the `s3:GetBucketReplication` operation using [Bucket Policy](#tag/Policy/operation/PutBucketPolicy).\n\n#### S3 API Compatibility\n- The `x-amz-expected-bucket-owner` header isn't supported.\n","responses":{"200":{"description":"Successful operation","headers":{},"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/GetBucketReplicationOutput"}}}}},"parameters":[{"name":"Bucket","in":"path","required":true,"schema":{"$ref":"#/components/schemas/BucketName"}},{"name":"replication","in":"query","required":true,"schema":{"type":"boolean","enum":[true]},"allowEmptyValue":true}]}}}}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.ionos.com/cloud/api-reference/storage-and-backup/ionos-object-storage/ionos-object-storage-for-user-owned-buckets/replication.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.