

This is the new *CloudFormation Template Reference Guide*. Please update your bookmarks and links. For help getting started with CloudFormation, see the [AWS CloudFormation User Guide](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

# AWS::S3::Bucket ReplicationDestination
<a name="aws-properties-s3-bucket-replicationdestination"></a>

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

## Syntax
<a name="aws-properties-s3-bucket-replicationdestination-syntax"></a>

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

### JSON
<a name="aws-properties-s3-bucket-replicationdestination-syntax.json"></a>

```
{
  "[AccessControlTranslation](#cfn-s3-bucket-replicationdestination-accesscontroltranslation)" : AccessControlTranslation,
  "[Account](#cfn-s3-bucket-replicationdestination-account)" : String,
  "[Bucket](#cfn-s3-bucket-replicationdestination-bucket)" : String,
  "[EncryptionConfiguration](#cfn-s3-bucket-replicationdestination-encryptionconfiguration)" : EncryptionConfiguration,
  "[Metrics](#cfn-s3-bucket-replicationdestination-metrics)" : Metrics,
  "[ReplicationTime](#cfn-s3-bucket-replicationdestination-replicationtime)" : ReplicationTime,
  "[StorageClass](#cfn-s3-bucket-replicationdestination-storageclass)" : String
}
```

### YAML
<a name="aws-properties-s3-bucket-replicationdestination-syntax.yaml"></a>

```
  [AccessControlTranslation](#cfn-s3-bucket-replicationdestination-accesscontroltranslation): 
    AccessControlTranslation
  [Account](#cfn-s3-bucket-replicationdestination-account): String
  [Bucket](#cfn-s3-bucket-replicationdestination-bucket): String
  [EncryptionConfiguration](#cfn-s3-bucket-replicationdestination-encryptionconfiguration): 
    EncryptionConfiguration
  [Metrics](#cfn-s3-bucket-replicationdestination-metrics): 
    Metrics
  [ReplicationTime](#cfn-s3-bucket-replicationdestination-replicationtime): 
    ReplicationTime
  [StorageClass](#cfn-s3-bucket-replicationdestination-storageclass): String
```

## Properties
<a name="aws-properties-s3-bucket-replicationdestination-properties"></a>

`AccessControlTranslation`  <a name="cfn-s3-bucket-replicationdestination-accesscontroltranslation"></a>
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](aws-properties-s3-bucket-accesscontroltranslation.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Account`  <a name="cfn-s3-bucket-replicationdestination-account"></a>
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](https://docs.aws.amazon.com/AmazonS3/latest/dev/crr-change-owner.html) 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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Bucket`  <a name="cfn-s3-bucket-replicationdestination-bucket"></a>
 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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`EncryptionConfiguration`  <a name="cfn-s3-bucket-replicationdestination-encryptionconfiguration"></a>
Specifies encryption-related information.  
*Required*: No  
*Type*: [EncryptionConfiguration](aws-properties-s3-bucket-encryptionconfiguration.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Metrics`  <a name="cfn-s3-bucket-replicationdestination-metrics"></a>
 A container specifying replication metrics-related settings enabling replication metrics and events.   
*Required*: No  
*Type*: [Metrics](aws-properties-s3-bucket-metrics.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`ReplicationTime`  <a name="cfn-s3-bucket-replicationdestination-replicationtime"></a>
 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](aws-properties-s3-bucket-replicationtime.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`StorageClass`  <a name="cfn-s3-bucket-replicationdestination-storageclass"></a>
 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](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTreplication.html) action in the *Amazon S3 API Reference*.  
`FSX_OPENZFS` is not an accepted value when replicating objects.  
*Required*: No  
*Type*: String  
*Allowed values*: `DEEP_ARCHIVE | GLACIER | GLACIER_IR | INTELLIGENT_TIERING | ONEZONE_IA | REDUCED_REDUNDANCY | STANDARD | STANDARD_IA`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)