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

UpdateFunctionCode

Aktualisiert den Code einer Lambda-Funktion. Wenn die Codesignatur für die Funktion aktiviert ist, muss das Codepaket von einem vertrauenswürdigen Publisher signiert werden. Weitere Informationen finden Sie unter Konfigurieren von Codesignatur für Lambda.

Wenn der Pakettyp der Funktion Image ist, müssen Sie das Codepaket in ImageUri als URI eines Container-Images in der Amazon-ECR-Registry angeben.

Wenn der Pakettyp der Funktion Zip ist, müssen Sie das Bereitstellungspaket als ZIP-Dateiarchiv angeben. Geben Sie den Amazon-S3-Bucket und den Schlüssel des Speicherorts der ZIP-Datei ein. Sie können den Funktionscode auch über das Feld ZipFile einbinden.

Der Code im Bereitstellungspaket muss mit der Ziel-Befehlssatz-Architektur der Funktion (x86-64oderarm64) enthalten.

Der Code der Funktion wird gesperrt, wenn Sie eine Version veröffentlichen. Sie können den Code einer veröffentlichten Version nicht ändern, nur die unveröffentlichte Version.

Anmerkung

Für eine als Container-Image definierte Funktion löst Lambda das Image-Tag in einen Image-Digest auf. Wenn Sie in Amazon ECR das Image-Tag auf ein neues Image aktualisieren, aktualisiert Lambda die Funktion nicht automatisch.

Anforderungssyntax


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

{
   "Architectures": [ "string" ],
   "DryRun": boolean,
   "ImageUri": "string",
   "Publish": boolean,
   "RevisionId": "string",
   "S3Bucket": "string",
   "S3Key": "string",
   "S3ObjectVersion": "string",
   "ZipFile": blob
}

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.

Architectures

Die Befehlssatz-Architektur, die die Funktion unterstützt. Geben Sie ein String-Array mit einem der gültigen Werte ein (arm64 oder x86_64). Der Standardwert ist x86_64.

Typ: Zeichenfolgen-Array

Array-Mitglieder: Feste Anzahl von 1 Element.

Zulässige Werte: x86_64 | arm64

Erforderlich: Nein

DryRun

Auf true setzen, um die Anforderungsparameter und Zugriffsberechtigungen zu validieren, ohne den Funktionscode zu ändern.

Typ: Boolesch

Erforderlich: Nein

ImageUri

URI eines Container-Images in der Amazon ECR-Registrierung. Nicht für eine mit einem ZIP-Dateiarchiv definierte Funktion verwenden.

Typ: Zeichenfolge

Erforderlich: Nein

Publish

Auf true setzen, um nach dem Aktualisieren des Codes eine neue Version der Funktion zu veröffentlichen. Dies hat den gleichen Effekt wie das separate Aufrufen von PublishVersion.

Typ: Boolesch

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

S3Bucket

Ein Amazon-S3-Bucket in derselben AWS-Region wie Ihre Funktion. Der Bucket kann sich in einer anderen AWS-Konto befinden. Nur für eine mit einem ZIP-Dateiarchiv-Bereitstellungspaket definierte Funktion verwenden.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 3. Maximale Länge beträgt 63 Zeichen.

Pattern: ^[0-9A-Za-z\.\-_]*(?<!\.)$

Erforderlich: Nein

S3Key

Der Amazon S3-Schlüssel des Bereitstellungspakets. Nur für eine mit einem ZIP-Dateiarchiv-Bereitstellungspaket definierte Funktion verwenden.

Typ: Zeichenfolge

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

Erforderlich: Nein

S3ObjectVersion

Für versionierte Objekte, die Version des zu verwendenden Bereitstellungspaketobjekts.

Typ: Zeichenfolge

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

Erforderlich: Nein

ZipFile

Der base64-codierte Inhalt des Bereitstellungspakets. AWS SDK und AWS CLI-Clients verarbeiten die Codierung für Sie. Nur für eine mit einem ZIP-Dateiarchiv-Bereitstellungspaket definierte Funktion verwenden.

Typ: Base64-kodiertes Binärdatenobjekt

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

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.

CodeSigningConfigNotFoundException

Die angegebene Codesignaturkonfiguration ist nicht vorhanden.

HTTP Status Code: 404

CodeStorageExceededException

Ihr AWS-Konto hat die maximale Gesamtcodegröße überschritten. Weitere Informationen finden Sie unter Lambda-Kontingente.

HTTP Status Code: 400

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

UpdateEventSourceMapping

UpdateFunctionConfiguration