feat(efs): add support for transitioning files from infrequent access to primary storage (#16522)

This PR adds support for [TransitionToPrimaryStorageClass](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-efs-filesystem-lifecyclepolicy.html) for ``AWS::EFS::FileSystem``

----

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

Author: longtv2222

packages/@aws-cdk/aws-efs/README.md

@@ -36,6 +36,7 @@ const fileSystem = new efs.FileSystem(this, 'MyEfsFileSystem', {
   vpc: new ec2.Vpc(this, 'VPC'),
   lifecyclePolicy: efs.LifecyclePolicy.AFTER_14_DAYS, // files are not transitioned to infrequent access (IA) storage by default
   performanceMode: efs.PerformanceMode.GENERAL_PURPOSE, // default
+  outInfrequentAccessPolicy: efs.OutOfInfrequentAccessPolicy.AFTER_1_ACCESS, // files are not transitioned back from (infrequent access) IA to primary storage by default
 });
 ```
 

packages/@aws-cdk/aws-efs/lib/efs-file-system.ts

@@ -42,6 +42,19 @@ export enum LifecyclePolicy {
   AFTER_90_DAYS = 'AFTER_90_DAYS'
 }
 
+/**
+ * EFS Out Of Infrequent Access Policy, if a file is accessed given times, it will move back to primary
+ * storage class.
+ *
+ * @see https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-efs-filesystem-lifecyclepolicy.html#cfn-efs-filesystem-lifecyclepolicy-transitiontoprimarystorageclass
+ */
+export enum OutOfInfrequentAccessPolicy {
+  /**
+   * After 1 access
+   */
+  AFTER_1_ACCESS = 'AFTER_1_ACCESS'
+}
+
 /**
  * EFS Performance mode.
  *
@@ -165,6 +178,13 @@ export interface FileSystemProps {
    */
   readonly lifecyclePolicy?: LifecyclePolicy;
 
+  /**
+   * A policy used by EFS lifecycle management to transition files from Infrequent Access (IA) storage class to
+   * primary storage class.
+   *
+   * @default - None. EFS will not transition files from IA storage to primary storage.
+   */
+  readonly outOfInfrequentAccessPolicy?: OutOfInfrequentAccessPolicy;
   /**
    * The performance mode that the file system will operate under.
    * An Amazon EFS file system's performance mode can't be changed after the file system has been created.
@@ -324,7 +344,12 @@ export class FileSystem extends FileSystemBase {
     const filesystem = new CfnFileSystem(this, 'Resource', {
       encrypted: encrypted,
       kmsKeyId: props.kmsKey?.keyArn,
-      lifecyclePolicies: (props.lifecyclePolicy ? [{ transitionToIa: props.lifecyclePolicy }] : undefined),
+      lifecyclePolicies: (
+        (props.lifecyclePolicy || props.outOfInfrequentAccessPolicy) ?
+          [{
+            transitionToIa: props.lifecyclePolicy,
+            transitionToPrimaryStorageClass: props.outOfInfrequentAccessPolicy,
+          }] : undefined),
       performanceMode: props.performanceMode,
       throughputMode: props.throughputMode,
       provisionedThroughputInMibps: props.provisionedThroughputPerSecond?.toMebibytes(),

packages/@aws-cdk/aws-efs/test/efs-file-system.test.ts

@@ -2,10 +2,10 @@ import { Template, Match } from '@aws-cdk/assertions';
 import * as ec2 from '@aws-cdk/aws-ec2';
 import * as iam from '@aws-cdk/aws-iam';
 import * as kms from '@aws-cdk/aws-kms';
+import { testFutureBehavior, testLegacyBehavior } from '@aws-cdk/cdk-build-tools/lib/feature-flag';
 import { App, RemovalPolicy, Size, Stack, Tags } from '@aws-cdk/core';
 import * as cxapi from '@aws-cdk/cx-api';
-import { testFutureBehavior, testLegacyBehavior } from '@aws-cdk/cdk-build-tools/lib/feature-flag';
-import { FileSystem, LifecyclePolicy, PerformanceMode, ThroughputMode } from '../lib';
+import { FileSystem, LifecyclePolicy, PerformanceMode, ThroughputMode, OutOfInfrequentAccessPolicy } from '../lib';
 
 let stack = new Stack();
 let vpc = new ec2.Vpc(stack, 'VPC');
@@ -128,6 +128,33 @@ test('file system is created correctly with a life cycle property', () => {
   });
 });
 
+test('file system is created correctly with a life cycle property and out of infrequent access property', () => {
+  // WHEN
+  new FileSystem(stack, 'EfsFileSystem', {
+    vpc,
+    lifecyclePolicy: LifecyclePolicy.AFTER_7_DAYS,
+    outOfInfrequentAccessPolicy: OutOfInfrequentAccessPolicy.AFTER_1_ACCESS,
+  });
+  // THEN
+  Template.fromStack(stack).hasResourceProperties('AWS::EFS::FileSystem', {
+    LifecyclePolicies: [{
+      TransitionToIA: 'AFTER_7_DAYS',
+      TransitionToPrimaryStorageClass: 'AFTER_1_ACCESS',
+    }],
+  });
+});
+
+test('LifecyclePolicies should be disabled when lifecyclePolicy and outInfrequentAccessPolicy are not specified', () => {
+  // WHEN
+  new FileSystem(stack, 'EfsFileSystem', {
+    vpc,
+  });
+  // THEN
+  Template.fromStack(stack).hasResourceProperties('AWS::EFS::FileSystem', {
+    LifecyclePolicies: Match.absent(),
+  });
+});
+
 test('file system is created correctly with performance mode', () => {
   // WHEN
   new FileSystem(stack, 'EfsFileSystem', {