AWS::S3::Bucket ReplicationDestination - Amazon CloudFormation
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).

AWS::S3::Bucket ReplicationDestination

A container for information about the replication destination and its configurations including enabling the S3 Replication Time Control (S3 RTC).

Syntax

To declare this entity in your Amazon CloudFormation template, use the following syntax:

Properties

AccessControlTranslation

Specify this only in a cross-account scenario (where source and destination bucket owners are not the same), and you want to change replica ownership to the Amazon Web Services account that owns the destination bucket. If this is not specified in the replication configuration, the replicas are owned by same Amazon Web Services account that owns the source object.

Required: No

Type: AccessControlTranslation

Update requires: No interruption

Account

Destination bucket owner account ID. In a cross-account scenario, if you direct Amazon S3 to change replica ownership to the Amazon Web Services account that owns the destination bucket by specifying the AccessControlTranslation property, this is the account ID of the destination bucket owner. For more information, see Cross-Region Replication Additional Configuration: Change Replica Owner in the Amazon S3 User Guide.

If you specify the AccessControlTranslation property, the Account property is required.

Required: Conditional

Type: String

Update requires: No interruption

Bucket

The Amazon Resource Name (ARN) of the bucket where you want Amazon S3 to store the results.

Required: Yes

Type: String

Update requires: No interruption

EncryptionConfiguration

Specifies encryption-related information.

Required: No

Type: EncryptionConfiguration

Update requires: No interruption

Metrics

A container specifying replication metrics-related settings enabling replication metrics and events.

Required: No

Type: Metrics

Update requires: No interruption

ReplicationTime

A container specifying S3 Replication Time Control (S3 RTC), including whether S3 RTC is enabled and the time when all objects and operations on objects must be replicated. Must be specified together with a Metrics block.

Required: No

Type: ReplicationTime

Update requires: No interruption

StorageClass

The storage class to use when replicating objects, such as S3 Standard or reduced redundancy. By default, Amazon S3 uses the storage class of the source object to create the object replica.

For valid values, see the StorageClass element of the PUT Bucket replication action in the Amazon S3 API Reference.

Required: No

Type: String

Allowed values: DEEP_ARCHIVE | GLACIER | GLACIER_IR | INTELLIGENT_TIERING | ONEZONE_IA | REDUCED_REDUNDANCY | STANDARD | STANDARD_IA

Update requires: No interruption