Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
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.
Sections
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 pourGetFunction
. -
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
Ouvrez la page Functions
(Fonctions) de la console Lambda. -
Sélectionnez Create function (Créer une fonction).
-
Choisissez Author from scratch (Créer à partir de zéro) ou Container image (Image de conteneur).
-
Sous Informations de base, configurez votre fonction. Pour de plus amples informations sur la configuration des fonctions, consultez Configuration des fonctions AWS Lambda.
-
Développez Advanced settings (Paramètres avancés) et sélectionnez Enable tags (Activer les balises).
-
Pour cela, choisissez Ajouter une balise, puis saisissez une clé et éventuellement une valeur. Répétez cette étape pour ajouter d’autres balises.
-
Sélectionnez Create function (Créer une fonction).
Pour ajouter des balises à une fonction existante
Ouvrez la page Functions
(Fonctions) de la console Lambda. -
Choisissez le nom d’une fonction.
-
Sélectionnez Configuration, puis Tags (Balises).
-
Sous Balises, choisissez Gérer les balises.
-
Pour cela, choisissez Ajouter une balise, puis saisissez une clé et éventuellement une valeur. Répétez cette étape pour ajouter d’autres balises.
-
Choisissez Save (Enregistrer).
Pour filtrer des fonctions avec des balises
Ouvrez la page Functions
(Fonctions) de la console Lambda. -
Cliquez dans la zone de recherche pour afficher la liste des propriétés de fonction et des clés de balise.
-
Choisissez une clé de balise pour afficher la liste des valeurs utilisées dans la région AWS actuelle.
-
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.
-
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
\ --tagsDepartment
=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-keysDepartment
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 GetResources
avec 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