本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

自我管理 S3 程式碼儲存

根據預設，當您從 .zip 檔案封存建立或更新 Lambda 函數或 layer 時，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 或 建立具有自我管理 S3 程式碼儲存的函數 AWS CloudFormation。

使用 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 屬性REFERENCE中的 S3ObjectStorageMode 設定為 ：

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

搭配 layer 使用自我管理的 S3 儲存

您也可以針對 layer 版本使用自我管理的 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 定價。

考量事項