自行管理的 S3 代码存储

默认情况下，当您从 .zip 文件存档中创建或更新 Lambda 函数或层时，Lambda 会将您的代码副本存储在 Lambda 托管式存储中。每个 AWS 账户在每个区域有 300 GB 的 Lambda 托管式存储配额。

使用自行管理的 S3 代码存储时，您可以将 Lambda 配置为直接从您账户中的 S3 存储桶引用您的代码。Lambda 不会存储您的代码副本，因此该代码不会占用您的 Lambda 托管式存储配额。Lambda 会直接从您的 S3 存储桶访问您的代码。

自行管理的 S3 代码存储可用于使用.zip 文件存档创建和更新的所有函数和层。除 Glacier 存储类别外，此类存储兼容所有 S3 存储类别。

设置自行管理的 S3 代码存储

要使用自行管理的 S3 代码存储，请完成以下步骤：

配置权限

要使用自行管理的 S3 代码存储，请向 Lambda 服务主体 (lambda.amazonaws.com) 授予您的源对象访问权限。添加以下 S3 存储桶策略：

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "LambdaSelfManagedCodeAccess",
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:GetObjectVersion"
      ],
      "Resource": [
        "arn:aws:s3:::my-bucket/my-function.zip"
      ],
      "Principal": {
        "Service": "lambda.amazonaws.com"
      },
      "Condition": {
        "ArnLike": {
          "aws:SourceArn": "arn:aws:lambda:us-east-1:111122223333:function:my-function"
        }
      }
    }
  ]
}

使用自行管理的 S3 存储创建一个函数

您可以通过 AWS CLI 或 AWS CloudFormation 创建一个使用自行管理的 S3 代码存储的函数。

使用 AWS CLI

将 create-function 命令与 S3ObjectStorageMode=REFERENCE 参数一起使用：

aws lambda create-function \
  --function-name my-function \
  --runtime python3.12 \
  --role arn:aws:iam::111122223333:role/lambda-execution-role \
  --handler lambda_function.lambda_handler \
  --code S3Bucket=my-bucket,\
S3Key=my-function.zip,\
S3ObjectVersion=abc123def456,\
S3ObjectStorageMode=REFERENCE

要更新现有函数以使用自行管理的 S3 存储，请执行以下操作：

aws lambda update-function-code \
  --function-name my-function \
  --s3-bucket my-bucket \
  --s3-key my-function.zip \
  --s3-object-version abc123def456 \
  --s3-object-storage-mode REFERENCE

使用 AWS CloudFormation

在您的 CloudFormation 模板中，请在 AWS::Lambda::Function 资源的 Code 属性中将 S3ObjectStorageMode 设置为 REFERENCE：

Resources:
  MyFunction:
    Type: AWS::Lambda::Function
    Properties:
      FunctionName: my-function
      Runtime: python3.12
      Handler: lambda_function.lambda_handler
      Role: !GetAtt LambdaExecutionRole.Arn
      Code:
        S3Bucket: my-bucket
        S3Key: my-function.zip
        S3ObjectVersion: abc123def456
        S3ObjectStorageMode: REFERENCE

将自行管理的 S3 存储用于层

您也可以将自行管理的 S3 代码存储用于层版本。使用 publish-layer-version 命令和 S3ObjectStorageMode=REFERENCE：

aws lambda publish-layer-version \
  --layer-name my-layer \
  --content S3Bucket=my-bucket,S3Key=my-layer.zip,S3ObjectStorageMode=REFERENCE \
  --compatible-runtimes python3.12

您可以将 Lambda 托管式存储和自行管理存储的任意组合用于函数代码和层代码。

切换存储模式

您可以在更新函数代码或发布新的层版本时切换 Lambda 托管式存储和自行管理的 S3 代码存储。将 S3ObjectStorageMode 设置为 COPY 或 REFERENCE：

当您从 COPY 切换到 REFERENCE 时，Lambda 会删除您的源代码的 Lambda 托管式副本。当您从 REFERENCE 切换到 COPY 时，Lambda 会将您的源代码副本存储到 Lambda 托管式存储中。如果您已超出 Lambda 托管式代码存储限制，则将无法切换到 COPY。

使用自行管理存储时的函数生命周期

Lambda 会定期从您的 S3 存储桶访问源对象，以重新优化您的函数代码。您必须维持源对象的访问权限，才能让函数保持活动状态。

跨账户和跨区域使用

您可以从不同账户和不同区域的 S3 存储桶中的源代码创建函数和层。跨区域对象检索会产生额外的 S3 数据传输费用。有关详细信息，请参阅 S3 定价。

注意事项