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

Container for the transition rule that describes when noncurrent objects transition to the `STANDARD_IA`, `ONEZONE_IA`, `INTELLIGENT_TIERING`, `GLACIER_IR`, `GLACIER`, or `DEEP_ARCHIVE` storage class. If your bucket is versioning-enabled (or versioning is suspended), you can set this action to request that Amazon S3 transition noncurrent object versions to the `STANDARD_IA`, `ONEZONE_IA`, `INTELLIGENT_TIERING`, `GLACIER_IR`, `GLACIER`, or `DEEP_ARCHIVE` storage class at a specific period in the object's lifetime. If you specify this property, don't specify the `NoncurrentVersionTransitions` property.

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

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

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

```
{
  "[NewerNoncurrentVersions](#cfn-s3-bucket-noncurrentversiontransition-newernoncurrentversions)" : Integer,
  "[StorageClass](#cfn-s3-bucket-noncurrentversiontransition-storageclass)" : String,
  "[TransitionInDays](#cfn-s3-bucket-noncurrentversiontransition-transitionindays)" : Integer
}
```

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

```
  [NewerNoncurrentVersions](#cfn-s3-bucket-noncurrentversiontransition-newernoncurrentversions): Integer
  [StorageClass](#cfn-s3-bucket-noncurrentversiontransition-storageclass): String
  [TransitionInDays](#cfn-s3-bucket-noncurrentversiontransition-transitionindays): Integer
```

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

`NewerNoncurrentVersions`  <a name="cfn-s3-bucket-noncurrentversiontransition-newernoncurrentversions"></a>
Specifies how many noncurrent versions Amazon S3 will retain. If there are this many more recent noncurrent versions, Amazon S3 will take the associated action. For more information about noncurrent versions, see [Lifecycle configuration elements](https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html) in the *Amazon S3 User Guide*.  
*Required*: No  
*Type*: Integer  
*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-noncurrentversiontransition-storageclass"></a>
The class of storage used to store the object.  
*Required*: Yes  
*Type*: String  
*Allowed values*: `DEEP_ARCHIVE | GLACIER | Glacier | GLACIER_IR | INTELLIGENT_TIERING | ONEZONE_IA | STANDARD_IA`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`TransitionInDays`  <a name="cfn-s3-bucket-noncurrentversiontransition-transitionindays"></a>
Specifies the number of days an object is noncurrent before Amazon S3 can perform the associated action. For information about the noncurrent days calculations, see [How Amazon S3 Calculates How Long an Object Has Been Noncurrent](https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#non-current-days-calculations) in the *Amazon S3 User Guide*.  
*Required*: Yes  
*Type*: Integer  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)