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.
CreateAlias
Erstellt einen Alias für eine Lambda-Funktionsversion. Verwenden Sie Aliase, um Kunden eine aktualisierbare Funktions-ID zum Aufruf einer anderen Version zur Verfügung zu stellen.
Sie können einen Alias auch so zuordnen, dass die Aufrufe auf zwei Versionen aufgeteilt werden. Verwenden Sie den Parameter RoutingConfig
, um eine zweite Version und den Prozentsatz der Aufrufe für diese Version anzugeben.
Anforderungssyntax
POST /2015-03-31/functions/FunctionName
/aliases HTTP/1.1
Content-type: application/json
{
"Description": "string
",
"FunctionVersion": "string
",
"Name": "string
",
"RoutingConfig": {
"AdditionalVersionWeights": {
"string
" : number
}
}
}
URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
- FunctionName
-
Der Name der Lambda-Funktion.
Name Formate
-
Funktionsname -
MyFunction
. -
Funktion-ARN -
arn:aws:lambda:us-west-2:123456789012:function:MyFunction
. -
Partielle ARN -
123456789012:function:MyFunction
.
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.
- Description
-
Eine Beschreibung des Alias.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge von 0. Maximale Länge beträgt 256 Zeichen.
Erforderlich: Nein
- FunctionVersion
-
Die Funktionsversion, die der Alias aufruft.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 1024 Zeichen.
Pattern:
(\$LATEST|[0-9]+)
Erforderlich: Ja
- Name
-
Der Name des Alias.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.
Pattern:
(?!^[0-9]+$)([a-zA-Z0-9-_]+)
Erforderlich: Ja
- RoutingConfig
-
Die Routing-Konfiguration des Alias.
Typ: AliasRoutingConfiguration Objekt
Erforderlich: Nein
Antwortsyntax
HTTP/1.1 201
Content-type: application/json
{
"AliasArn": "string",
"Description": "string",
"FunctionVersion": "string",
"Name": "string",
"RevisionId": "string",
"RoutingConfig": {
"AdditionalVersionWeights": {
"string" : number
}
}
}
Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP-201-Antwort zurück.
Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.
- AliasArn
-
Der Amazon-Ressourcenname (ARN) des Alias.
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-_]+))?
- Description
-
Eine Beschreibung des Alias.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge von 0. Maximale Länge beträgt 256 Zeichen.
- FunctionVersion
-
Die Funktionsversion, die der Alias aufruft.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 1024 Zeichen.
Pattern:
(\$LATEST|[0-9]+)
- Name
-
Der Name des Alias.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 128 Zeichen.
Pattern:
(?!^[0-9]+$)([a-zA-Z0-9-_]+)
- RevisionId
-
Ein eindeutiger Bezeichner, der sich ändert, wenn Sie den Alias aktualisieren.
Typ: Zeichenfolge
- RoutingConfig
-
Die Routing-Konfiguration des Alias.
Typ: AliasRoutingConfiguration Objekt
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: