

• La AWS Systems Manager CloudWatch dashboard non sarà più disponibile dopo il 30 aprile 2026. I clienti possono continuare a utilizzare la CloudWatch console Amazon per visualizzare, creare e gestire le proprie CloudWatch dashboard Amazon, proprio come fanno oggi. Per ulteriori informazioni, consulta la [documentazione di Amazon CloudWatch Dashboard](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

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à.

# `aws:invokeLambdaFunction`— Invoca una funzione AWS Lambda
<a name="automation-action-lamb"></a>

Richiama la funzione specificata. AWS Lambda 

**Nota**  
Ogni operazione `aws:invokeLambdaFunction` può durare al massimo 300 secondi (5 minuti). Puoi limitare il timeout specificando il parametro `timeoutSeconds` per una fase `aws:invokeLambdaFunction`.

**Nota**  
L'azione `aws:invokeLambdaFunction` supporta un nuovo tentativo di limitazione (della larghezza di banda della rete) automatico. Per ulteriori informazioni, consulta [Configurazione della ripetizione dei tentativi automatica per le operazioni di limitazione (della larghezza di banda della rete)](automation-throttling-retry.md).

**Input**  
Questa operazione supporta la maggior parte dei parametri richiamati per il servizio Lambda. Per ulteriori informazioni, consulta [Invoke (Chiamata)](https://docs.aws.amazon.com/lambda/latest/dg/API_Invoke.html).

------
#### [ YAML ]

```
name: invokeMyLambdaFunction
action: aws:invokeLambdaFunction
maxAttempts: 3
timeoutSeconds: 120
onFailure: Abort
inputs:
  FunctionName: MyLambdaFunction
```

------
#### [ JSON ]

```
{
    "name": "invokeMyLambdaFunction",
    "action": "aws:invokeLambdaFunction",
    "maxAttempts": 3,
    "timeoutSeconds": 120,
    "onFailure": "Abort",
    "inputs": {
        "FunctionName": "MyLambdaFunction"
    }
}
```

------

FunctionName  
Il nome della funzione Lambda. Questa funzione deve esistere.  
Tipo: stringa  
Obbligatorio: sì

Qualificatore  
Versione o nome alias della funzione.  
▬Tipo: stringa  
Obbligatorio: no

InvocationType  
Tipi di chiamata. Il valore predefinito è `RequestResponse`.  
Tipo: String  
Valori validi: `Event` \$1 `RequestResponse` \$1 `DryRun`  
Obbligatorio: no

LogType  
Se il valore predefinito è `Tail`, il tipo di chiamata deve essere `RequestResponse`. Lambda restituisce gli ultimi 4 KB di dati di log prodotti dalla funzione Lambda, con codifica base64  
Tipo: String  
Valori validi: `None` \$1 `Tail`  
Obbligatorio: no

ClientContext  
Informazioni specifiche del client.  
Obbligatorio: no

InputPayload  
Un oggetto YAML o JSON che viene passato al primo parametro del gestore. Questo input può essere utilizzato per passare i dati alla funzione. Questo input offre maggiore flessibilità e supporto rispetto all'input `Payload` legacy. Se vengono definiti sia `InputPayload` che `Payload` per l'operazione, `InputPayload` ha la precedenza e il valore `Payload` non viene utilizzato.  
Tipo: StringMap  
Obbligatorio: no

Carico utile  
Una stringa JSON che viene passata al primo parametro del gestore. Questo può essere utilizzato per passare i dati di input alla funzione. Consigliamo di utilizzare l'input `InputPayload` per funzionalità aggiuntive.  
▬Tipo: stringa  
Obbligatorio: noOutput

StatusCode  
Codice di stato HTTP .

FunctionError  
Se presente, indica che si è verificato un errore durante l'esecuzione della funzione. I dettagli sull'errore sono inclusi nel payload di risposta.

LogResult  
I log di codifica base64 per la chiamata della funzione Lambda. I log sono presenti solo se il tipo di chiamata è `RequestResponse` e sono stati richiesti i log.

Carico utile  
Rappresentazione JSON dell'oggetto restituito dalla funzione Lambda. Il payload è presente solo se il tipo di chiamata è `RequestResponse`.

Di seguito è riportata una parte del runbook `AWS-PatchInstanceWithRollback` che dimostra come fare riferimento agli output dall'operazione `aws:invokeLambdaFunction`.

------
#### [ YAML ]

```
- name: IdentifyRootVolume
  action: aws:invokeLambdaFunction
  inputs:
    FunctionName: "IdentifyRootVolumeLambda-{{automation:EXECUTION_ID}}"
    Payload: '{"InstanceId": "{{InstanceId}}"}'
- name: PrePatchSnapshot
  action: aws:executeAutomation
  inputs:
    DocumentName: "AWS-CreateSnapshot"
    RuntimeParameters:
      VolumeId: "{{IdentifyRootVolume.Payload}}"
      Description: "ApplyPatchBaseline restoration case contingency"
```

------
#### [ JSON ]

```
{
    "name": "IdentifyRootVolume",
    "action": "aws:invokeLambdaFunction",
    "inputs": {
      "FunctionName": "IdentifyRootVolumeLambda-{{automation:EXECUTION_ID}}",
      "Payload": "{\"InstanceId\": \"{{InstanceId}}\"}"
    }
  },
  {
    "name": "PrePatchSnapshot",
    "action": "aws:executeAutomation",
    "inputs": {
      "DocumentName": "AWS-CreateSnapshot",
      "RuntimeParameters": {
        "VolumeId": "{{IdentifyRootVolume.Payload}}",
        "Description": "ApplyPatchBaseline restoration case contingency"
      }
    }
  }
```

------