feat(lambda): layer version removal policy

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

@@ -171,7 +171,7 @@ fn.currentVersion.addAlias('live');
 
 ## Layers
 
-The `lambda.LayerVersion` class can be used to define Lambda layers and manage
+The `lambda.LayerVersion` class can be used to define Lambda layer versions and manage
 granting permissions to other AWS accounts or organizations.
 
 [Example of Lambda Layer usage](test/integ.layer-version.lit.ts)

packages/@aws-cdk/aws-lambda/lib/layers.ts

@@ -1,4 +1,4 @@
-import { IResource, Resource } from '@aws-cdk/core';
+import { IResource, RemovalPolicy, Resource } from '@aws-cdk/core';
 import { Construct } from 'constructs';
 import { Code } from './code';
 import { CfnLayerVersion, CfnLayerVersionPermission } from './lambda.generated';
@@ -28,6 +28,14 @@ export interface LayerVersionOptions {
    * @default - A name will be generated.
    */
   readonly layerVersionName?: string;
+
+  /**
+   * Whether to retain the previous version of the layer when a new version is added
+   * or when the stack is deleted.
+   *
+   * @default - The previous version is deleted.
+   */
+  readonly removalPolicy?: RemovalPolicy;
 }
 
 export interface LayerVersionProps extends LayerVersionOptions {
@@ -198,6 +206,10 @@ export class LayerVersion extends LayerVersionBase {
       licenseInfo: props.license,
     });
 
+    if (props.removalPolicy) {
+      resource.applyRemovalPolicy(props.removalPolicy);
+    }
+
     props.code.bindToResource(resource, {
       resourceProperty: 'Content',
     });

packages/@aws-cdk/aws-lambda/test/layers.test.ts

@@ -86,4 +86,21 @@ describe('layers', () => {
       },
     }, ResourcePart.CompleteDefinition);
   });
+
+  test('creating a layer with a removal policy', () => {
+    // GIVEN
+    const stack = new cdk.Stack();
+
+    // WHEN
+    new lambda.LayerVersion(stack, 'layer', {
+      code: lambda.Code.fromAsset(path.join(__dirname, 'layer-code')),
+      removalPolicy: cdk.RemovalPolicy.RETAIN,
+    });
+
+    // THEN
+    expect(canonicalizeTemplate(SynthUtils.toCloudFormation(stack))).toHaveResource('AWS::Lambda::LayerVersion', {
+      UpdateReplacePolicy: 'Retain',
+      DeletionPolicy: 'Retain',
+    }, ResourcePart.CompleteDefinition);
+  });
 });