セルフマネージド S3 コードストレージ

デフォルトでは、.zip ファイルアーカイブから Lambda 関数またはレイヤーを作成または更新すると、Lambda はコードのコピーを Lambda マネージドストレージに保存します。各 AWS アカウントには、リージョンごとに Lambda マネージドストレージの 300 GB のクォータがあります。

セルフマネージド S3 コードストレージを使用すると、アカウントの S3 バケットから直接コードを参照するように Lambda を設定できます。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 を使用する場合

S3ObjectStorageMode=REFERENCE パラメータがある create-function コマンドを使用します。

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 コードストレージを使用することもできます。S3ObjectStorageMode=REFERENCE を指定して publish-layer-version コマンドを使用します。

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 コードストレージとセルフマネージド S3 コードストレージを切り替えることができます。S3ObjectStorageMode を COPY または REFERENCE に設定します。

COPY から REFERENCE に切り替えると、Lambda はソースコードの Lambda マネージドコピーを削除します。REFERENCE から COPY に切り替えると、Lambda はソースコードに Lambda マネージドコピーを作成します。Lambda マネージドコードストレージの制限を超えると COPY への切り替えは失敗します。

セルフマネージドストレージの関数ライフサイクル

Lambda は、S3 バケットからソースオブジェクトに定期的にアクセスして関数コードを最適化します。関数をアクティブに保つには、ソースオブジェクトへのアクセスを維持する必要があります。

クロスアカウントおよびクロスリージョンでの使用

関数とレイヤーは、複数の異なるアカウントと複数の異なるリージョンの S3 バケットのソースコードから作成できます。クロスリージョンオブジェクトの取得には、追加の S3 データ転送コストが発生します。詳細については、S3 の料金表を参照してください。

考慮事項