Hinzufügen von Ebenen zu 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 erfahren Sie, wie Sie einer Lambda-Funktion eine Ebene hinzufügen. Weitere konzeptionelle Informationen zu Ebenen sowie dazu, warum Sie ggf. welche verwenden sollten, finden Sie unter Verwaltung von Lambda-Abhängigkeiten mit Ebenen.

Bevor Sie eine Lambda-Funktion für die Verwendung einer Ebene konfigurieren können, ist Folgendes erforderlich:

• Verpacken Ihres Ebeneninhalts

• Erstellen einer Ebene in Lambda

• Stellen Sie sicher, dass Sie berechtigt sind, die API GetLayerVersion für die Ebenenversion aufzurufen. Für Funktionen in Ihrem AWS-Konto-Konto muss diese Berechtigung in Ihrer Benutzerrichtlinie enthalten sein. Um eine Ebene in einem anderen Konto zu verwenden, muss der Eigentümer des anderen Kontos Ihrem Konto die Berechtigung in einer ressourcenbasierten Richtlinie erteilen. Beispiele finden Sie unter Gewähren des Lambda-Ebenenzugriffs für andere Konten.

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

Ihre Funktionen können eine beliebige Ebenenversion, die Sie bereits hinzugefügt haben, weiterhin nutzen, auch wenn diese Ebenenversion gelöscht wurde oder Ihnen die Zugriffsberechtigung für die Ebene entzogen wurde. Sie können jedoch keine neue Funktion erstellen, die eine Version einer gelöschten Ebene verwendet.

So fügen Sie eine Ebene zu einer Funktion hinzu

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

2. Wählen Sie die Funktion aus.

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 einen Eintrag 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. ARN angeben: Um eine Ebene 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.

So aktualisieren Sie die Zusammenführungsreihenfolge von Ebenen für Ihre Funktion (Konsole)

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

2. Wählen Sie die zu konfigurierende 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 mit Ihren Funktionen verknüpfte Ebenenversion zu aktualisieren.

So aktualisieren Sie Ebenenversionen für Ihre Funktion (Konsole)

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 Funktionen aus, die Sie ändern möchten, und wählen Sie anschließend Bearbeiten aus.

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

6. Klicken Sie auf Funktionen aktualisieren.

Die Ebenenversionen von Funktionen kann nicht über AWS-Konten hinweg aktualisiert werden.

Suche nach Ebeneninformationen

Verwenden Sie die API ListLayers, um nach Ebenen in Ihrem Konto zu suchen, die mit der Laufzeit Ihrer Funktion kompatibel sind. Sie können z. B. den folgenden list-layers-Befehl der AWS Command Line Interface (CLI) verwenden:

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

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.13"
                ]
            }
        }
    ]
}

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.

Die neueste Version einer Ebene kann auch mithilfe der API ListLayerVersions abgerufen werden. 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"
            ]
        }
    ]
}