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

UpdateFunctionConfiguration

Ändert die versionsspezifischen Einstellungen einer Lambda-Funktion.

Wenn Sie eine Funktion aktualisieren, stellt Lambda eine Instance der Funktion und ihrer unterstützenden Ressourcen bereit. Wenn Ihre Funktion eine Verbindung zu einer VPC herstellt, kann dieser Vorgang eine Minute dauern. Während dieser Zeit können Sie die Funktion nicht ändern, aber Sie können Sie immer noch aufrufen. Die LastUpdateStatus-, LastUpdateStatusReason- undLastUpdateStatusReasonCode-Felder in der Antwort von GetFunctionConfiguration geben an, wann die Aktualisierung abgeschlossen ist und die Funktion verabeitet Ereignisse mit der neuen Konfiguration. Weitere Informationen erhalten Sie unter Lambda-Funktions-Status.

Diese Einstellungen können zwischen Versionen einer Funktion variieren und werden gesperrt, wenn Sie eine Version veröffentlichen. Sie können die Konfiguration einer veröffentlichten Version nicht ändern, nur die unveröffentlichte Version.

Um die Parallelität der Funktion zu konfigurieren, verwenden Sie PutFunctionConcurrency. Um einem AWS-Konto oder einem AWS-Service eine Berechtigung zu erteilen, verwenden Sie AddPermission.

Anforderungssyntax


PUT /2015-03-31/functions/FunctionName/configuration HTTP/1.1
Content-type: application/json

