# Replication

This document provides instructions to manage [<mark style="color:blue;">Replication</mark>](https://docs.ionos.com/sections-test/guides/storage-and-backup/ionos-object-storage/settings/replication) using the CLI. Additionally, these tasks can also be performed using the [<mark style="color:blue;">DCD</mark>](https://docs.ionos.com/sections-test/guides/storage-and-backup/settings/replication#dcd) and [<mark style="color:blue;">API</mark>](https://api.ionos.com/docs/s3/v2/#tag/Replication).

{% hint style="info" %}
**Prerequisites:**

* Set up the AWS CLI by following the [<mark style="color:blue;">installation instructions</mark>](https://docs.ionos.com/sections-test/guides/storage-and-backup/ionos-object-storage/s3-tools/awscli/awscli-configure).
* Make sure to consider the supported [<mark style="color:blue;">Endpoints</mark>](https://docs.ionos.com/sections-test/guides/storage-and-backup/ionos-object-storage/endpoints).
* [<mark style="color:blue;">Versioning</mark>](https://docs.ionos.com/sections-test/guides/storage-and-backup/ionos-object-storage/settings/versioning) must be enabled for source and destination buckets.
  {% endhint %}

## Commands

Create the file `replication_configuration.json` with the following content:

```
    "Role": "this field is ignored",
    "Rules": [
        {
            "Status": "Enabled",
            "Prefix": "",
            "Destination": {
                "Bucket": "arn:aws:s3:::my-destination-bucket"
            }
        }
    ]

```

Enable replication from `my-source-bucket` to `my-destination-bucket` (use the endpoint of the source bucket):

```
aws s3api put-bucket-replication --bucket my-source-bucket --replication-configuration file://replication_configuration.json --endpoint-url https://s3.eu-central-2.ionoscloud.com

```

Retrieve the replication configuration:

```
aws s3api get-bucket-replication --bucket my-source-bucket  --endpoint-url https://s3.eu-central-2.ionoscloud.com
```

Delete the replication configuration:

```
aws s3api delete-bucket-replication --bucket my-source-bucket  --endpoint-url https://s3.eu-central-2.ionoscloud.com
```

{% hint style="info" %}
**Info:** It takes up to a few minutes for the deletion of a replication rule to propagate fully.
{% endhint %}