Utilisation de balises sur les fonctions Lambda

Vous pouvez étiqueter des fonctions pour organiser et gérer vos ressources. Les balises sont des paires clé-valeur de forme libre associées à vos ressources et prises en charge par l'ensemble des 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 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 le Lambda API 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 AWS Identity and Access Management (IAM) identité (utilisateur, groupe ou rôle) à lire ou à définir des balises sur une ressource, 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 pourGetFunction.

• lambda : TagResource —Accordez cette autorisation à toute personne ayant besoin d'appeler TagResource ou d'exécuter un tag lors de la création.

Pour de plus amples informations, veuillez consulter IAMPolitiques 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 plus d'informations sur la configuration des fonctions, consultezConfiguration des AWS Lambda fonctions.

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 sur le champ de recherche pour afficher la liste des propriétés des fonctions et des clés de balise.

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

4. Sélectionnez Utiliser : « tag-name » pour voir toutes les fonctions étiquetées avec cette touche, ou choisissez un opérateur pour filtrer davantage par valeur.

5. Sélectionnez la valeur de votre balise pour filtrer par une combinaison de clé et de valeur de 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 des ressources Lambda existantes, y compris des fonctions, avec le Lambda. API Vous pouvez également ajouter des balises lors de la création d'une fonction, ce qui vous permet de conserver une ressource étiqueté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 TagResourceet UntagResourceAPI.

Vous pouvez appeler ces opérations à l'aide du AWS CLI. Pour ajouter des balises à une ressource existante, utilisez la tag-resource commande. Cet exemple ajoute deux balises, dont une avec la clé Department et un 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 le tag contenant la clé Department.

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

Ajouter des balises lors de la création d'une fonction

Pour créer une nouvelle fonction Lambda avec des balises, utilisez l'CreateFunctionAPIopération. Spécifiez le paramètre Tags. Vous pouvez appeler cette opération à l'aide de la create-function CLI commande et de l'option --tags. Avant d'utiliser le paramètre tags withCreateFunction, assurez-vous que votre rôle est autorisé à étiqueter les ressources en plus des autorisations habituelles nécessaires pour cette opération. Pour plus d'informations sur les autorisations relatives au balisage, consultezAutorisations requises pour l’utilisation des balises. Cet exemple ajoute deux balises, dont une avec la clé Department et un avec la clé CostCenter.

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

Affichage des balises d’une fonction

Pour afficher les balises appliquées à une ressource Lambda spécifique, utilisez l'ListTagsAPIopération. Pour plus d'informations, consultez ListTags.

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 lors de l'GetFunctionAPIopération. Aucune fonctionnalité comparable n'est disponible pour les autres types de ressources.

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

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

Filtrer les ressources par tag

Vous pouvez utiliser cette AWS Resource Groups Tagging API GetResourcesAPIopération 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 GetResourcesavec 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'utilisationget-resources, voir get-resources dans la référence des AWS CLIcommandes.