View a markdown version of this page

Configurer les fonctions durables de Lambda - AWS Lambda
Permettre une exécution durableBonnes pratiques en matière de configuration

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.

Configurer les fonctions durables de Lambda

Les paramètres d'exécution durables contrôlent la durée d'exécution de votre AWS Lambda fonction, la durée pendant laquelle le service conserve l'historique des exécutions et la AWS KMS clé qui chiffre vos données d'exécution. Configurez ces paramètres pour permettre une exécution durable de votre fonction.

Permettre une exécution durable

Configurez l'DurableConfigobjet lors de la création de votre fonction pour définir le délai d'exécution et la conservation de l'historique. Vous ne pouvez activer l'exécution durable que lors de la création d'une fonction. Vous ne pouvez pas l'activer sur les fonctions existantes.

AWS CLI

aws lambda create-function \
  --function-name my-durable-function \
  --runtime nodejs24.x \
  --role arn:aws:iam::123456789012:role/my-durable-role \
  --handler index.handler \
  --zip-file fileb://function.zip \
  --durable-config '{"ExecutionTimeout": 3600, "RetentionPeriodInDays": 30, "KMSKeyArn": "arn:aws:kms:us-east-1:111122223333:key/key-id"}'
CloudFormation

Resources:
  MyDurableFunction:
    Type: AWS::Lambda::Function
    Properties:
      FunctionName: my-durable-function
      Runtime: nodejs24.x
      Handler: index.handler
      Code:
        ZipFile: |
          // Your durable function code
      DurableConfig:
        ExecutionTimeout: 3600
        RetentionPeriodInDays: 30
        KMSKeyArn: "arn:aws:kms:us-east-1:111122223333:key/key-id"

Paramètres de configuration :

  • ExecutionTimeout : obligatoire. Durée maximale en secondes pendant laquelle une exécution durable peut être exécutée avant que Lambda n'arrête l'exécution. Ce délai s'applique à l'ensemble de l'exécution durable, et non aux appels de fonctions individuels. Vous devez spécifier ExecutionTimeout chaque fois que vous fournissez DurableConfig ; la création d'une fonction avec une configuration durable mais aucun délai d'exécution échoue avec unInvalidParameterValueException. Plage valide : 1—31622400.

  • RetentionPeriodInDays : facultatif. Nombre de jours pendant lesquels l'historique des exécutions doit être conservé après la fin d'une exécution durable. Après cette période, l'historique des exécutions n'est plus disponible via l'GetDurableExecutionHistoryAPI. Plage valide : 1 à 90. Par défaut : 14.

  • KMSKeyArn : facultatif. L'ARN d'une clé gérée par le client pour crypter des données d'exécution durables. Pour plus d'informations, consultez la section Chiffrement des données d'exécution durables de Lambda.

Pour la référence complète de l'API, consultez la référence DurableConfig de l'API Lambda.

Bonnes pratiques en matière de configuration

Suivez ces bonnes pratiques lorsque vous configurez des fonctions durables pour une utilisation en production :

  • Définissez des délais d'exécution appropriés  : configurez en ExecutionTimeout fonction de la durée maximale prévue de votre flux de travail. Ne définissez pas de délais d'attente inutilement longs car ils ont une incidence sur l'allocation des coûts et des ressources.

  • Équilibrez la rétention avec les coûts de stockage  : configurez-le RetentionPeriodInDays en fonction de vos exigences en matière de débogage et d'audit. Des périodes de conservation plus longues augmentent les coûts de stockage.

  • Surveillez la taille de l'état  : les objets d'état volumineux augmentent les coûts de stockage et peuvent avoir un impact sur les performances. Gardez l'état minimal et utilisez un stockage externe pour les données volumineuses.

  • Configurez la journalisation appropriée  : activez la journalisation détaillée pour résoudre les problèmes liés aux flux de travail de longue durée, mais tenez compte de l'impact sur le volume et les coûts des journaux.

  • Chiffrez avec votre propre AWS KMS clé — Choisissez KMSKeyArn une clé gérée par le client pour contrôler la rotation des clés, auditer l'accès et répondre aux exigences de conformité. Consultez Chiffrement AWS Lambda données d'exécution durables.

Exemple de configuration de production : 


{
  "ExecutionTimeout": 86400,
  "RetentionPeriodInDays": 7,
  "KMSKeyArn": "arn:aws:kms:us-east-1:111122223333:key/key-id"
}

Cet exemple définit un délai d'exécution de 24 heures (86 400 secondes), une période de rétention de 7 jours et une clé gérée par le client pour le chiffrement.