# NoncurrentVersionTransition

Describes when noncurrent versions transition to a specified storage class.

- Source: [`aws-s3/lib/rule.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0/packages/aws-cdk-lib/aws-s3/lib/rule.ts#L177)
- Type last changed: v2.26.0 · 30 May 2022

## Example

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import * as cdk from 'aws-cdk-lib';
import { aws_s3 as s3 } from 'aws-cdk-lib';

declare const storageClass: s3.StorageClass;
const noncurrentVersionTransition: s3.NoncurrentVersionTransition = {
  storageClass: storageClass,
  transitionAfter: cdk.Duration.minutes(30),

  // the properties below are optional
  noncurrentVersionsToRetain: 123,
};
```

## Properties

- `noncurrentVersionsToRetain`: number — Indicates the number of noncurrent version objects to be retained.

  **Default:** No noncurrent version retained.

  Can be up to 100 noncurrent versions retained.

- `storageClass`: [StorageClass](/cdk/api/v2/docs/aws-cdk-lib.aws_s3.StorageClass.html) (required) — The storage class to which you want the object to transition.

- `transitionAfter`: [Duration](/cdk/api/v2/docs/aws-cdk-lib.Duration.html) (required) — Indicates the number of days after creation when objects are transitioned to the specified storage class.

  **Default:** No transition count.
