Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Self-managed Stockage de code S3

Par défaut, lorsque vous créez ou mettez à jour une fonction ou une couche Lambda à partir d'une archive de fichiers .zip, Lambda stocke une copie de votre code dans un espace de stockage. Lambda-managed Chaque AWS compte dispose d'un quota de Lambda-managed stockage de 300 Go par région.

Grâce au stockage de code S3 autogéré, vous pouvez configurer Lambda pour qu'il référence votre code directement à partir d'un compartiment S3 de votre compte. Lambda ne stocke pas de copie de votre code. Le code n'est donc pas pris en compte dans votre quota Lambda-managed de stockage. Lambda accède à votre code directement depuis votre compartiment S3.

Self-managed Le stockage de code S3 est disponible pour toutes les fonctions et couches créées et mises à jour à l'aide d'archives de fichiers .zip. Il est compatible avec toutes les classes de stockage S3, à l'exception des classes de stockage Glacier.

Configuration d'un stockage de code S3 autogéré

Pour utiliser le stockage de code S3 autogéré, procédez comme suit :

Configuration des autorisations

Pour utiliser le stockage de code S3 autogéré, accordez au Lambda service principal lambda.amazonaws.com () l'autorisation d'accéder à vos objets source. Ajoutez la politique de compartiment S3 suivante :

{
  "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"
        }
      }
    }
  ]
}

Création d'une fonction avec un stockage S3 autogéré

Vous pouvez créer une fonction avec un stockage de code S3 autogéré à l'aide du AWS CLI ou AWS CloudFormation.

Utilisation de AWS CLI

Utilisez la create-function commande avec le S3ObjectStorageMode=REFERENCE paramètre :

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

Pour mettre à jour une fonction existante afin d'utiliser le stockage S3 autogéré :

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

Utilisation AWS CloudFormation

Dans votre CloudFormation modèle, définissez S3ObjectStorageMode la Code propriété REFERENCE de la AWS::Lambda::Function ressource comme suit :

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

Utilisation d'un stockage S3 autogéré avec plusieurs couches

Vous pouvez également utiliser le stockage de code S3 autogéré pour les versions de couches. Utilisez la publish-layer-version commande avec 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

Vous pouvez utiliser n'importe quelle combinaison de Lambda-managed stockage autogéré pour le code de fonction et le code de couche.

Basculer entre les modes de stockage

Vous pouvez basculer entre le stockage Lambda-managed de code S3 autogéré lorsque vous mettez à jour votre code de fonction ou que vous publiez une nouvelle version de couche. Réglez sur S3ObjectStorageMode l'une COPY ou l'autre des REFERENCE options suivantes

Lorsque vous passez de COPY àREFERENCE, Lambda supprime la Lambda-managed copie de votre code source. Lorsque vous passez de REFERENCE àCOPY, Lambda crée une copie de votre code source dans Lambda-managed le stockage. Le passage à l'COPYoption échoue si vous dépassez la limite de stockage Lambda-managed du code.

Cycle de vie des fonctions avec stockage autogéré

Lambda accède régulièrement à l'objet source depuis votre compartiment S3 afin de réoptimiser votre code de fonction. Vous devez conserver l'accès à l'objet source pour que votre fonction reste active.

Cross-account et utilisation entre régions

Vous pouvez créer des fonctions et des couches à partir du code source dans des compartiments S3 de différents comptes et de différentes régions. Cross-Region la récupération d'objets entraîne des coûts de transfert de données S3 supplémentaires. Consultez la tarification de S3 pour plus de détails.

Considérations