InvokeWithResponseStream

Konfigurieren Sie Ihre Lambda-Funktionen so, dass sie Antwort-Nutzlasten an Clients zurückstreamen. Weitere Informationen finden Sie unter Konfigurieren einer Lambda-Funktion zum Streamen von Antworten.

Diese Operation erfordert die Berechtigung für die Aktion lambda:InvokeFunction . Weitere Informationen zum Einrichten von Berechtigungen für kontoübergreifende Aufrufe finden Sie unter Gewähren des Funktionszugriffs für andere Konten.

Anforderungssyntax

POST /2021-11-15/functions/FunctionName/response-streaming-invocations?Qualifier=Qualifier HTTP/1.1
X-Amz-Invocation-Type: InvocationType
X-Amz-Log-Type: LogType
X-Amz-Client-Context: ClientContext

Payload

URI-Anfrageparameter

Die Anforderung verwendet die folgenden URI-Parameter.

ClientContext

Bis zu 3 583 Byte base64-codierter Daten über den aufrufenden Client, die an die Funktion im Kontextobjekt übergeben werden.

FunctionName

Der Name der Lambda-Funktion.

Name Formate

• Funktionsname – my-function.

• Funktions-ARN – arn:aws:lambda:us-west-2:123456789012:function:my-function.

• Partielle ARN – 123456789012:function:my-function.

Die Längenbeschränkung gilt nur für den gesamten ARN. Wenn Sie nur den Funktionsnamen angeben, ist dieser auf 64 Zeichen begrenzt.

Längenbeschränkungen: Minimale Länge von 1. Höchstlänge = 170 Zeichen.

Pattern: (arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}(-gov)?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?

Erforderlich: Ja

InvocationType

Wählen Sie eine der folgenden Optionen aus:

• RequestResponse (Standard) – Ruft die Funktion synchron auf. Lassen Sie die Verbindung geöffnet, bis die Funktion eine Antwort zurückgibt oder das Zeitlimit überschritten wird. Die API-Operations-Antwort enthält die Funktionsantwort und zusätzliche Daten.

• DryRun – Validieren Sie Parameterwerte und vergewissern Sie sich, dass der IAM-Benutzer oder die IAM-Rolle berechtigt ist, die Funktion aufzurufen.

Zulässige Werte: RequestResponse | DryRun

LogType

Auf Tail setzen, um das Ausführungsprotokoll in die Antwort einzuschließen. Gilt nur für synchron aufgerufene Funktionen.

Zulässige Werte: None | Tail

Qualifier

Der Aliasname.

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.

Pattern: (|[a-zA-Z0-9$_-]+)

Anforderungstext

Die Anfrage akzeptiert die folgenden Binärdaten.

Payload

JSON zum Bereitstellen Ihrer Lambda-Funktion als Eingabe.

Sie können das JSON direkt eingeben. Zum Beispiel --payload '{ "key": "value" }'. Sie können auch einen Dateipfad angeben. Beispiel: --payload file://payload.json

Antwortsyntax

HTTP/1.1 StatusCode
X-Amz-Executed-Version: ExecutedVersion
Content-Type: ResponseStreamContentType
Content-type: application/json

{
   "InvokeComplete": { 
      "ErrorCode": "string",
      "ErrorDetails": "string",
      "LogResult": "string"
   },
   "PayloadChunk": { 
      "Payload": blob
   }
}

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Dienst die folgende HTTP-Antwort zurück.

StatusCode

Bei einer erfolgreichen Anfrage liegt der HTTP-Statuscode im Bereich 200. Für den RequestResponse-Aufruftyp lautet der Statuscode 200. Für den DryRun-Aufruftyp lautet der Statuscode 204.

Die Antwort gibt die folgenden HTTP-Header zurück.

ExecutedVersion

Die Version der Funktion, die gerade ausgeführt wird. Wenn Sie eine Funktion mit einem Alias aufrufen, gibt dies an, in welche Version der Alias aufgelöst wurde.

Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 1024 Zeichen.

Pattern: (\$LATEST|[0-9]+)

ResponseStreamContentType

Die Art der Daten, die der Stream zurückgibt.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

InvokeComplete

Ein Objekt, das zurückgegeben wird, wenn der Stream beendet ist und alle Nutzlast-Teile zurückgegeben wurden.

Typ: InvokeWithResponseStreamCompleteEvent Objekt

PayloadChunk

Ein Teil der Nutzlast der gestreamten Antwort.

Typ: InvokeResponseStreamUpdate Objekt

Fehler

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.

EC2AccessDeniedException

Benötigen Sie zusätzliche Berechtigungen zum Konfigurieren von VPC-Einstellungen.

HTTP-Statuscode: 502

EC2ThrottledException

Amazon EC2 hat AWS Lambda während der Lambda-Funktionsinitialisierung unter Verwendung der für die Funktion bereitgestellten Ausführungsrolle gedrosselt.

HTTP-Statuscode: 502

EC2UnexpectedException

AWS Lambda hat beim Einrichten der Lambda-Funktion eine unerwartete Amazon-EC2-Client-Ausnahme erhalten.

HTTP-Statuscode: 502

EFSIOException

Beim Lesen oder Schreiben in ein angeschlossenes Dateisystem ist ein Fehler aufgetreten.

HTTP-Statuscode: 410

EFSMountConnectivityException

Die Lambda-Funktion konnte keine Netzwerkverbindung zum konfigurierten Dateisystem herstellen.

HTTP-Statuscode: 408

EFSMountFailureException