{
   "DeadLetterConfig": { 
      "TargetArn": "string"
   },
   "Description": "string",
   "Environment": { 
      "Variables": { 
         "string" : "string" 
      }
   },
   "EphemeralStorage": { 
      "Size": number
   },
   "FileSystemConfigs": [ 
      { 
         "Arn": "string",
         "LocalMountPath": "string"
      }
   ],
   "Handler": "string",
   "ImageConfig": { 
      "Command": [ "string" ],
      "EntryPoint": [ "string" ],
      "WorkingDirectory": "string"
   },
   "KMSKeyArn": "string",
   "Layers": [ "string" ],
   "LoggingConfig": { 
      "ApplicationLogLevel": "string",
      "LogFormat": "string",
      "LogGroup": "string",
      "SystemLogLevel": "string"
   },
   "MemorySize": number,
   "RevisionId": "string",
   "Role": "string",
   "Runtime": "string",
   "SnapStart": { 
      "ApplyOn": "string"
   },
   "Timeout": number,
   "TracingConfig": { 
      "Mode": "string"
   },
   "VpcConfig": { 
      "Ipv6AllowedForDualStack": boolean,
      "SecurityGroupIds": [ "string" ],
      "SubnetIds": [ "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

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

DeadLetterConfig

Eine Warteschlangenkonfiguration für unzustellbare Nachrichten, die die Warteschlange oder das Thema angibt, an das Lambda asynchrone Ereignisse sendet, wenn deren Verarbeitung fehlschlägt. Weitere Informationen finden Sie unter Warteschlangen für unzustellbare Nachrichten.

Typ: DeadLetterConfig Objekt

Erforderlich: Nein

Description

Eine Beschreibung der Funktion.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 0. Maximale Länge beträgt 256 Zeichen.

Erforderlich: Nein

Environment

Umgebungsvariablen, auf die während der Ausführung von Funktionscode zugegriffen werden kann.

Typ: Environment Objekt

Erforderlich: Nein

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

Erforderlich: Nein

FileSystemConfigs

Verbindungseinstellungen für ein Amazon EFS-Dateisystem.

Typ: Array von FileSystemConfig-Objekten

Array-Mitglieder: Maximale Anzahl von 1 Element.

Erforderlich: Nein

Handler

Der Name der Methode innerhalb Ihres Codes, die Lambda aufruft, um Ihre Funktion auszuführen. Der Handler ist erforderlich, wenn das Bereitstellungspaket ein ZIP-Dateiarchiv ist. Das Format beinhaltet den Dateinamen. Es kann außerdem Namenspaces und andere Qualifier beinhalten (abhängig von der Laufzeitumgebung). Weitere Informationen finden Sie unter Lambda-Programmiermodell.

Typ: Zeichenfolge

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

Pattern: [^\s]+

Erforderlich: Nein

ImageConfig

Container-Image-Konfigurationswerte, die die Werte in der Container-Image-Docker-Datei überschreiben.

Typ: ImageConfig Objekt

Erforderlich: Nein

KMSKeyArn

Der ARN des AWS Key Management Service (AWS KMS) kundenverwalteten Schlüssels, der zur Verschlüsselung der Umgebungsvariablen Ihrer Funktion verwendet wird. Wenn Lambda SnapStart aktiviert ist, verwendet Lambda diesen Schlüssel auch, um den Snapshot Ihrer Funktion zu verschlüsseln. Wenn Sie Ihre Funktion mithilfe eines Container-Images bereitstellen, verwendet Lambda diesen Schlüssel auch, um Ihre Funktion bei der Bereitstellung zu verschlüsseln. Beachten Sie, dass dies nicht derselbe Schlüssel ist, der zum Schutz Ihres Container-Images in Amazon Elastic Container Registry (Amazon ECR) verwendet wird. Wenn kein ARN angegeben wird, verwendet Lambda einen Standard-Serviceschlüssel.

Typ: Zeichenfolge

Pattern: (arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()

Erforderlich: Nein

Layers

Eine Liste mit -Funktionsebenen, die der Ausführungsumgebung der Funktion hinzugefügt werden sollen. Geben Sie jeden Layer über dessen ARN an (einschließlich der Version).

Typ: Zeichenfolge-Array

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

Pattern: arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+:[0-9]+

Erforderlich: Nein

LoggingConfig

Die Amazon- CloudWatch Logs-Konfigurationseinstellungen der Funktion.

Typ: LoggingConfig Objekt

Erforderlich: Nein

MemorySize

Die Menge des für die Funktion zur Laufzeit verfügbaren Speichers. Wenn Sie die für die Funktion verfügbare Menge an Arbeitsspeicher erhöhen, erhöht sich auch die CPU-Zuweisung. Der Standardwert lautet 128 MB. Der Wert kann ein beliebiges Vielfaches von 1 MB sein.

Typ: Ganzzahl

Gültiger Bereich: Mindestwert 128. Maximaler Wert von 10240.

Erforderlich: Nein

RevisionId

Aktualisieren Sie die Richtlinie nur, wenn die Revisions-ID mit der angegebenen ID übereinstimmt. Verwenden Sie diese Option, um das Ändern einer Funktion zu vermeiden, die sich seit der letzten Lesung geändert hat.

Typ: Zeichenfolge

Erforderlich: Nein

Role

Der Amazon-Ressourcenname (ARN) der Ausführungsrolle der Funktion.

Typ: Zeichenfolge

Pattern: arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+

Erforderlich: Nein

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

Erforderlich: Nein

SnapStart

Die SnapStart Einstellung der Funktion.

Typ: SnapStart Objekt

Erforderlich: Nein

Timeout

Die Zeitspanne (in Sekunden), die Lambda zur Ausführung einer Funktion zulässt, bevor diese gestoppt wird. Standardmäßig ist ein Zeitraum von 3 Sekunden festgelegt. Der maximal zulässige Wert beträgt 900 Sekunden. Weitere Informationen finden Sie unter Lambda-Ausführungsumgebung.

Typ: Ganzzahl

Gültiger Bereich: Mindestwert 1.

Erforderlich: Nein

TracingConfig

Legen Sie Mode auf Active fest, um eine Teilmenge der eingehenden Anforderungen mit X-Ray zu erfassen und zu verfolgen.

Typ: TracingConfig Objekt

Erforderlich: Nein

VpcConfig

Geben Sie für die Netzwerkkonnektivität mit AWS-Ressourcen in einer VPC eine Liste der Sicherheitsgruppen und Subnetze in der VPC an. Wenn Sie eine Funktion mit einer VPC verbinden, kann sie nur über diese VPC auf Ressourcen und das Internet zugreifen. Weitere Informationen finden Sie unter Konfigurieren einer Lambda-Funktion für den Zugriff auf Ressourcen in einer VPC.

Typ: VpcConfig Objekt

Erforderlich: Nein

Antwortsyntax


HTTP/1.1 200
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 200-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

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.

CodeSigningConfigNotFoundException

Die angegebene Codesignaturkonfiguration ist nicht vorhanden.

HTTP Status Code: 404

CodeVerificationFailedException

Bei der Codesignatur ist eine oder mehrere der Validierungsüberprüfungen auf Nichtübereinstimmung oder Ablauf der Signatur fehlgeschlagen und die Codesignierrichtlinie ist auf ENFORCE festgelegt. Lambda blockiert die Bereitstellung.

HTTP Status Code: 400

InvalidCodeSignatureException

Die Integritätsprüfung der Codesignatur ist fehlgeschlagen. Wenn die Integritätsprüfung fehlschlägt, blockiert Lambda die Bereitstellung, selbst wenn die Codesignatur-Richtlinie auf WARN festgelegt ist.

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

UpdateFunctionCode

UpdateFunctionEventInvokeConfig