Update a Replication Workflow¶

Using the UI

From the main menu, choose Data Management. Click Data Browser from the side menu and select an account from the top drop-down list in the breadcrumb.
Select the bucket you want to view by clicking anywhere on the row but the bucket name.
In the Replication tab, click the Edit button on the row of the rule you want to update.

The Edit Replication Rule page opens.
Edit the fields as needed:
- Modify the Status to toggle between Enabled and Disabled.
- Add or edit a Prefix filter (for example accounting/, evidence/) to create selective replication.
- Add or modify Tags filters.
Click Save to commit changes.

Note

The UI performs the equivalent of the PUT Bucket Replication API operation.

Using the AWS CLI

Configure the JSON object with the following syntax.
```
{
   "Role": "arn:aws:iam::root:role/s3-replication-role",
   "Rules": [
      {
         "Status": "Enabled",
         "Prefix": "",
         "Destination": {
            "Bucket": "arn:aws:s3:::destination-bucket",
            "StorageClass": "target-storage-location"
         }
      }
   ]
}
```
- In the Role field, specify the IAM source role.
- In the Prefix field, specify a prefix filter to apply the replication rule only to objects belonging to a certain prefix.
- In the Destination field, specify the destination bucket and a unique, or a comma-separated list of destination Data Storage locations.

Use the following PUT Bucket Replication S3 command.

aws --endpoint-url http://endpoint s3api put-bucket-replication --bucket source-bucket --replication-configuration file://replication.json

For API operation, refer to PUT Bucket Replication.

Note

Updating a replication workflow only affects new objects and new versions of existing objects. The replication status of existing objects reflects the state under the previous workflow configuration. Objects with a COMPLETED status will not be re-replicated under the new rules unless you manually trigger replication.