Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
PutFunctionEventInvokeConfig
Konfiguriert Optionen für den asynchronen Aufruf für eine Funktion, Version oder einen Alias. Wenn bereits eine Konfiguration für eine Funktion, eine Version oder einen Alias existiert, überschreibt diese Operation sie. Wenn Sie Einstellungen ausschließen, werden sie entfernt. Um eine Option festzulegen, ohne die vorhandenen Einstellungen für andere Optionen zu beeinflussen, verwenden Sie UpdateFunctionEventInvokeConfig.
Standardmäßig wiederholt Lambda einen asynchronen Aufruf zweimal, wenn die Funktion einen Fehler zurückgibt. Es speichert Ereignisse in einer Warteschlange für bis zu sechs Stunden. Wenn bei einem Ereignis alle Verarbeitungsversuche fehlschlagen oder es zu lange in der asynchronen Aufrufwarteschlange bleibt, verwirft Lambda es. Um verworfene Ereignisse beizubehalten, konfigurieren Sie eine Warteschlange für unzustellbare Nachrichten mit UpdateFunctionConfiguration.
Um einen Aufrufdatensatz an eine Warteschlange, ein Thema, eine Funktion oder einen Event Bus zu senden, geben Sie ein Ziel an. Sie können separate Ziele für erfolgreiche Aufrufe (bei Erfolg) und Ereignisse konfigurieren, bei denen alle Verarbeitungsversuche fehlschlagen (bei Fehler). Sie können Ziele zusätzlich oder anstelle einer Warteschlange für unzustellbare Nachrichten konfigurieren.
Anforderungssyntax
PUT /2019-09-25/functions/FunctionName
/event-invoke-config?Qualifier=Qualifier
HTTP/1.1
Content-type: application/json
{
"DestinationConfig": {
"OnFailure": {
"Destination": "string
"
},
"OnSuccess": {
"Destination": "string
"
}
},
"MaximumEventAgeInSeconds": number
,
"MaximumRetryAttempts": number
}
URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
- FunctionName
-
Der Name der Lambda-Funktion, der Version oder des Alias.
Name Formate
-
Funktionsname –
my-function
(nur Name),my-function:v1
(mit Alias). -
Funktion-ARN -
arn:aws:lambda:us-west-2:123456789012:function:my-function
. -
Partielle ARN -
123456789012:function:my-function
.
Sie können an jedes der Formate eine Versionsnummer oder einen Alias anhängen. 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. Maximale Länge beträgt 140 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
-
- Qualifier
-
Eine Versionsnummer oder der Aliasname.
Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 128 Zeichen.
Pattern:
(|[a-zA-Z0-9$_-]+)
Anforderungstext
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
- DestinationConfig
-
Ein Ziel für Ereignisse, nachdem sie an eine Funktion zur Verarbeitung gesendet wurden.
Ziele
-
Funktion - Der Amazon-Ressourcenname (ARN) einer Lambda-Funktion.
-
Warteschlange – Der ARN einer SQS-Standardwarteschlange.
-
Thema – Der ARN eines SNS-Standardthemas.
-
Event Bus – Der ARN eines Amazon EventBridge Event Bus.
Typ: DestinationConfig Objekt
Erforderlich: Nein
-
- MaximumEventAgeInSeconds
-
Das maximale Alter einer Anforderung, die Lambda an eine Funktion zur Verarbeitung sendet.
Typ: Ganzzahl
Gültiger Bereich: Mindestwert 60. Maximaler Wert von 21600.
Erforderlich: Nein
- MaximumRetryAttempts
-
Die maximale Anzahl der Wiederholungen, wenn die Funktion einen Fehler zurückgibt.
Typ: Ganzzahl
Gültiger Bereich: Mindestwert 0. Maximaler Wert von 2.
Erforderlich: Nein
Antwortsyntax
HTTP/1.1 200
Content-type: application/json
{
"DestinationConfig": {
"OnFailure": {
"Destination": "string"
},
"OnSuccess": {
"Destination": "string"
}
},
"FunctionArn": "string",
"LastModified": number,
"MaximumEventAgeInSeconds": number,
"MaximumRetryAttempts": number
}
Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.
Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.
- DestinationConfig
-
Ein Ziel für Ereignisse, nachdem sie an eine Funktion zur Verarbeitung gesendet wurden.
Ziele
-
Funktion - Der Amazon-Ressourcenname (ARN) einer Lambda-Funktion.
-
Warteschlange – Der ARN einer SQS-Standardwarteschlange.
-
Thema – Der ARN eines SNS-Standardthemas.
-
Event Bus – Der ARN eines Amazon EventBridge Event Bus.
Typ: DestinationConfig Objekt
-
- FunctionArn
-
Der Amazon-Ressourcenname (ARN) der Funktion.
Typ: Zeichenfolge
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-_]+))?
- LastModified
-
Datum und Uhrzeit, zu dem die Konfiguration zuletzt aktualisiert wurde, in Unix-Zeitsekunden.
Typ: Zeitstempel
- MaximumEventAgeInSeconds
-
Das maximale Alter einer Anforderung, die Lambda an eine Funktion zur Verarbeitung sendet.
Typ: Ganzzahl
Gültiger Bereich: Mindestwert 60. Maximaler Wert von 21600.
- MaximumRetryAttempts
-
Die maximale Anzahl der Wiederholungen, wenn die Funktion einen Fehler zurückgibt.
Typ: Ganzzahl
Gültiger Bereich: Mindestwert 0. Maximaler Wert von 2.
Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.
- InvalidParameterValueException
-
Einer der Parameter in der Anfrage ist ungültig.
HTTP Status Code: 400
- 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
- ServiceException
-
Beim Service AWS Lambda trat ein interner Fehler auf.
HTTP Status Code: 500
- TooManyRequestsException
-
Der Durchsatz einer Anforderung wurde überschritten. Weitere Informationen finden Sie unter Lambda-Kontingente.
HTTP-Statuscode: 429
Weitere Informationen finden Sie auch unter:
Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: