AWS::S3::Bucket NoncurrentVersionTransition
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
To declare this entity in your AWS CloudFormation template, use the following syntax:
JSON
{ "NewerNoncurrentVersions" :
Integer
, "StorageClass" :String
, "TransitionInDays" :Integer
}
YAML
NewerNoncurrentVersions:
Integer
StorageClass:String
TransitionInDays: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
StorageClass
-
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
TransitionInDays
-
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 in the Amazon S3 User Guide.
Required: Yes
Type: Integer
Update requires: No interruption