Ajouter des couches aux fonctions événementielles

Une couche Lambda est une archive de fichier .zip qui contient du code ou des données supplémentaires. Les couches contiennent généralement des dépendances de bibliothèque, une exécution personnalisée, ou des fichiers de configuration.

Cette section explique comment ajouter une couche à une fonction d'événement Lambda. Pour plus d’informations conceptuelles sur les couches et les raisons pour lesquelles vous pourriez envisager de les utiliser, consultez Gestion des dépendances des fonctions d'événement Lambda à l'aide de couches.

Avant de configurer une fonction d'événement pour utiliser une couche, vous devez :

• Empaqueter le contenu de votre couche

• Créer une couche dans Lambda

• Assurez-vous que vous êtes autorisé à appeler l'GetLayerVersionAPI sur la version de la couche. Pour les fonctions événementielles de votre Compte AWS, vous devez disposer de cette autorisation dans votre politique utilisateur. Pour utiliser une couche dans un autre compte, le propriétaire de ce compte doit accorder l’autorisation à votre compte dans une stratégie basée sur les ressources. Pour obtenir des exemples, consultez Octroi de l’accès de la couche Lambda à d’autres comptes.

Vous pouvez ajouter jusqu'à cinq couches à une fonction d'événement. La taille totale décompressée de la fonction d'événement et de toutes les couches ne peut pas dépasser le quota de taille du package de déploiement décompressé de 250 Mo. Pour plus d’informations, consultez Quotas Lambda.

Vos fonctions événementielles peuvent continuer à utiliser n'importe quelle version de couche que vous avez déjà ajoutée, même après la suppression de cette version de couche ou après la révocation de votre autorisation d'accès à la couche. Cependant, vous ne pouvez pas créer une nouvelle fonction d'événement qui utilise une version de couche supprimée.

Pour ajouter une couche à une fonction d'événement

1. Ouvrez la page Event Functions de la console Lambda.

2. Choisissez la fonction d'événement.

3. Faites défiler jusqu’à la section Couches, puis choisissez Ajouter une couche.

4. Sous Choisir une couche, choisissez une source de couche :

   1. AWS couches : choisissez dans la liste des extensions AWS gérées.

   2. Couches personnalisées : choisissez une couche créée dans votre Compte AWS.

   3. Spécifiez un ARN : pour utiliser une couche provenant d'une autre couche Compte AWS, telle qu'une extension tierce, entrez le Amazon Resource Name (ARN).

5. Choisissez Ajouter.

L’ordre dans lequel vous ajoutez les couches correspond à l’ordre dans lequel Lambda fusionne ultérieurement le contenu de la couche dans l’environnement d’exécution. Vous pouvez modifier l’ordre de fusion des couches à l’aide de la console.

Pour mettre à jour l'ordre de fusion des couches pour votre fonction d'événement (console)

1. Ouvrez la page Event Functions de la console Lambda.

2. Choisissez la fonction d'événement à configurer.

3. Sous Layers (Couches), choisissez Edit (Modifier).

4. Choisissez l’une des couches.

5. Choisissez Merge earlier (Fusionner plus tôt) ou Merge later (Fusionner plus tard) pour ajuster l’ordre des couches.

6. Cliquez sur Enregistrer.

Les couches sont versionnées. Le contenu de chaque version de couche est immuable. Le propriétaire d’une couche peut publier une nouvelle version de la couche pour fournir du contenu mis à jour. Vous pouvez utiliser la console pour mettre à jour la version de couche attachée à vos fonctions d'événement.

Pour mettre à jour les versions des couches pour votre fonction d'événement (console)

1. Ouvrez la page Couches de la console Lambda.

2. Choisissez la couche pour laquelle vous voulez mettre à jour la version.

3. Choisissez l’onglet Fonctions utilisant cette version.

4. Choisissez les fonctions d'événement que vous souhaitez modifier, puis choisissez Modifier.

5. Pour Version de la couche, choisissez la version de la couche à modifier.

6. Choisissez Update functions (Mettre à jour les fonctions).

Vous ne pouvez pas mettre à jour les versions de la couche Event Function entre AWS les comptes.

Recherche d’informations sur la couche

Pour trouver dans votre compte des couches compatibles avec le runtime de votre fonction d'événement, utilisez l'ListLayersAPI. Par exemple, vous pouvez utiliser la commande list-layers ( AWS Command Line Interface CLI) suivante :

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

Vous devez voir des résultats similaires à ce qui suit :

{
    "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"
                ]
            }
        }
    ]
}

Pour répertorier toutes les couches de votre compte, ignorez l’option --compatible-runtime. Les détails de la réponse indiquent la dernière version de chaque couche.

Vous pouvez également obtenir la dernière version d'une couche à l'aide de l'ListLayerVersionsAPI. Par exemple, vous pouvez utiliser la commande CLI list-layer-versions suivante :

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

Vous devez voir des résultats similaires à ce qui suit :

{
    "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"
            ]
        }
    ]
}