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 le stockage. Lambda-managed Chaque AWS compte dispose d'un quota de 300 Go de Lambda-managed stockage par région.

Grâce au stockage de code S3 autogéré, vous pouvez configurer Lambda pour référencer 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 principal du service Lambda (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 de la console AWS CLI, du ou AWS CloudFormation.

Utilisation de la console

Lorsque vous mettez à jour une fonction depuis un emplacement S3 dans la console Lambda, vous pouvez choisir le mode de stockage du code.

Après avoir configuré le mode Référence, la section Propriétés du code de l'onglet Code de la fonction affiche le mode de stockage du code : Référence et l'emplacement S3 pointant vers votre compartiment S3.

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 sur REFERENCE dans la Code propriété de la AWS::Lambda::Function ressource :

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 du stockage S3 autogéré avec des couches

Vous pouvez également utiliser le stockage de code S3 autogéré pour les versions de couche. 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 le code de votre fonction ou que vous publiez une nouvelle version de couche. Réglez sur S3ObjectStorageMode l'un des deux COPY ou sur REFERENCE :

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 le Lambda-managed stockage. Le passage en mode COPY é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 pour réoptimiser le code de votre fonction. Vous devez conserver l'accès à l'objet source pour que votre fonction reste active.

Cross-account et utilisation interrégionale

Vous pouvez créer des fonctions et des couches à partir du code source dans des compartiments S3 dans différents comptes et dans 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 S3 pour plus de détails.

Considérations