PutFunctionConcurrency
Legt die maximale Anzahl gleichzeitiger Ausführungen für eine Funktion fest und reserviert Kapazität für diese Parallelitätsebene.
Parallelitätseinstellungen gelten für die Funktion als Ganzes, einschließlich aller veröffentlichten Versionen und der unveröffentlichten Version. Das Reservieren der Parallelität stellt sowohl sicher, dass Ihre Funktion die angegebene Anzahl von Ereignissen gleichzeitig verarbeiten kann, als auch verhindert, dass sie über diese Ebene hinaus skaliert wird. Verwenden Sie GetFunction, um die aktuelle Einstellung für eine Funktion anzuzeigen.
Verwenden Sie GetAccountSettings, um Ihr regionales Parallelitätslimit anzuzeigen. Sie können die Parallelität für beliebig viele Funktionen reservieren, solange Sie mindestens 100 gleichzeitige Ausführungen für Funktionen, die nicht mit einer Beschränkung pro Funktion konfiguriert sind, nicht reserviert lassen. Weitere Informationen erhalten Sie unter Skalierung von Lambda-Funktionen.
Anforderungssyntax
PUT /2017-10-31/functions/FunctionName/concurrency HTTP/1.1
Content-type: application/json
{
"ReservedConcurrentExecutions": number
}URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
- 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. 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
-
Anforderungstext
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
- ReservedConcurrentExecutions
-
Die Anzahl der gleichzeitigen Ausführungen, die für die Funktion reserviert werden sollen.
Typ: Ganzzahl
Gültiger Bereich: Mindestwert 0.
Erforderlich: Ja
Antwortsyntax
HTTP/1.1 200
Content-type: application/json
{
"ReservedConcurrentExecutions": 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.
- ReservedConcurrentExecutions
-
Die Anzahl der gleichzeitigen Ausführungen, die für diese Funktion reserviert sind. Weitere Informationen finden Sie unter Verwaltung der reservierten Lambda-Gleichzeitigkeit.
Typ: Ganzzahl
Gültiger Bereich: Mindestwert 0.
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 unter:
Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter:
