feat(aws-s3): support number of newer versions to retain in lifecycle policy (#18225)

The AWS Management console and CloudFormation support to set a number of noncurrent versions to be retained for S3 lifecycle transitions as described in #17996. 

This pull request introduces the property for S3 lifecycle configurations as an optional property to CDK. 

The maximum supported number of noncurrent versions that could be retained is 100 which is also documented for the new property. However, no additional check is inserted if the number set by the developer is actually between 0 and 100. If this check is desired, a discussion would be good on how to achieve throwing an error as I don't see a smooth solution. 

Resolves #17996.

----

*By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license*

Author: Fokko Bucys

packages/@aws-cdk/aws-s3/lib/bucket.ts

@@ -1886,6 +1886,7 @@ export class Bucket extends BucketBase {
         noncurrentVersionTransitions: mapOrUndefined(rule.noncurrentVersionTransitions, t => ({
           storageClass: t.storageClass.value,
           transitionInDays: t.transitionAfter.toDays(),
+          newerNoncurrentVersions: t.noncurrentVersionsToRetain,
         })),
         prefix: rule.prefix,
         status: enabled ? 'Enabled' : 'Disabled',

packages/@aws-cdk/aws-s3/lib/rule.ts

@@ -151,6 +151,13 @@ export interface NoncurrentVersionTransition {
    * @default No transition count.
    */
   readonly transitionAfter: Duration;
+
+  /**
+   * Indicates the number of noncurrent version objects to be retained. Can be up to 100 noncurrent versions retained.
+   *
+   * @default No noncurrent version retained.
+   */
+  readonly noncurrentVersionsToRetain?: number;
 }
 
 /**

packages/@aws-cdk/aws-s3/test/rules.test.ts

@@ -139,4 +139,76 @@ describe('rules', () => {
       },
     });
   });
+
+  test('Noncurrent transistion rule with versions to retain', () => {
+    // GIVEN
+    const stack = new Stack();
+
+    // WHEN: Noncurrent version to retain available
+    new Bucket(stack, 'Bucket1', {
+      versioned: true,
+      lifecycleRules: [{
+        noncurrentVersionExpiration: Duration.days(10),
+        noncurrentVersionTransitions: [
+          {
+            storageClass: StorageClass.GLACIER_INSTANT_RETRIEVAL,
+            transitionAfter: Duration.days(10),
+            noncurrentVersionsToRetain: 1,
+          },
+        ],
+      }],
+    });
+
+    // THEN
+    Template.fromStack(stack).hasResourceProperties('AWS::S3::Bucket', {
+      LifecycleConfiguration: {
+        Rules: [{
+          NoncurrentVersionExpirationInDays: 10,
+          NoncurrentVersionTransitions: [
+            {
+              NewerNoncurrentVersions: 1,
+              StorageClass: 'GLACIER_IR',
+              TransitionInDays: 10,
+            },
+          ],
+          Status: 'Enabled',
+        }],
+      },
+    });
+  });
+
+  test('Noncurrent transistion rule without versions to retain', () => {
+    // GIVEN
+    const stack = new Stack();
+
+    // WHEN: Noncurrent version to retain not set
+    new Bucket(stack, 'Bucket1', {
+      versioned: true,
+      lifecycleRules: [{
+        noncurrentVersionExpiration: Duration.days(10),
+        noncurrentVersionTransitions: [
+          {
+            storageClass: StorageClass.GLACIER_INSTANT_RETRIEVAL,
+            transitionAfter: Duration.days(10),
+          },
+        ],
+      }],
+    });
+
+    // THEN
+    Template.fromStack(stack).hasResourceProperties('AWS::S3::Bucket', {
+      LifecycleConfiguration: {
+        Rules: [{
+          NoncurrentVersionExpirationInDays: 10,
+          NoncurrentVersionTransitions: [
+            {
+              StorageClass: 'GLACIER_IR',
+              TransitionInDays: 10,
+            },
+          ],
+          Status: 'Enabled',
+        }],
+      },
+    });
+  });
 });