Die Lambda-Funktion konnte das konfigurierte Dateisystem aufgrund eines Berechtigungs- oder Konfigurationsproblems nicht mounten.

HTTP Status Code: 403

EFSMountTimeoutException

Die Lambda-Funktion hat eine Netzwerkverbindung zum konfigurierten Dateisystem hergestellt, aber beim Mount-Vorgang ist das Zeitlimit überschritten.

HTTP-Statuscode: 408

ENILimitReachedException

AWS Lambda konnte keine Elastic-Network-Schnittstelle in der VPC erstellen, die als Teil der Lambda-Funktionskonfiguration angegeben wurde, da das Limit für Netzwerkschnittstellen erreicht wurde. Weitere Informationen finden Sie unter Lambda-Kontingente.

HTTP-Statuscode: 502

InvalidParameterValueException

Einer der Parameter in der Anfrage ist ungültig.

HTTP Status Code: 400

InvalidRequestContentException

Der Anforderungstext konnte nicht als JSON analysiert werden.

HTTP Status Code: 400

InvalidRuntimeException

Die angegebene Laufzeit oder Laufzeitversion wird nicht unterstützt.

HTTP-Statuscode: 502

InvalidSecurityGroupIDException

Die in der VPC-Konfiguration der Lambda-Funktion angegebene Sicherheitsgruppen-ID ist ungültig.

HTTP-Statuscode: 502

InvalidSubnetIDException

Die in der VPC-Konfiguration der Lambda-Funktion angegebene Subnetz-ID ist ungültig.

HTTP-Statuscode: 502

InvalidZipFileException

AWS Lambda konnte das Bereitstellungspaket nicht entpacken.

HTTP-Statuscode: 502

KMSAccessDeniedException

Lambda konnte die Umgebungsvariablen nicht entschlüsseln, da der AWS KMS-Zugriff verweigert wurde. Überprüfen Sie die KMS-Berechtigungen der Lambda-Funktion.

HTTP-Statuscode: 502

KMSDisabledException

Lambda konnte die Umgebungsvariablen nicht entschlüsseln, da das verwendete AWS KMS key deaktiviert ist. Überprüfen Sie die Einstellungen des KMS-Schlüssels der Lambda-Funktion.

HTTP-Statuscode: 502

KMSInvalidStateException

Lambda konnte die Umgebungsvariablen nicht entschlüsseln, da der Status des verwendeten AWS KMS key für Decrypt nicht gültig ist. Überprüfen Sie die KMS-Schlüsseleinstellungen der Funktion.

HTTP-Statuscode: 502

KMSNotFoundException

Lambda konnte die Umgebungsvariablen nicht entschlüsseln, da AWS KMS key nicht gefunden wurde. Überprüfen Sie die KMS-Schlüsseleinstellungen der Funktion.

HTTP-Statuscode: 502

RecursiveInvocationException

Lambda hat erkannt, dass Ihre Funktion in einer rekursiven Schleife mit anderen AWS-Ressourcen aufgerufen wird, und den Aufruf Ihrer Funktion gestoppt.

HTTP Status Code: 400

RequestTooLargeException

Die Anfragenutzlast hat das JSON-Eingabekontingent des Invoke-Anfragetexts überschritten. Weitere Informationen finden Sie unter Lambda-Kontingente.

HTTP-Statuscode: 413

ResourceConflictException

Die Ressource ist bereits vorhanden, oder ein anderer Vorgang ist im Gange.

HTTP-Statuscode: 409

ResourceNotFoundException

Die in der Anforderung angegebene Ressource ist nicht vorhanden.

HTTP Status Code: 404

ResourceNotReadyException

Die Funktion ist inaktiv und ihre VPC Verbindung ist nicht mehr verfügbar. Warten Sie, bis die VPC Verbindung wieder hergestellt wurde und versuchen Sie es erneut.

HTTP-Statuscode: 502

ServiceException

Beim Service AWS Lambda trat ein interner Fehler auf.

HTTP Status Code: 500

SnapStartException

Beim afterRestore()-Laufzeit-Hook ist ein Fehler aufgetreten. Weitere Informationen finden Sie in den Amazon- CloudWatch Protokollen.

HTTP Status Code: 400

SnapStartNotReadyException

Lambda initialisiert Ihre Funktion. Sie können die Funktion aufrufen, wenn sich der Funktionsstatus auf Active ändert.

HTTP-Statuscode: 409

SnapStartTimeoutException

Lambda konnte den Snapshot nicht innerhalb des Timeout-Limits wiederherstellen.

HTTP-Statuscode: 408

SubnetIPAddressLimitReachedException

AWS Lambda konnte den VPC-Zugriff für die Lambda-Funktion nicht einrichten, da eines oder mehrere konfigurierte Subnetze keine verfügbaren IP-Adressen haben.

HTTP-Statuscode: 502

TooManyRequestsException

Der Durchsatz einer Anforderung wurde überschritten. Weitere Informationen finden Sie unter Lambda-Kontingente.

HTTP-Statuscode: 429

UnsupportedMediaTypeException

Der Inhaltstyp des Invoke-Anforderungstaxts ist nicht JSON.

HTTP-Statuscode: 415

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter:

• AWS-Befehlszeilenschnittstelle

• AWS-SDK für .NET

• AWS-SDK für C++

• AWS-SDK für Go

• AWS-SDK für Java V2

• AWS SDK für JavaScript V3

• AWS-SDK für PHP V3

• AWS-SDK für Python

• AWS-SDK für Ruby V3