Setting up S3 bucket Replication
- Sign in to the AWS Management Console and open the Amazon S3 console at https://console.aws.amazon.com/s3/
- In the Bucket name list, choose the name of the bucket that you want to enable versioning for
![]()
- Choose Management, choose Replication, and then choose Add rule.
![]()
- In the Replication rule wizard, under Set source, you have the following options for setting the replication source:
- To replicate the whole bucket, choose Entire bucket
bucket-name. - To replicate all objects that have the same prefix (for example, all objects that have names that begin with the string
pictures), choose Prefix or tags. Enter a prefix in the box, choose the prefix from the drop-down list, and then press Enter. If you enter a prefix that is the name of a folder, you must use / (forward slash) as the last character (for example,pictures/). - To replicate all objects with one or more object tags, enter a tag in the box, choose the tag from the drop-down list, and then press Enter. Enter a tag value and then press Enter. Repeat the procedure to add another tag. You can combine a prefix and tags.
![]()
- To replicate the whole bucket, choose Entire bucket
- To choose a destination bucket from the account that you’re currently using, on the Set destination page, under Destination bucket, choose Buckets in this account. Enter the name of the destination bucket for the replication, or choose a name in the drop-down list.
![]()
If versioning is not enabled on the destination bucket, you get a warning message that contains an Enable versioning button. Choose this button to enable versioning on the bucket. - Choose Next.
- Set up an AWS Identity and Access Management (IAM) role that Amazon S3 can assume to replicate objects on your behalf.
To set up an IAM role, on the Configure options page, under Select role, do one of the following:
- We highly recommend that you choose Create new role to have Amazon S3 create a new IAM role for you. When you save the rule, a new policy is generated for the IAM role that matches the source and destination buckets that you choose. The name of the generated role is based on the bucket names and uses the following naming convention: replication_role_for_
source-bucket_to_destination-bucket. - You can choose to use an existing IAM role. If you do, you must choose a role that grants Amazon S3 the necessary permissions for replication. Replication fails if this role does not grant Amazon S3 sufficient permissions to follow your replication rule.
![]()
Under Rule name, enter a name for your rule to help identify the rule later. The name is required and must be unique within the bucket.
- We highly recommend that you choose Create new role to have Amazon S3 create a new IAM role for you. When you save the rule, a new policy is generated for the IAM role that matches the source and destination buckets that you choose. The name of the generated role is based on the bucket names and uses the following naming convention: replication_role_for_
- If the bucket has existing replication rules, you are instructed to set a priority for the rule. You must set a priority for the rule to avoid conflicts caused by objects that are included in the scope of more than one rule. In the case of overlapping rules, Amazon S3 uses the rule priority to determine which rule to apply. The higher the number, the higher the priority.
- On the Review page, review your replication rule. If it looks correct, choose Save. Otherwise, choose Previous to edit the rule before saving it.
- After you save your rule, you can edit, enable, disable, or delete your rule on the Replication page.
![]()
