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 AWS CloudFormation template, use the following syntax:
JSON
{ "AccessControlTranslation" :
AccessControlTranslation
, "Account" :String
, "Bucket" :String
, "EncryptionConfiguration" :EncryptionConfiguration
, "Metrics" :Metrics
, "ReplicationTime" :ReplicationTime
, "StorageClass" :String
}
YAML
AccessControlTranslation:
AccessControlTranslation
Account:String
Bucket:String
EncryptionConfiguration:EncryptionConfiguration
Metrics:Metrics
ReplicationTime:ReplicationTime
StorageClass:String
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 AWS account that owns the destination bucket. If this is not specified in the replication configuration, the replicas are owned by same AWS 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 AWS 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, theAccount
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