aws:invokeLambdaFunction – Aufrufen einer AWS Lambda-Funktion

Ruft die angegebene AWS Lambda-Funktion auf.

Anmerkung

Jede aws:invokeLambdaFunction-Aktion kann bis zu einer maximalen Dauer von 300 Sekunden (5 Minuten) laufen. Sie können die Zeitüberschreitung über den Parameter timeoutSeconds für einen aws:invokeLambdaFunction-Schritt limitieren.

Eingabe

Diese Aktion unterstützt die meisten aufgerufenen Parameter für den Lambda-Service. Weitere Informationen finden Sie unter Aufrufen.

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

Der Name der Lambda-Funktion. Diese Funktion muss vorhanden sein.

Typ: Zeichenfolge

Erforderlich: Ja

Qualifier

Die Version oder der Aliasname der Funktion.

Typ: Zeichenfolge

Required: No

InvocationType

Der Aufruftyp. Der Standardwert ist RequestResponse.

Typ: Zeichenfolge

Zulässige Werte: Event | RequestResponse | DryRun

Required: No

LogType

Wenn der Standardwert Tail ist, muss der Aufruftyp RequestResponse sein. Lambda gibt die letzten 4 KB von Protokolldaten mit base64 verschlüsselt zurück, die von Ihrer Lambda-Funktion vorliegen.

Typ: Zeichenfolge

Zulässige Werte: None | Tail

Required: No

ClientContext

Die Client-spezifischen Informationen.

Required: No

InputPayload

Ein YAML- oder JSON-Objekt, das an den ersten Parameter des Handlers übergeben wird. Sie können diese Eingabe verwenden, um Daten an die Funktion zu übergeben. Diese Eingabe bietet mehr Flexibilität und Unterstützung als die Legacy-Payload-Eingabe. Wenn Sie sowohl InputPayload als auch Payload für die Aktion definieren, hat InputPayload Vorrang, und der Payload-Wert wird nicht verwendet.

Typ: StringMap

Required: No

Nutzlast

Eine JSON-Zeichenfolge, die an den ersten Parameter des Handlers übergeben wird. Dies kann verwendet werden, um Eingabedaten an die Funktion zu übergeben. Wir empfehlen die Verwendung der InputPayload-Eingabe für zusätzliche Funktionen.

Typ: Zeichenfolge

Required: No

Ausgabe

StatusCode

Der HTTP-Statuscodes.

FunctionError

Falls vorhanden, weist es darauf hin, dass währen der Ausführung der Funktion ein Fehler aufgetreten ist. Fehlerdetails sind in der Antwortnutzlast enthalten.

LogResult

Die mit base64 verschlüsselten Protokolle zum Aufrufen der Lambda-Funktion. Protokolle sind nur dann vorhanden, wenn der Aufrufen-Typ RequestResponse ist und die Protokolle angefragt wurden.

Nutzlast

Die JSON-Darstellung des Objekts, das von der Lambda-Funktion zurückgegeben wird. Die Nutzlast ist nur vorhanden, wenn der Aufrufen-Typ RequestResponse ist. Bis zu 200 KB werden zurückgegeben.

Das Folgende ist ein Teil des AWS-PatchInstanceWithRollback-Runbooks, der zeigt, wie auf Ausgaben der aws:invokeLambdaFunction-Aktion verwiesen wird.

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