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 la section [Stratégies de balisage courantes dans le guide des AWS](https://docs.aws.amazon.com//tag-editor/latest/userguide/best-practices-and-strats.html#tag-strategies) *ressources de balisage et de l'éditeur de balises*.
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 AWS Lambda crée un instantané du moment où 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.
**Topics**
+ [Autorisations requises pour l’utilisation des balises](#fxn-tags-required-permissions)
+ [Utilisation des balises avec la console Lambda](#using-tags-with-the-console)
+ [Utilisation de balises avec AWS CLI](#configuration-tags-cli)
## Autorisations requises pour l’utilisation des balises
Pour autoriser une identité Gestion des identités et des accès AWS (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, accordez cette autorisation à tous ceux qui ont besoin de `ListTags` l'utiliser. Pour les fonctions balisées, cette autorisation est également nécessaire pour `GetFunction`.
+ **lambda : TagResource** —Accordez cette autorisation à toute personne ayant besoin d'appeler `TagResource` ou d'exécuter un tag lors de la création.
Vous pouvez éventuellement envisager d'accorder également l'UntagResourceautorisation **lambda :** pour autoriser les `UntagResource` appels à la ressource.
Pour de plus amples informations, veuillez consulter [Politiques IAM basées sur l’identité pour Lambda](access-control-identity-based.md).
## 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](https://console.aws.amazon.com/lambda/home#/functions) (Fonctions) de la console Lambda.
1. Choisissez **Créer une fonction**.
1. Choisissez **Author from scratch** (Créer à partir de zéro) ou **Container image** (Image de conteneur).
1. Sous **Informations de base**, configurez votre fonction. Pour de plus amples informations sur la configuration des fonctions, consultez [Configuration des AWS Lambda fonctions](lambda-functions.md).
1. Développez **Advanced settings** (Paramètres avancés) et sélectionnez **Enable tags** (Activer les balises).
1. Pour cela, choisissez **Ajouter une balise**, puis saisissez une **clé** et éventuellement une **valeur**. Répétez cette étape pour ajouter d’autres balises.
1. Choisissez **Créer une fonction**.
**Pour ajouter des balises à une fonction existante**
1. Ouvrez la [page Functions](https://console.aws.amazon.com/lambda/home#/functions) (Fonctions) de la console Lambda.
1. Choisissez le nom d’une fonction.
1. Sélectionnez **Configuration**, puis **Tags (Balises)**.
1. Sous **Balises**, choisissez **Gérer les balises**.
1. Pour cela, choisissez **Ajouter une balise**, puis saisissez une **clé** et éventuellement une **valeur**. Répétez cette étape pour ajouter d’autres balises.
1. Choisissez **Enregistrer**.
**Pour filtrer des fonctions avec des balises**
1. Ouvrez la [page Functions](https://console.aws.amazon.com/lambda/home#/functions) (Fonctions) de la console Lambda.
1. Cliquez dans la zone de recherche pour afficher la liste des propriétés de fonction et des clés de balise.
1. Choisissez une clé de balise pour afficher la liste des valeurs utilisées dans la AWS région actuelle.
1. 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.
1. 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 de 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 la balise Lambda APIs
Vous pouvez ajouter et supprimer des balises pour les ressources Lambda prises en charge par le biais des opérations [TagResource](https://docs.aws.amazon.com/lambda/latest/api/API_TagResource.html)et de l'[UntagResource](https://docs.aws.amazon.com/lambda/latest/api/API_UntagResource.html)API.
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 contenant la clé*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 nouvelle fonction Lambda avec des balises, utilisez l'opération [CreateFunction](https://docs.aws.amazon.com//lambda/latest/api/API_CreateFunction.html)API. 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](#fxn-tags-required-permissions). 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 nodejs24.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 de plus amples informations, veuillez consulter [ListTags](https://docs.aws.amazon.com/lambda/latest/api/API_ListTags.html).
Vous pouvez appeler cette opération à l'aide de la `list-tags` AWS CLI commande 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 appliquées à une ressource spécifique à l'aide de l'opération [GetFunction](https://docs.aws.amazon.com/lambda/latest/api/API_GetFunction.html)d'API. 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 le fonctionnement de l' AWS Resource Groups Tagging API [GetResources](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/API_GetResources.html)API pour filtrer vos ressources par balises. 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 `get-resources` AWS CLI commande. Pour des exemples d’utilisation de `get-resources`, consultez [get-resources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resourcegroupstaggingapi/get-resources.html#examples) dans la *Référence des commandes de l’AWS CLI*.