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::DynamoDB::GlobalTable ReplicaSpecification
<a name="aws-properties-dynamodb-globaltable-replicaspecification"></a>

Defines settings specific to a single replica of a global table.

## Syntax
<a name="aws-properties-dynamodb-globaltable-replicaspecification-syntax"></a>

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

### JSON
<a name="aws-properties-dynamodb-globaltable-replicaspecification-syntax.json"></a>

```
{
  "[ContributorInsightsSpecification](#cfn-dynamodb-globaltable-replicaspecification-contributorinsightsspecification)" : ContributorInsightsSpecification,
  "[DeletionProtectionEnabled](#cfn-dynamodb-globaltable-replicaspecification-deletionprotectionenabled)" : Boolean,
  "[GlobalSecondaryIndexes](#cfn-dynamodb-globaltable-replicaspecification-globalsecondaryindexes)" : [ ReplicaGlobalSecondaryIndexSpecification, ... ],
  "[GlobalTableSettingsReplicationMode](#cfn-dynamodb-globaltable-replicaspecification-globaltablesettingsreplicationmode)" : String,
  "[KinesisStreamSpecification](#cfn-dynamodb-globaltable-replicaspecification-kinesisstreamspecification)" : KinesisStreamSpecification,
  "[PointInTimeRecoverySpecification](#cfn-dynamodb-globaltable-replicaspecification-pointintimerecoveryspecification)" : PointInTimeRecoverySpecification,
  "[ReadOnDemandThroughputSettings](#cfn-dynamodb-globaltable-replicaspecification-readondemandthroughputsettings)" : ReadOnDemandThroughputSettings,
  "[ReadProvisionedThroughputSettings](#cfn-dynamodb-globaltable-replicaspecification-readprovisionedthroughputsettings)" : ReadProvisionedThroughputSettings,
  "[Region](#cfn-dynamodb-globaltable-replicaspecification-region)" : String,
  "[ReplicaStreamSpecification](#cfn-dynamodb-globaltable-replicaspecification-replicastreamspecification)" : ReplicaStreamSpecification,
  "[ResourcePolicy](#cfn-dynamodb-globaltable-replicaspecification-resourcepolicy)" : ResourcePolicy,
  "[SSESpecification](#cfn-dynamodb-globaltable-replicaspecification-ssespecification)" : ReplicaSSESpecification,
  "[TableClass](#cfn-dynamodb-globaltable-replicaspecification-tableclass)" : String,
  "[Tags](#cfn-dynamodb-globaltable-replicaspecification-tags)" : [ Tag, ... ]
}
```

### YAML
<a name="aws-properties-dynamodb-globaltable-replicaspecification-syntax.yaml"></a>

```
  [ContributorInsightsSpecification](#cfn-dynamodb-globaltable-replicaspecification-contributorinsightsspecification): 
    ContributorInsightsSpecification
  [DeletionProtectionEnabled](#cfn-dynamodb-globaltable-replicaspecification-deletionprotectionenabled): Boolean
  [GlobalSecondaryIndexes](#cfn-dynamodb-globaltable-replicaspecification-globalsecondaryindexes): 
    - ReplicaGlobalSecondaryIndexSpecification
  [GlobalTableSettingsReplicationMode](#cfn-dynamodb-globaltable-replicaspecification-globaltablesettingsreplicationmode): String
  [KinesisStreamSpecification](#cfn-dynamodb-globaltable-replicaspecification-kinesisstreamspecification): 
    KinesisStreamSpecification
  [PointInTimeRecoverySpecification](#cfn-dynamodb-globaltable-replicaspecification-pointintimerecoveryspecification): 
    PointInTimeRecoverySpecification
  [ReadOnDemandThroughputSettings](#cfn-dynamodb-globaltable-replicaspecification-readondemandthroughputsettings): 
    ReadOnDemandThroughputSettings
  [ReadProvisionedThroughputSettings](#cfn-dynamodb-globaltable-replicaspecification-readprovisionedthroughputsettings): 
    ReadProvisionedThroughputSettings
  [Region](#cfn-dynamodb-globaltable-replicaspecification-region): String
  [ReplicaStreamSpecification](#cfn-dynamodb-globaltable-replicaspecification-replicastreamspecification): 
    ReplicaStreamSpecification
  [ResourcePolicy](#cfn-dynamodb-globaltable-replicaspecification-resourcepolicy): 
    ResourcePolicy
  [SSESpecification](#cfn-dynamodb-globaltable-replicaspecification-ssespecification): 
    ReplicaSSESpecification
  [TableClass](#cfn-dynamodb-globaltable-replicaspecification-tableclass): String
  [Tags](#cfn-dynamodb-globaltable-replicaspecification-tags): 
    - Tag
```

## Properties
<a name="aws-properties-dynamodb-globaltable-replicaspecification-properties"></a>

