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

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

 The journal table record expiration settings for a journal table in an S3 Metadata configuration. 

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

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

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

```
{
  "[Days](#cfn-s3-bucket-recordexpiration-days)" : {{Integer}},
  "[Expiration](#cfn-s3-bucket-recordexpiration-expiration)" : {{String}}
}
```

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

```
  [Days](#cfn-s3-bucket-recordexpiration-days): {{Integer}}
  [Expiration](#cfn-s3-bucket-recordexpiration-expiration): {{String}}
```

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

`Days`  <a name="cfn-s3-bucket-recordexpiration-days"></a>
 If you enable journal table record expiration, you can set the number of days to retain your journal table records. Journal table records must be retained for a minimum of 7 days. To set this value, specify any whole number from `7` to `2147483647`. For example, to retain your journal table records for one year, set this value to `365`.   
*Required*: No  
*Type*: Integer  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Expiration`  <a name="cfn-s3-bucket-recordexpiration-expiration"></a>
 Specifies whether journal table record expiration is enabled or disabled.   
*Required*: Yes  
*Type*: String  
*Allowed values*: `ENABLED | DISABLED`  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)