View a markdown version of this page

Configura le funzioni durevoli Lambda - AWS Lambda
Abilita un'esecuzione duraturaBest practice per la configurazione

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Configura le funzioni durevoli Lambda

Le impostazioni di esecuzione durevoli controllano per quanto tempo può essere eseguita la AWS Lambda funzione, per quanto tempo il servizio conserva la cronologia di esecuzione e quale AWS KMS chiave crittografa i dati di esecuzione. Configura queste impostazioni per abilitare l'esecuzione duratura della tua funzione.

Abilita un'esecuzione duratura

Configura l'DurableConfigoggetto durante la creazione della funzione per impostare il timeout di esecuzione e la conservazione della cronologia. È possibile abilitare l'esecuzione duratura solo durante la creazione di una funzione. Non è possibile abilitarla su funzioni esistenti.

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"

Parametri di configurazione:

  • ExecutionTimeout— Il tempo massimo, in secondi, di esecuzione di un'esecuzione durevole prima che Lambda interrompa l'esecuzione. Questo timeout si applica all'intera esecuzione duratura, non alle chiamate di singole funzioni. Intervallo valido: 1—31622400.

  • RetentionPeriodInDays— Il numero di giorni in cui conservare la cronologia di esecuzione dopo il completamento di un'esecuzione durevole. Dopo questo periodo, la cronologia delle esecuzioni non è più disponibile tramite l'GetDurableExecutionHistoryAPI. Intervallo valido: 1—90.

  • KMSKeyArn : Opzionale. L'ARN di una chiave gestita dal cliente per crittografare dati di esecuzione durevoli. Per ulteriori informazioni, consulta Encrypting Lambda Durable Execution Data.

Per il riferimento completo all'API, consulta la DurableConfigGuida alle API Lambda.

Best practice per la configurazione

Segui queste best practice per configurare funzioni durevoli per l'uso in produzione:

  • Imposta i timeout di esecuzione appropriati: configura ExecutionTimeout in base alla durata massima prevista del flusso di lavoro. Non impostate timeout inutilmente lunghi poiché influiscono sull'allocazione dei costi e delle risorse.

  • Bilanciate la conservazione con i costi di storage: impostate RetentionPeriodInDays in base ai requisiti di debug e audit. Periodi di conservazione più lunghi aumentano i costi di storage.

  • Monitora le dimensioni dello stato: gli oggetti a stato di grandi dimensioni aumentano i costi di storage e possono influire sulle prestazioni. Riduci al minimo lo stato e utilizza lo storage esterno per dati di grandi dimensioni.

  • Configura la registrazione appropriata: abilita la registrazione dettagliata per la risoluzione dei problemi dei flussi di lavoro a lunga durata, ma considera l'impatto sul volume e sui costi dei log.

  • Crittografa con la tua AWS KMS chiave: imposta una chiave gestita dal cliente KMSKeyArn per controllare la rotazione delle chiavi, verificare l'accesso e soddisfare i requisiti di conformità. Per informazioni, consulta Crittografia AWS Lambda dati di esecuzione durevoli.

Esempio di configurazione di produzione:


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

Questo esempio imposta un timeout di esecuzione di 24 ore (86.400 secondi), un periodo di conservazione di 7 giorni e una chiave gestita dal cliente per la crittografia.