aws:invokeLambdaFunction – appeler une fonction AWS Lambda

Appelle la fonction AWS Lambda spécifiée.

Note

Chaque action aws:invokeLambdaFunction peut être exécutée jusqu'à une durée maximale de 300 secondes (5 minutes). Vous pouvez limiter le délai d'attente en spécifiant le paramètre timeoutSeconds pour une étape aws:invokeLambdaFunction.

Entrée

Cette action prend en charge la plupart des paramètres invoqués du service Lambda. Pour plus d'informations, consultez Invoquer.

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

Nom de la fonction Lambda. Cette fonction doit exister.

Type : chaîne

Obligatoire : oui

Qualificateur

Nom de version ou d'alias de la fonction.

Type : chaîne

Obligatoire : non

InvocationType

Type d'appel. La valeur par défaut est RequestResponse.

Type : chaîne

Valeurs valides : Event | RequestResponse | DryRun

Obligatoire : non

LogType

Si la valeur par défaut est Tail, le type d'appel doit être RequestResponse. Lambda retourne les 4 derniers Ko de données de journalisation générés par votre fonction Lambda, codés en base64.

Type : chaîne

Valeurs valides : None | Tail

Obligatoire : non

ClientContext

Informations spécifiques au client.

Obligatoire : non

InputPayload

Objet JSON ou YAML transmis au premier paramètre du gestionnaire. Utilisez cette saisie pour transmettre des données vers la fonction. Cette entrée offre plus de flexibilité et de prise en charge que l'entrée Payload héritée. Si vous définissez les deux InputPayload et Payload pour l'action, InputPayload prend la priorité et Payload la valeur n'est pas utilisée.

Type : StringMap

Obligatoire : non

Charge utile

Objet JSON ou YAML transmis au premier paramètre du gestionnaire. Utilisez cette saisie pour la transmission des données vers la fonction. Nous vous recommandons d'utiliser InputPayload entrée pour des fonctionnalités supplémentaires.

Type : chaîne

Obligatoire : non

Sortie

StatusCode

Codes d'état HTTP.

FunctionError

Si cette valeur est présente, elle indique qu'une erreur s'est produite lors de l'exécution de la fonction. Les détails sur l'erreur sont inclus dans la charge utile de la réponse.

LogResult

Journaux codés en base 64 pour l'appel de fonction Lambda. Des journaux sont présents uniquement si le type d'appel est RequestResponse et que des journaux ont été demandés.

Charge utile

Représentation JSON de l'objet renvoyé par la fonction Lambda. La charge utile est présente uniquement si le type d'appel est RequestResponse. Jusqu'à 200 Ko sont renvoyés

Ce qui suit est une partie du runbook AWS-PatchInstanceWithRollback démontrant comment référencer les sorties de l'action 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"
      }
    }
  }