Menu
Amazon Simple Storage Service
Developer Guide (API Version 2006-03-01)

Walkthrough 1: Configure Cross-Region Replication Where Source and Destination Buckets Are Owned by the Same AWS Account

In this section, you create two buckets (source and destination) in different AWS Regions, enable versioning on both the buckets, and then configure cross-region replication on the source bucket.

  1. Create two buckets.

    1. Create a source bucket in an AWS Region. For example, US West (Oregon) (us-west-2). For instructions, see How Do I Create an S3 Bucket? in the Amazon Simple Storage Service Console User Guide.

    2. Create a destination bucket in another AWS Region. For example, US East (N. Virginia) (us-east-1).

  2. Enable versioning on both buckets. For instructions, see How Do I Enable or Suspend Versioning for an S3 Bucket? in the Amazon Simple Storage Service Console User Guide.

    Important

    If you have an object expiration lifecycle policy in your non-versioned bucket and you want to maintain the same permanent delete behavior when you enable versioning, you must add a noncurrent expiration policy. The noncurrent expiration lifecycle policy will manage the deletes of the noncurrent object versions in the version-enabled bucket. (A version-enabled bucket maintains one current and zero or more noncurrent object versions.) For more information, see How Do I Create a Lifecycle Policy for an S3 Bucket? in the Amazon Simple Storage Service Console User Guide.

  3. Enable cross-region replication on the source bucket. You decide if you want to replicate all objects or only objects with a specific prefix (when using the console, think of this as deciding if you want to replicate only objects from a specific folder). For instructions, see How Do I Enable and Configure Cross-Region Replication for an S3 Bucket? in the Amazon Simple Storage Service Console User Guide.

  4. Test the setup as follows:

    1. Create objects in the source bucket and verify that Amazon S3 replicated the objects in the destination bucket. The amount of time it takes for Amazon S3 to replicate an object depends on the object size. For information about finding replication status, see Finding the Cross-Region Replication Status .

    2. Update the object's access control list (ACL) in the source bucket, and verify that changes appear in the destination bucket. For instructions, see Setting Bucket and Object Access Permissions in the Amazon Simple Storage Service Console User Guide.

    3. Update the object's metadata and verify that the changes appear in the destination bucket. For instructions, see How Do I Add Metadata to an S3 Object? in the Amazon Simple Storage Service Console User Guide.

    Remember that the replicas are exact copies of the objects in the source bucket.

Cross-Region Replication (CRR)

Walkthrough 2: Configure Cross-Region Replication Where Source and Destination Buckets Are Owned by Different AWS Accounts

What Is and Is Not Replicated

Finding the Cross-Region Replication Status

On this page: