View a markdown version of this page

Hinzufügen von Ebenen zu Event-Funktionen - AWS Lambda
Suche nach Ebeneninformationen

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.

Hinzufügen von Ebenen zu Event-Funktionen

Eine Lambda-Ebene ist ein ZIP-Dateiarchiv mit ergänzendem Code oder ergänzenden Daten. Ebenen enthalten üblicherweise Bibliotheksabhängigkeiten, eine benutzerdefinierte Laufzeit oder Konfigurationsdateien.

In diesem Abschnitt wird erklärt, wie Sie einer Lambda-Ereignisfunktion eine Ebene hinzufügen. Weitere konzeptionelle Informationen zu Ebenen sowie dazu, warum Sie ggf. welche verwenden sollten, finden Sie unter Verwaltung der Abhängigkeiten von Lambda Event Function mit Ebenen.

Bevor Sie eine Ereignisfunktion für die Verwendung einer Ebene konfigurieren können, müssen Sie:

Sie können einer Event-Funktion bis zu fünf Ebenen hinzufügen. Die entpackte Gesamtgröße der Event Function und aller Ebenen darf das Größenkontingent für das entpackte Bereitstellungspaket von 250 MB nicht überschreiten. Weitere Informationen finden Sie unter Lambda-Kontingente.

Ihre Event-Funktionen können weiterhin jede Layer-Version verwenden, die Sie bereits hinzugefügt haben, auch nachdem diese Layer-Version gelöscht wurde oder nachdem Ihre Zugriffsberechtigung für den Layer widerrufen wurde. Sie können jedoch keine neue Event-Funktion erstellen, die eine gelöschte Layer-Version verwendet.

Um einer Event-Funktion eine Ebene hinzuzufügen

  1. Öffnen Sie die Seite Event Functions der Lambda-Konsole.

  2. Wählen Sie die Event-Funktion.

  3. Blättern Sie nach unten bis zum Abschnitt Ebenen und wählen Sie dann Eine Ebene hinzufügen.

  4. Wählen Sie unter Ebene auswählen eine Ebenenquelle aus:

    1. AWS Ebenen: Wählen Sie aus der Liste der AWS verwalteten Erweiterungen aus.

    2. Benutzerdefinierte Ebenen: Wählen Sie eine Ebene aus, die in Ihrem AWS-Konto erstellt wurde.

    3. Geben Sie einen ARN an: Um einen Layer aus einem anderen AWS-Konto, z. B. einer Drittanbieter-Erweiterung, zu verwenden, geben Sie den Amazon-Ressourcennamen (ARN) ein.

  5. Wählen Sie Hinzufügen aus.

Die Reihenfolge, in der Sie die Ebenen hinzufügen, ist die Reihenfolge, in der Lambda den Ebeneninhalt in der Ausführungsumgebung zusammenführt. Sie können die Reihenfolge für Zusammenführungen der Layers mit der -Konsole ändern.

Um die Reihenfolge der Layer-Zusammenführung für Ihre Event-Funktion (Konsole) zu aktualisieren

  1. Öffnen Sie die Seite Event Functions der Lambda-Konsole.

  2. Wählen Sie die zu konfigurierende Event-Funktion aus.

  3. Wählen Sie unter Ebenen die Option Bearbeiten

  4. Wählen Sie eine der Ebenen aus.

  5. Klicken Sie aufFrüher MergeoderSpäter Zusammenführungenum die Reihenfolge der Ebenen anzupassen.

  6. Wählen Sie Speichern.

Ebenen werden versioniert. Der Inhalt jeder Ebenenversion ist unveränderlich. Der Besitzer einer Ebene kann neue Ebenenversionen veröffentlichen, um aktualisierte Inhalte bereitzustellen. Sie können die Konsole verwenden, um die Layer-Version zu aktualisieren, die Ihren Event-Funktionen zugeordnet ist.

Um Layer-Versionen für Ihre Event-Funktion (Konsole) zu aktualisieren

  1. Öffnen Sie die Seite Ebenen der Lambda-Konsole.

  2. Wählen Sie die Ebene aus, für die Sie die Version aktualisieren möchten.

  3. Wählen Sie die Registerkarte Funktionen mit dieser Version aus.

  4. Wählen Sie die Event-Funktionen aus, die Sie ändern möchten, und klicken Sie dann auf Bearbeiten.

  5. Wählen Sie unter Ebenenversion die Ebenenversion aus, zu der Sie wechseln möchten.

  6. Klicken Sie auf Funktionen aktualisieren.

Sie können die Layer-Versionen der Event-Funktion nicht AWS kontenübergreifend aktualisieren.

Suche nach Ebeneninformationen

Verwenden Sie die ListLayersAPI, um Ebenen in Ihrem Konto zu finden, die mit der Laufzeit Ihrer Event Function kompatibel sind. Sie können beispielsweise den folgenden Befehl list-layers AWS Command Line Interface (CLI) verwenden:

aws lambda list-layers --compatible-runtime python3.14

Die Ausgabe sollte folgendermaßen oder ähnlich aussehen:

{
    "Layers": [
        {
            "LayerName": "my-layer",
            "LayerArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer",
            "LatestMatchingVersion": {
                "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:2",
                "Version": 2,
                "Description": "My layer",
                "CreatedDate": "2025-04-15T00:37:46.592+0000",
                "CompatibleRuntimes": [
                    "python3.14"
                ]
            }
        }
    ]
}

Wenn Sie alle Ebenen in Ihrem Konto auflisten möchten, lassen Sie die Option --compatible-runtime weg. Die Antwortdetails enthalten jeweils die neueste Version der einzelnen Ebenen.

Sie können die neueste Version eines Layers auch mithilfe der ListLayerVersionsAPI abrufen. Sie können z. B. den folgenden CLI-Befehl vom Typ list-layer-versions verwenden:

aws lambda list-layer-versions --layer-name my-layer

Die Ausgabe sollte folgendermaßen oder ähnlich aussehen:

{
    "LayerVersions": [
        {
            "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:2",
            "Version": 2,
            "Description": "My layer",
            "CreatedDate": "2023-11-15T00:37:46.592+0000",
            "CompatibleRuntimes": [
                "java11"
            ]
        },
        {
            "LayerVersionArn": "arn:aws:lambda:us-east-2:123456789012:layer:my-layer:1",
            "Version": 1,
            "Description": "My layer",
            "CreatedDate": "2023-11-15T00:27:46.592+0000",
            "CompatibleRuntimes": [
                "java11"
            ]
        }
    ]
}