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 AnnotationTableConfiguration
<a name="aws-properties-s3-bucket-annotationtableconfiguration"></a>

Specifies the configuration for the annotation table associated with a bucket's Amazon S3 Metadata configuration. The annotation table is an Iceberg table that records annotation events for objects in the bucket.

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

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

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

```
{
  "[ConfigurationState](#cfn-s3-bucket-annotationtableconfiguration-configurationstate)" : {{String}},
  "[EncryptionConfiguration](#cfn-s3-bucket-annotationtableconfiguration-encryptionconfiguration)" : {{MetadataTableEncryptionConfiguration}},
  "[Role](#cfn-s3-bucket-annotationtableconfiguration-role)" : {{String}},
  "[TableArn](#cfn-s3-bucket-annotationtableconfiguration-tablearn)" : {{String}},
  "[TableName](#cfn-s3-bucket-annotationtableconfiguration-tablename)" : {{String}}
}
```

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

```
  [ConfigurationState](#cfn-s3-bucket-annotationtableconfiguration-configurationstate): {{String}}
  [EncryptionConfiguration](#cfn-s3-bucket-annotationtableconfiguration-encryptionconfiguration): {{
    MetadataTableEncryptionConfiguration}}
  [Role](#cfn-s3-bucket-annotationtableconfiguration-role): {{String}}
  [TableArn](#cfn-s3-bucket-annotationtableconfiguration-tablearn): {{String}}
  [TableName](#cfn-s3-bucket-annotationtableconfiguration-tablename): {{String}}
```

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

`ConfigurationState`  <a name="cfn-s3-bucket-annotationtableconfiguration-configurationstate"></a>
The state of the annotation table. Valid values are `ENABLED` and `DISABLED`.  
*Required*: Yes  
*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)

`EncryptionConfiguration`  <a name="cfn-s3-bucket-annotationtableconfiguration-encryptionconfiguration"></a>
Property description not available.  
*Required*: No  
*Type*: [MetadataTableEncryptionConfiguration](aws-properties-s3-bucket-metadatatableencryptionconfiguration.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Role`  <a name="cfn-s3-bucket-annotationtableconfiguration-role"></a>
The ARN of the IAM role used to manage the annotation table.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`TableArn`  <a name="cfn-s3-bucket-annotationtableconfiguration-tablearn"></a>
Property description not available.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`TableName`  <a name="cfn-s3-bucket-annotationtableconfiguration-tablename"></a>
Property description not available.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)