aws-cdk-lib.aws_lambda.S3ObjectStorageMode

S3ObjectStorageMode Enum

How Lambda manages the storage of your code package.

Source

aws-lambda/lib/code.ts

Type last changed

v2.271.0 · 25 Sep 2026

Example

import * as s3 from 'aws-cdk-lib/aws-s3';

declare const bucket: s3.IBucket;
declare const objectVersion: string;

new lambda.Function(this, 'MyFunction', {
  functionName: 'my-function',
  runtime: lambda.Runtime.NODEJS_LATEST,
  handler: 'index.handler',
  code: lambda.Code.fromBucketV2(bucket, 'my-function.zip', {
    objectVersion,
    s3ObjectStorageMode: lambda.S3ObjectStorageMode.REFERENCE,
  }),
});

new lambda.LayerVersion(this, 'MyLayer', {
  layerVersionName: 'my-layer',
  code: lambda.Code.fromBucketV2(bucket, 'my-layer.zip', {
    objectVersion,
    s3ObjectStorageMode: lambda.S3ObjectStorageMode.REFERENCE,
  }),
});

Members

Member	Description
COPY	Lambda copies the deployment package from your S3 bucket into Lambda-managed storage.
REFERENCE	Lambda references your code directly from your S3 bucket.

Referenced by

• BucketOptions.s3ObjectStorageModes3_object_storage_modes3ObjectStorageModeS3ObjectStorageModeS3ObjectStorageMode
• CodeConfig.s3ObjectStorageModes3_object_storage_modes3ObjectStorageModeS3ObjectStorageModeS3ObjectStorageMode