Overview of setting up replication - Amazon Simple Storage Service

Overview of setting up replication

To enable replication, you simply add a replication configuration to your source bucket. The configuration tells Amazon S3 to replicate objects as specified. In the replication configuration, you must provide the following:

  • The destination bucket or buckets — The bucket or buckets where you want Amazon S3 to replicate the objects.

     

  • The objects that you want to replicate — You can replicate all of the objects in the source bucket or a subset. You identify a subset by providing a key name prefix, one or more object tags, or both in the configuration.

    • For example, if you configure a replication rule to replicate only objects with the key name prefix Tax/, Amazon S3 replicates objects with keys such as Tax/doc1 or Tax/doc2. But it doesn't replicate an object with the key Legal/doc3. If you specify both prefix and one or more tags, Amazon S3 replicates only objects having the specific key prefix and tags.

 

In addition to these minimum requirements, you can choose the following options:

  • By default, Amazon S3 stores object replicas using the same storage class as the source object. You can specify a different storage class for the replicas.

     

  • Amazon S3 assumes that an object replica continues to be owned by the owner of the source object. So when it replicates objects, it also replicates the corresponding object access control list (ACL). If the source and destination buckets are owned by different AWS accounts, you can configure replication to change the owner of a replica to the AWS account that owns the destination bucket.

Additional configuration options are available. For more information, see Additional replication configurations.

You can configure replication using the Amazon S3 console, see How do I add a replication rule to an S3 bucket? in the Amazon Simple Storage Service Console User Guide. This topic provides instructions for creating replication rules when buckets are owned by the same or different AWS accounts.

Amazon S3 also provides APIs to support setting up replication rules. For more information, see the following topics in the Amazon Simple Storage Service API Reference: