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 Creating a 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) region (us-east-1).

  2. Enable versioning on both buckets. For instructions, see Enabling Bucket Versioning 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 Lifecycle Configuration for a Bucket with Versioning 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 Enabling Cross-Region Replication 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 How to Find Replication Status of an Object.

    2. Update the object's ACL in the source bucket and verify that changes appear in the destination bucket. For instructions, see Editing Object 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 Editing Object Metadata 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

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

What Is and Is Not Replicated

How to Find Replication Status of an Object