Anforderungssyntax URI-Anfrageparameter Anforderungstext Antwortsyntax Antwortelemente Fehler Weitere Informationen finden Sie auch unter:

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 istx86_64aus.

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

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 auf Zip 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

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 auf PublishedVersions 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

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 die GetAlias -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:

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

PublishLayerVersion

PutFunctionCodeSigningConfig