`ContributorInsightsSpecification`  <a name="cfn-dynamodb-globaltable-replicaspecification-contributorinsightsspecification"></a>
The settings used to enable or disable CloudWatch Contributor Insights for the specified replica. When not specified, defaults to contributor insights disabled for the replica.  
*Required*: No  
*Type*: [ContributorInsightsSpecification](aws-properties-dynamodb-globaltable-contributorinsightsspecification.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`DeletionProtectionEnabled`  <a name="cfn-dynamodb-globaltable-replicaspecification-deletionprotectionenabled"></a>
Determines if a replica is protected from deletion. When enabled, the table cannot be deleted by any user or process. This setting is disabled by default. For more information, see [Using deletion protection](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.Basics.html#WorkingWithTables.Basics.DeletionProtection) in the *Amazon DynamoDBDeveloper Guide*.  
*Required*: No  
*Type*: Boolean  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`GlobalSecondaryIndexes`  <a name="cfn-dynamodb-globaltable-replicaspecification-globalsecondaryindexes"></a>
Defines additional settings for the global secondary indexes of this replica.  
*Required*: No  
*Type*: Array of [ReplicaGlobalSecondaryIndexSpecification](aws-properties-dynamodb-globaltable-replicaglobalsecondaryindexspecification.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`GlobalTableSettingsReplicationMode`  <a name="cfn-dynamodb-globaltable-replicaspecification-globaltablesettingsreplicationmode"></a>
The replication mode for global table settings across multiple accounts. In a multi-account global table, you cannot make changes to a synchronized setting using CloudFormation. You need to use console or CLI to make any settings changes.  
*Required*: No  
*Type*: String  
*Allowed values*: `ENABLED | DISABLED`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`KinesisStreamSpecification`  <a name="cfn-dynamodb-globaltable-replicaspecification-kinesisstreamspecification"></a>
Defines the Kinesis Data Streams configuration for the specified replica.  
*Required*: No  
*Type*: [KinesisStreamSpecification](aws-properties-dynamodb-globaltable-kinesisstreamspecification.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`PointInTimeRecoverySpecification`  <a name="cfn-dynamodb-globaltable-replicaspecification-pointintimerecoveryspecification"></a>
The settings used to enable point in time recovery. When not specified, defaults to point in time recovery disabled for the replica.  
*Required*: No  
*Type*: [PointInTimeRecoverySpecification](aws-properties-dynamodb-globaltable-pointintimerecoveryspecification.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`ReadOnDemandThroughputSettings`  <a name="cfn-dynamodb-globaltable-replicaspecification-readondemandthroughputsettings"></a>
Sets read request settings for the replica table.  
*Required*: No  
*Type*: [ReadOnDemandThroughputSettings](aws-properties-dynamodb-globaltable-readondemandthroughputsettings.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`ReadProvisionedThroughputSettings`  <a name="cfn-dynamodb-globaltable-replicaspecification-readprovisionedthroughputsettings"></a>
Defines read capacity settings for the replica table.  
*Required*: No  
*Type*: [ReadProvisionedThroughputSettings](aws-properties-dynamodb-globaltable-readprovisionedthroughputsettings.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Region`  <a name="cfn-dynamodb-globaltable-replicaspecification-region"></a>
The region in which this replica exists.  
*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)

`ReplicaStreamSpecification`  <a name="cfn-dynamodb-globaltable-replicaspecification-replicastreamspecification"></a>
Represents the DynamoDB Streams configuration for a global table replica.   
*Required*: No  
*Type*: [ReplicaStreamSpecification](aws-properties-dynamodb-globaltable-replicastreamspecification.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`ResourcePolicy`  <a name="cfn-dynamodb-globaltable-replicaspecification-resourcepolicy"></a>
A resource-based policy document that contains permissions to add to the specified replica of a DynamoDB global table. Resource-based policies let you define access permissions by specifying who has access to each resource, and the actions they are allowed to perform on each resource.  
In a CloudFormation template, you can provide the policy in JSON or YAML format because CloudFormation converts YAML to JSON before submitting it to DynamoDB. For more information about resource-based policies, see [Using resource-based policies for DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/access-control-resource-based.html) and [Resource-based policy examples](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/rbac-examples.html).  
*Required*: No  
*Type*: [ResourcePolicy](aws-properties-dynamodb-globaltable-resourcepolicy.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`SSESpecification`  <a name="cfn-dynamodb-globaltable-replicaspecification-ssespecification"></a>
Allows you to specify a customer-managed key for the replica. When using customer-managed keys for server-side encryption, this property must have a value in all replicas.  
*Required*: No  
*Type*: [ReplicaSSESpecification](aws-properties-dynamodb-globaltable-replicassespecification.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`TableClass`  <a name="cfn-dynamodb-globaltable-replicaspecification-tableclass"></a>
The table class of the specified table. Valid values are `STANDARD` and `STANDARD_INFREQUENT_ACCESS`.  
*Required*: No  
*Type*: String  
*Allowed values*: `STANDARD | STANDARD_INFREQUENT_ACCESS`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Tags`  <a name="cfn-dynamodb-globaltable-replicaspecification-tags"></a>
An array of key-value pairs to apply to this replica.  
For more information, see [Tag](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-resource-tags.html).  
*Required*: No  
*Type*: Array of [Tag](aws-properties-dynamodb-globaltable-tag.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)