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.
PublishVersion
Erstellt eine Version aus dem aktuellen Code und der Konfiguration einer Funktion. Verwenden Sie Versionen, um einen Snapshot Ihres Funktionscodes und Ihrer Konfiguration zu erstellen, der sich nicht ändert.
AWS Lambda veröffentlicht keine Version, wenn sich die Konfiguration und der Code der Funktion seit der letzten Version nicht geändert haben. Verwenden Sie UpdateFunctionCode oder UpdateFunctionConfiguration, um die Funktion zu aktualisieren, bevor Sie eine Version veröffentlichen.
Clients können Versionen direkt oder mit einem Alias aufrufen. Um einen Alias zu erstellen, verwenden Sie CreateAlias.
Anforderungssyntax
POST /2015-03-31/functions/FunctionName
/versions HTTP/1.1
Content-type: application/json
{
"CodeSha256": "string
",
"Description": "string
",
"RevisionId": "string
"
}
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.
- CodeSha256
-
Veröffentlichen Sie eine Version nur, wenn der Hash-Wert mit dem angegebenen Wert übereinstimmt. Verwenden Sie diese Option, um das Veröffentlichen einer Version zu vermeiden, wenn sich der Funktionscode seit der letzten Aktualisierung geändert hat. Sie können den Hash für die Version, die Sie hochgeladen haben, aus der Ausgabe von UpdateFunctionCode abrufen.
Typ: Zeichenfolge
Erforderlich: Nein
- Description
-
Eine Beschreibung für die Version, die die Beschreibung in der Funktionskonfiguration überschreibt.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge von 0. Maximale Länge beträgt 256 Zeichen.
Erforderlich: Nein
- RevisionId
-
Aktualisieren Sie die Funktion nur, wenn die Revisions-ID mit der angegebenen ID übereinstimmt. Verwenden Sie diese Option, um das Veröffentlichen einer Version zu vermeiden, wenn sich die Funktionskonfiguration seit der letzten Aktualisierung geändert hat.
Typ: Zeichenfolge
Erforderlich: Nein
Antwortsyntax
HTTP/1.1 201
Content-type: application/json
{
"Architectures": [ "string" ],
"CodeSha256": "string",
"CodeSize": number,
"DeadLetterConfig": {
"TargetArn": "string"
},
"Description": "string",
"Environment": {
"Error": {
"ErrorCode": "string",
"Message": "string"
},
"Variables": {
"string" : "string"
}
},
"EphemeralStorage": {
"Size": number
},
"FileSystemConfigs": [
{
"Arn": "string",
"LocalMountPath": "string"
}
],
"FunctionArn": "string",
"FunctionName": "string",
"Handler": "string",
"ImageConfigResponse": {
"Error": {
"ErrorCode": "string",
"Message": "string"
},
"ImageConfig": {
"Command": [ "string" ],
"EntryPoint": [ "string" ],
"WorkingDirectory": "string"
}
},
"KMSKeyArn": "string",
"LastModified": "string",
"LastUpdateStatus": "string",
"LastUpdateStatusReason": "string",
"LastUpdateStatusReasonCode": "string",
"Layers": [
{
"Arn": "string",
"CodeSize": number,
"SigningJobArn": "string",
"SigningProfileVersionArn": "string"
}
],
"LoggingConfig": {
"ApplicationLogLevel": "string",
"LogFormat": "string",
"LogGroup": "string",
"SystemLogLevel": "string"
},
"MasterArn": "string",
"MemorySize": number,
"PackageType": "string",
"RevisionId": "string",
"Role": "string",
"Runtime": "string",
"RuntimeVersionConfig": {
"Error": {
"ErrorCode": "string",
"Message": "string"
},
"RuntimeVersionArn": "string"
},
"SigningJobArn": "string",
"SigningProfileVersionArn": "string",
"SnapStart": {
"ApplyOn": "string",
"OptimizationStatus": "string"
},
"State": "string",
"StateReason": "string",
"StateReasonCode": "string",
"Timeout": number,
"TracingConfig": {
"Mode": "string"
},
"Version": "string",
"VpcConfig": {
"Ipv6AllowedForDualStack": boolean,
"SecurityGroupIds": [ "string" ],
"SubnetIds": [ "string" ],
"VpcId": "string"
}
}
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.
- Architectures
-
Die Befehlssatz-Architektur, die die Funktion unterstützt. Die Architektur ist ein String-Array mit einem der gültigen Werte. Der Standardarchitektur ist
x86_64
aus.Typ: Zeichenfolgen-Array
Array-Mitglieder: Feste Anzahl von 1 Element.
Zulässige Werte:
x86_64 | arm64
- CodeSha256
-
Der SHA256-Hashwert des Bereitstellungspakets der Funktion.
Typ: Zeichenfolge
- CodeSize
-
Die Größe des Bereitstellungspakets der Funktion in Bytes.
Type: Long
- DeadLetterConfig
-
Die Warteschlange der Funktion für unzustellbare Nachrichten.
Typ: DeadLetterConfig Objekt
- Description
-
Die Beschreibung der Funktion.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge von 0. Maximale Länge beträgt 256 Zeichen.
- Environment
-
Umgebungsvariablen der Funktion. Ausgelassen von AWS CloudTrail-Protokollen.
Typ: EnvironmentResponse Objekt
- EphemeralStorage
-
Die Größe des
/tmp
-Verzeichnisses der Funktion in MB. Der Standardwert ist 512, kann aber jede ganze Zahl zwischen 512 und 10 240 MB sein. Weitere Informationen finden Sie unter Flüchtigen Speicher konfigurieren (Konsole).Typ: EphemeralStorage Objekt
- FileSystemConfigs
-
Verbindungseinstellungen für ein Amazon-EFS-Dateisystem.
Typ: Array von FileSystemConfig-Objekten
Array-Mitglieder: Maximale Anzahl von 1 Element.
- 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-_]+))?
- FunctionName
-
Der Name der Funktion.
Typ: Zeichenfolge
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-_]+))?
- Handler
-
Die Funktion, die Lambda aufruft, um mit der Ausführung Ihrer Funktion zu beginnen.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.
Pattern:
[^\s]+
- ImageConfigResponse
-
Die Konfigurationswerte des Funktionsimages.
Typ: ImageConfigResponse Objekt
- KMSKeyArn
-
Der AWS KMS key, der zum Verschlüsseln der Umgebungsvariablen der Funktion verwendet wird. Wenn Lambda SnapStart aktiviert ist, wird dieser Schlüssel auch verwendet, um den Snapshot der Funktion zu verschlüsseln. Dieser Schlüssel wird nur zurückgegeben, wenn Sie einen vom Kunden verwalteten Schlüssel konfiguriert haben.
Typ: Zeichenfolge
Pattern:
(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()
- LastModified
-
Datum und Uhrzeit der letzten Aktualisierung der Funktion im ISO-8601-Format
(JJJJ-MM-TTThh:mm:ss.sTZD). Typ: Zeichenfolge
- LastUpdateStatus
-
Der Status der letzten Aktualisierung, die für die Funktion ausgeführt wurde. Dies wird zuerst auf
Successful
gesetzt, nachdem die Funktionserstellung abgeschlossen ist.Typ: Zeichenfolge
Zulässige Werte:
Successful | Failed | InProgress
- LastUpdateStatusReason
-
Der Grund für die letzte Aktualisierung, die für die Funktion durchgeführt wurde.
Typ: Zeichenfolge
- LastUpdateStatusReasonCode
-
Der Ursachencode für die letzte Aktualisierung, die für die Funktion durchgeführt wurde.
Typ: Zeichenfolge
Zulässige Werte:
EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError
- Layers
-
Die Ebenen der Funktion.
Typ: Array von Layer-Objekten
- LoggingConfig
-
Die Amazon- CloudWatch Logs-Konfigurationseinstellungen der Funktion.
Typ: LoggingConfig Objekt
- MasterArn
-
Bei Lambda@Edge-Funktionen der ARN der Hauptfunktion.
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-_]+))?
- MemorySize
-
Die Menge des für die Funktion zur Laufzeit verfügbaren Speichers.
Typ: Ganzzahl
Gültiger Bereich: Mindestwert 128. Maximaler Wert von 10240.
- PackageType
-
Der Typ des Bereitstellungspakets. Setzen Sie den Wert auf
Image
für ein Container-Image oder aufZip
für ein ZIP-Dateiarchiv.Typ: Zeichenfolge
Zulässige Werte:
Zip | Image
- RevisionId
-
Die zuletzt aktualisierte Version der Funktion oder des Alias.
Typ: Zeichenfolge
- Role
-
Die Ausführungsrolle der Funktion.
Typ: Zeichenfolge
Pattern:
arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+
- Runtime
-
Die ID der Laufzeit der Funktion. Die Laufzeit ist erforderlich, wenn das Bereitstellungspaket ein ZIP-Dateiarchiv ist.
Die folgende Liste enthält abgelaufene Laufzeiten. Weitere Informationen finden Sie in der Richtlinie für den Laufzeitablauf.
Typ: Zeichenfolge
Zulässige Werte:
nodejs | nodejs4.3 | nodejs6.10 | nodejs8.10 | nodejs10.x | nodejs12.x | nodejs14.x | nodejs16.x | java8 | java8.al2 | java11 | python2.7 | python3.6 | python3.7 | python3.8 | python3.9 | dotnetcore1.0 | dotnetcore2.0 | dotnetcore2.1 | dotnetcore3.1 | dotnet6 | nodejs4.3-edge | go1.x | ruby2.5 | ruby2.7 | provided | provided.al2 | nodejs18.x | python3.10 | java17 | ruby3.2 | python3.11 | nodejs20.x | provided.al2023 | python3.12 | java21
- RuntimeVersionConfig
-
Der ARN der Laufzeit und alle aufgetretenen Fehler.
Typ: RuntimeVersionConfig Objekt
- SigningJobArn
-
Der ARN des signierenden Auftrags.
Typ: Zeichenfolge
Pattern:
arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)
- SigningProfileVersionArn
-
Der ARN der Signierungsprofilversion.
Typ: Zeichenfolge
Pattern:
arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)
- SnapStart
-
Legen Sie
ApplyOn
aufPublishedVersions
fest, um beim Veröffentlichen einer Funktionsversion einen Snapshot der initialisierten Ausführungsumgebung zu erstellen. Weitere Informationen finden Sie unter Verbesserung der Startleistung mit Lambda SnapStart.Typ: SnapStartResponse Objekt
- State
-
Der aktuelle Status der Funktion. Wenn der Zustand
Inactive
ist, können Sie die Funktion durch Aufrufen reaktivieren.Typ: Zeichenfolge
Zulässige Werte:
Pending | Active | Inactive | Failed
- StateReason
-
Der Grund für den aktuellen Status der Funktion.
Typ: Zeichenfolge
- StateReasonCode
-
Der Ursachencode für den aktuellen Status der Funktion. Wenn der Code
Creating
ist, können Sie die Funktion nicht aufrufen oder ändern.Typ: Zeichenfolge
Zulässige Werte:
Idle | Creating | Restoring | EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError
- Timeout
-
Die Zeitspanne in Sekunden, die Lambda zur Ausführung einer Funktion zulässt, bevor diese gestoppt wird.
Typ: Ganzzahl
Gültiger Bereich: Mindestwert 1.
- TracingConfig
-
Die AWS X-Ray-Nachverfolgungskonfiguration der Funktion.
Typ: TracingConfigResponse Objekt
- Version
-
Die Version der Lambda-Funktion.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 1024 Zeichen.
Pattern:
(\$LATEST|[0-9]+)
- VpcConfig
-
Die Netzwerkkonfiguration der Funktion.
Typ: VpcConfigResponse Objekt
Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.
- CodeStorageExceededException
-
Ihr AWS-Konto hat die maximale Gesamtcodegröße überschritten. Weitere Informationen finden Sie unter Lambda-Kontingente.
HTTP Status Code: 400
- InvalidParameterValueException
-
Einer der Parameter in der Anfrage ist ungültig.
HTTP Status Code: 400
- PreconditionFailedException
-
Das RevisionId bereitgestellte stimmt nicht mit dem neuesten RevisionId für die Lambda-Funktion oder den Alias überein. Rufen Sie die
GetFunction
oder dieGetAlias
-API-Operation auf, um das neueste RevisionId für Ihre Ressource abzurufen.HTTP-Statuscode: 412
- 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: