PutRuntimeManagementConfig - AWS Lambda
AnforderungssyntaxURI-AnfrageparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie auch unter:

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.

PutRuntimeManagementConfig

Legt die Konfiguration der Laufzeitverwaltung für die Version einer Funktion fest. Weitere Informationen finden Sie unter Laufzeit-Aktualisierungen.

Anforderungssyntax

PUT /2021-07-20/functions/FunctionName/runtime-management-config?Qualifier=Qualifier HTTP/1.1
Content-type: application/json

{
   "RuntimeVersionArn": "string",
   "UpdateRuntimeOn": "string"
}

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

Qualifier

Version der Funktion angeben. Dies kann $LATEST oder eine veröffentlichte Versionsnummer sein. Wenn kein Wert angegeben ist, wird die Konfiguration für die $LATEST-Version zurückgegeben.

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

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

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

RuntimeVersionArn

Der ARN der Laufzeitversion, die die Funktion verwenden soll.

Anmerkung

Dies ist nur erforderlich, wenn Sie den manuellen Laufzeit-Aktualisierungsmodus verwenden.

Typ: Zeichenfolge

Längenbeschränkungen: Mindestlänge von 26. Maximale Länge beträgt 2048 Zeichen.

Pattern: ^arn:(aws[a-zA-Z-]*):lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}::runtime:.+$

Erforderlich: Nein

UpdateRuntimeOn

Geben Sie den Laufzeit-Aktualisierungsmodus an.

  • Automatisch (Standard) – Aktualisieren Sie automatisch auf die neueste und sicherste Laufzeitversion mit einer zweiphasigen Einführung von Laufzeitversionen. Dies ist für die meisten Kunden die beste Wahl, um sicherzustellen, dass sie immer von Laufzeit-Aktualisierungen profitieren.

  • Funktion aktualisieren – Bei der Aktualisierung Ihrer Funktion aktualisiert Lambda die Laufzeit Ihrer Funktion auf die neueste und sicherste Laufzeitversion. Bei diesem Ansatz werden die Laufzeitaktualisierungen mit der Funktionsbereitstellung synchronisiert. So haben Sie die Kontrolle darüber, wann Laufzeitaktualisierungen angewendet werden, und können seltene Inkompatibilitäten bei Laufzeitaktualisierungen frühzeitig erkennen und beheben. Wenn Sie diese Einstellung verwenden, müssen Sie Ihre Funktionen regelmäßig aktualisieren, um ihre Laufzeit beizubehalten up-to-date.

  • Manuell – Sie geben in Ihrer Funktionskonfiguration eine Laufzeitversion an. Die Funktion wird diese Laufzeitversion auf unbestimmte Zeit verwenden. In dem seltenen Fall, dass eine neue Laufzeitversion nicht mit einer vorhandenen Funktion kompatibel ist, können Sie hiermit Ihre Funktion auf eine frühere Laufzeitversion zurücksetzen. Weitere Informationen finden Sie unter Zurücksetzen einer Laufzeitversion.

Typ: Zeichenfolge

Zulässige Werte: Auto | Manual | FunctionUpdate

Erforderlich: Ja

Antwortsyntax

HTTP/1.1 200
Content-type: application/json

{
   "FunctionArn": "string",
   "RuntimeVersionArn": "string",
   "UpdateRuntimeOn": "string"
}

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.

FunctionArn

Der 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-_]+))?

RuntimeVersionArn

Der ARN der Laufzeitumgebung, die die Funktion verwenden soll. Wenn der Laufzeitaktualisierungsmodus manuell ist, wird der ARN zurückgegeben, andernfalls wird null zurückgegeben.

Typ: Zeichenfolge

Längenbeschränkungen: Mindestlänge von 26. Maximale Länge beträgt 2048 Zeichen.

Pattern: ^arn:(aws[a-zA-Z-]*):lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}::runtime:.+$

UpdateRuntimeOn

Der Laufzeit-Aktualisierungsmodus.

Typ: Zeichenfolge

Zulässige Werte: Auto | Manual | FunctionUpdate

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: