Utilisation de balises sur les fonctions Lambda

Vous pouvez étiqueter les fonctions pour organiser et gérer vos ressources. Les balises sont des paires clé-valeur de forme libre associées à vos ressources prises en charge par l’ensemble des ressources Services AWS. Pour plus d’informations sur les cas d’utilisation des balises, consultez Common tagging strategies dans le guide Tagging AWS Resources and Tag Editor.

Les balises s’appliquent au niveau de la fonction, pas aux versions ni aux alias. Les balises ne font pas partie de la configuration spécifique à la version qui fait l'objet d'un instantané par AWS Lambda lorsque vous publiez une version. Vous pouvez utiliser l’API Lambda pour afficher et mettre à jour les balises. Vous pouvez également afficher et mettre à jour les balises tout en gérant une fonction spécifique dans la console Lambda.

Autorisations requises pour l’utilisation des balises

Pour autoriser une identité AWS Identity and Access Management (IAM) – utilisateur, groupe ou rôle – à afficher ou marquer les ressources, accordez-lui les autorisations correspondantes :

• lambda:ListTags : lorsqu’une ressource possède des balises, octroyez cette autorisation à toute personne ayant besoin d’appeler ListTags sur cette ressource. Pour les fonctions balisées, cette autorisation est également nécessaire pour GetFunction.

• lambda:TagResource : octroyez cette autorisation à toute personne qui doit appeler TagResource ou de définir une balise lors de la création.

Vous pouvez également envisager d’octroyer l’autorisation lambda:UntagResource pour autoriser les appels UntagResource à la ressource.

Pour en savoir plus, consultez Politiques IAM basées sur l’identité pour Lambda.

Utilisation des balises avec la console Lambda

Vous pouvez utiliser la console Lambda pour créer des fonctions qui comportent des balises, pour ajouter des balises aux fonctions existantes et pour filtrer des fonctions selon les balises ajoutées.

Ajout de balises lors de la création d’une fonction

1. Ouvrez la page Functions (Fonctions) de la console Lambda.

2. Sélectionnez Create function (Créer une fonction).

3. Choisissez Author from scratch (Créer à partir de zéro) ou Container image (Image de conteneur).

4. Sous Informations de base, configurez votre fonction. Pour de plus amples informations sur la configuration des fonctions, consultez Configuration des fonctions AWS Lambda.

5. Développez Advanced settings (Paramètres avancés) et sélectionnez Enable tags (Activer les balises).

6. Pour cela, choisissez Ajouter une balise, puis saisissez une clé et éventuellement une valeur. Répétez cette étape pour ajouter d’autres balises.

7. Sélectionnez Create function (Créer une fonction).

Pour ajouter des balises à une fonction existante

1. Ouvrez la page Functions (Fonctions) de la console Lambda.

2. Choisissez le nom d’une fonction.

3. Sélectionnez Configuration, puis Tags (Balises).

4. Sous Balises, choisissez Gérer les balises.

5. Pour cela, choisissez Ajouter une balise, puis saisissez une clé et éventuellement une valeur. Répétez cette étape pour ajouter d’autres balises.

6. Choisissez Save (Enregistrer).

Pour filtrer des fonctions avec des balises

1. Ouvrez la page Functions (Fonctions) de la console Lambda.

2. Cliquez dans la zone de recherche pour afficher la liste des propriétés de fonction et des clés de balise.

3. Choisissez une clé de balise pour afficher la liste des valeurs utilisées dans la région AWS actuelle.

4. Sélectionnez Utiliser : « tag-name » pour afficher toutes les fonctions étiquetées avec cette touche, ou choisissez un Opérateur pour affiner le filtrage en fonction de la valeur.

5. Sélectionnez votre valeur de balise pour appliquer un filtre combinant la clé et la valeur de la balise.

La barre de recherche prend également en charge la recherche de clés de balise. Saisissez tag pour afficher uniquement une liste de clés de balise ou entrez le nom d’une clé pour la rechercher dans la liste.

Utilisation des balises avec AWS CLI

Vous pouvez ajouter et supprimer des balises sur les ressources Lambda existantes, fonctions incluses, avec l’API Lambda. Il est également possible d’ajouter des balises lors de la création d’une fonction, vous permettant ainsi de conserver une ressource balisée tout au long de son cycle de vie.

Mise à jour des balises avec les API de balises Lambda

Vous pouvez ajouter des balises aux ressources Lambda prises en charge ou les supprimer au moyen des opérations d’API TagResource et UntagResource.

Vous pouvez appeler ces opérations par l’intermédiaire de l’AWS CLI. Pour ajouter des balises à une ressource existante, utilisez la commande tag-resource. Cet exemple ajoute deux balises, l’une avec la clé Department et l’autre avec la clé CostCenter.

aws lambda tag-resource \
--resource arn:aws:lambda:us-east-2:123456789012:resource-type:my-resource \
--tags Department=Marketing,CostCenter=1234ABCD

Pour supprimer des balises, utilisez la commande untag-resource. Cet exemple supprime la balise dont la clé est Department.

aws lambda untag-resource --resource arn:aws:lambda:us-east-1:123456789012:resource-type:resource-identifier \
--tag-keys Department

Ajout de balises lors de la création d’une fonction

Pour créer une fonction Lambda avec des balises, utilisez l’opération d’API CreateFunction. Spécifiez le paramètre Tags. Vous pouvez appeler cette opération à l’aide de la commande create-function de la CLI associée à l’option --tags. Avant d’utiliser le paramètre tags avec CreateFunction, vérifiez que votre rôle dispose de l’autorisation de baliser les ressources en plus des autorisations habituelles nécessaires à cette opération. Pour plus d’informations sur les autorisations requises pour l’étiquetage, consultez Autorisations requises pour l’utilisation des balises. Cet exemple ajoute deux balises, l’une avec la clé Department et l’autre avec la clé CostCenter.

aws lambda create-function --function-name my-function
--handler index.js --runtime nodejs22.x \
--role arn:aws:iam::123456789012:role/lambda-role \
--tags Department=Marketing,CostCenter=1234ABCD

Affichage des balises d’une fonction

Pour afficher les balises associées à une ressource Lambda spécifique, utilisez l’opération d’API ListTags. Pour plus d’informations, consultez ListTags.

Vous pouvez appeler cette opération à l’aide de la commande list-tags de l’AWS CLI en fournissant un ARN (Amazon Resource Name).

aws lambda list-tags --resource arn:aws:lambda:us-east-1:123456789012:resource-type:resource-identifier

Vous pouvez afficher les balises associées à une ressource spécifique avec l’opération d’API GetFunction. Aucune fonctionnalité comparable n’est disponible pour les autres types de ressources.

Vous pouvez appeler cette opération à l’aide de la commande get-function de la CLI :

aws lambda get-function --function-name my-function

Filtrage de ressources par balise

Vous pouvez utiliser l’opération API AWS Resource Groups Tagging API GetResources pour filtrer vos ressources par balise. L’opération GetResources reçoit jusqu’à 10 filtres, chaque filtre contenant une clé de balise et jusqu’à 10 valeurs de balise. Vous fournissez GetResourcesavec un ResourceType pour filtrer par certains types de ressources.

Vous pouvez appeler cette opération à l’aide de la commande get-resources de l’AWS CLI. Pour des exemples d’utilisation de get-resources, consultez get-resources dans la Référence des commandes de l’AWS CLI.