aws:invokeLambdaFunction— Invoca una funzione AWS Lambda - AWS Systems Manager

AWS Systems ManagerChange Managernon è più aperto a nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta AWS Systems ManagerChange Managerla pagina Modifica della disponibilità.

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

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

Input

Questa operazione supporta la maggior parte dei parametri richiamati per il servizio Lambda. Per ulteriori informazioni, consulta Invoke (Chiamata).

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

Campo obbligatorio: sì

Qualificatore

Versione o nome alias della funzione.

▬Tipo: stringa

Campo obbligatorio: no

InvocationType

Tipi di chiamata. Il valore predefinito è RequestResponse.

▬Tipo: stringa

Valori validi: Event | RequestResponse | DryRun

Campo 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: stringa

Valori validi: None | Tail

Campo obbligatorio: no

ClientContext

Informazioni specifiche del client.

Campo 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

Campo 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

Campo obbligatorio: no

Output
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"
      }
    }
  }