LayerVersion

class LayerVersion : KotlinCustomResource

Provides a Lambda Layer Version resource. Lambda Layers allow you to reuse shared bits of code across multiple lambda functions. For information about Lambda Layers and how to use them, see AWS Lambda Layers.

NOTE: Setting skip_destroy to true means that the AWS Provider will not destroy any layer version, even when running destroy. Layer versions are thus intentional dangling resources that are not managed by the provider and may incur extra expense in your AWS account.

Example Usage

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.lambda.LayerVersion;
import com.pulumi.aws.lambda.LayerVersionArgs;
import com.pulumi.asset.FileArchive;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var lambdaLayer = new LayerVersion("lambdaLayer", LayerVersionArgs.builder()
.compatibleRuntimes("nodejs16.x")
.code(new FileArchive("lambda_layer_payload.zip"))
.layerName("lambda_layer_name")
.build());
}
}

Specifying the Deployment Package

AWS Lambda Layers expect source code to be provided as a deployment package whose structure varies depending on which compatible_runtimes this layer specifies. See Runtimes for the valid values of compatible_runtimes. Once you have created your deployment package you can specify it either directly as a local file (using the filename argument) or indirectly via Amazon S3 (using the s3_bucket, s3_key and s3_object_version arguments). When providing the deployment package via S3 it may be useful to use the aws.s3.BucketObjectv2 resource to upload it. For larger deployment packages it is recommended by Amazon to upload via S3, since the S3 API has better support for uploading large files efficiently.

Import

Lambda Layers can be imported using arn.

$ pulumi import aws:lambda/layerVersion:LayerVersion \

aws_lambda_layer_version.test_layer
arn:aws:lambda:REGION:ACCOUNT_ID:layer:LAYER_NAME:LAYER_VERSION

Properties

Link copied to clipboard
val arn: Output<String>

ARN of the Lambda Layer with version.

Link copied to clipboard
val code: Output<Archive>?

Path to the function's deployment package within the local filesystem. If defined, The s3_-prefixed options cannot be used.

Link copied to clipboard

List of Architectures this layer is compatible with. Currently x86_64 and arm64 can be specified.

Link copied to clipboard

List of Runtimes this layer is compatible with. Up to 5 runtimes can be specified.

Link copied to clipboard
val createdDate: Output<String>

Date this resource was created.

Link copied to clipboard
val description: Output<String>?

Description of what your Lambda Layer does.

Link copied to clipboard
val id: Output<String>
Link copied to clipboard
val layerArn: Output<String>

ARN of the Lambda Layer without version.

Link copied to clipboard
val layerName: Output<String>

Unique name for your Lambda Layer The following arguments are optional:

Link copied to clipboard
val licenseInfo: Output<String>?

License info for your Lambda Layer. See License Info.

Link copied to clipboard
val pulumiChildResources: Set<KotlinResource>
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
val s3Bucket: Output<String>?

S3 bucket location containing the function's deployment package. Conflicts with filename. This bucket must reside in the same AWS region where you are creating the Lambda function.

Link copied to clipboard
val s3Key: Output<String>?

S3 key of an object containing the function's deployment package. Conflicts with filename.

Link copied to clipboard
val s3ObjectVersion: Output<String>?

Object version containing the function's deployment package. Conflicts with filename.

Link copied to clipboard
val signingJobArn: Output<String>

ARN of a signing job.

Link copied to clipboard

ARN for a signing profile version.

Link copied to clipboard
val skipDestroy: Output<Boolean>?

Whether to retain the old version of a previously deployed Lambda Layer. Default is false. When this is not set to true, changing any of compatible_architectures, compatible_runtimes, description, filename, layer_name, license_info, s3_bucket, s3_key, s3_object_version, or source_code_hash forces deletion of the existing layer version and creation of a new layer version.

Link copied to clipboard
val sourceCodeHash: Output<String>

Used to trigger updates. Must be set to a base64-encoded SHA256 hash of the package file specified with either filename or s3_key.

Link copied to clipboard
val sourceCodeSize: Output<Int>

Size in bytes of the function .zip file.

Link copied to clipboard
val urn: Output<String>
Link copied to clipboard
val version: Output<String>

Lambda Layer version.