aws:invokeLambdaFunction— Invoque une AWS Lambda fonction - AWS Systems Manager

AWS Systems ManagerChange Managern'est plus ouvert aux nouveaux clients. Les clients existants peuvent continuer à utiliser le service normalement. Pour plus d'informations, consultez AWS Systems ManagerChange Managerla section Modification de la disponibilité.

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.

aws:invokeLambdaFunction— Invoque une AWS Lambda fonction

Invoque la AWS Lambda fonction 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.

Note

L’action aws:invokeLambdaFunction prend en charge la limitation des nouvelles tentatives. Pour de plus amples informations, veuillez consulter Configuration des nouvelles tentatives automatiques pour les opérations limitées.

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 : String

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 : String

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 : String

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

Le code 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.

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