AWS::S3::Bucket NoncurrentVersionExpiration - Amazon CloudFormation
SyntaxProperties
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

AWS::S3::Bucket NoncurrentVersionExpiration

Specifies when noncurrent object versions expire. Upon expiration, Amazon S3 permanently deletes the noncurrent object versions. You set this lifecycle configuration action on a bucket that has versioning enabled (or suspended) to request that Amazon S3 delete noncurrent object versions at a specific period in the object's lifetime. For more information about setting a lifecycle rule configuration, see AWS::S3::Bucket Rule.

Syntax

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

JSON

{
  "NewerNoncurrentVersions" : Integer,
  "NoncurrentDays" : Integer
}

YAML

  NewerNoncurrentVersions: Integer
  NoncurrentDays: Integer

Properties

NewerNoncurrentVersions

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 in the Amazon S3 User Guide.

Required: No

Type: Integer

Update requires: No interruption

NoncurrentDays

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 When an Object Became Noncurrent in the Amazon S3 User Guide.

Required: Yes

Type: Integer

Update requires: No interruption