Menu
Amazon Simple Storage Service
Console User Guide

How Do I Enable and Configure Cross-Region Replication for an S3 Bucket?

If you are in the old Amazon S3 console, to use the new console, choose Opt In in the following box, which appears on the old Amazon S3 console home page. Note that Opt In is not available in all Regions.  


                            Opt-in to new Amazon S3 console UI

Cross-region replication is the automatic, asynchronous copying of objects across buckets in different AWS Regions. When you enable cross-region replication, Amazon S3 replicates newly created objects, object updates, and object deletions from a source bucket to a destination bucket in a different region. Cross-region replication has specific requirements that define what can and cannot be replicated across regions based on how the object is created and how it is encrypted. For more information, see Cross-Region Replication in the Amazon Simple Storage Service Developer Guide.

Cross-region replication requires that versioning must be enabled on both your source bucket and your destination bucket that is in a different region. For more information, see How Do I Enable or Suspend Versioning for an S3 Bucket?.

To enable cross-region replication of an S3 bucket to another bucket

  1. Sign in to the AWS Management Console and open the Amazon S3 console at https://console.aws.amazon.com/s3/.

  2. In the Bucket name list, choose the name of the bucket that you want to enable cross-region replication for.

  3. Choose Properties.

  4. Under Advanced settings, choose Cross-region replication.

  5. Choose Enable cross-region replication, and then configure your settings as follows:

    1. For Destination, choose the region of the destination bucket and then choose the destination bucket. If you do not see your desired destination bucket in the list, confirm that the bucket exists in the region you selected and that you have enabled versioning on that bucket.

    2. For Source, choose Whole bucket to replicate the whole bucket or choose Prefix in this bucket to replicate all objects with the same prefix (for example, all objects in a specific folder).

      1. If you choose Prefix in this bucket, choose the arrow next to Current prefixes, choose +Add, type a prefix to use, and then choose a destination storage class. You can add more than one prefix.

    3. For Destination storage class, choose the storage class you want to use for the replicated objects.

    4. To perform cross-region replication of objects on your behalf, you need to set up an AWS Identity and Access Management (IAM) role that Amazon S3 can use. For Select role, do one of the following:

      • If you want Amazon S3 to create a new IAM role for you, choose Create new role and then choose Save. Amazon S3 will generate a policy for the IAM role that matches the source and destination buckets you choose. The generated role is named based on the bucket names using the following naming convention: replication_role_for_source-bucket_to_destination-bucket

      • If you want to use an existing IAM role, choose an IAM role that allows Amazon S3 to replicate objects from the source bucket to the destination bucket on your behalf and then choose Save.

You have now enabled cross-region replication of one bucket to another. The time it takes for Amazon S3 to replicate an object depends on the object size. It can take up to several hours to replicate a large-sized object.

Note

Metadata for an object remains identical between original objects and replica objects. Lifecycle rules abide by the creation time of the original object, and not by when the replicated object becomes available in the destination bucket. However, lifecycle actions on objects pending replication do not resolve until the replication has completed.