Setting up replication - Amazon Simple Storage Service
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Setting up replication

Note

Objects that existed in your bucket before you set up a replication rule aren't replicated automatically. In other words, Amazon S3 on Outposts doesn't replicate objects retroactively. To replicate objects that were created before your replication configuration, you can use the CopyObject API operation to copy them to the same bucket. After the objects are copied, they appear as "new" objects in the bucket and the replication configuration will apply to them. For more information about copying an object, see Copying an object in an Amazon S3 on Outposts bucket using the Amazon SDK for Java and CopyObject in the Amazon Simple Storage Service API Reference.

To enable S3 Replication on Outposts, add a replication rule to your source Outposts bucket. The replication rule tells S3 on Outposts to replicate objects as specified. In the replication rule, you must provide the following:

  • The source Outposts bucket access point – The access point Amazon Resource Name (ARN) or access point alias of the bucket from which you want S3 on Outposts to replicate the objects. For more information about using access point aliases, see Using a bucket-style alias for your S3 on Outposts bucket access point.

  • The objects that you want to replicate – You can replicate all of the objects in the source Outposts 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/, S3 on Outposts replicates objects with keys such as Tax/doc1 or Tax/doc2. But it doesn't replicate objects with the key Legal/doc3. If you specify both a prefix and one or more tags, S3 on Outposts replicates only objects that have the specific key prefix and tags.

  • The destination Outposts bucket – The ARN or access point alias of the bucket to which you want S3 on Outposts to replicate the objects.

You can configure the replication rule by using the REST API, Amazon SDKs, Amazon Command Line Interface (Amazon CLI), or Amazon S3 console.

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

Topics