Utilisation de balises sur les fonctions Lambda

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.

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.

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 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.

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 :

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.

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.

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 TagResourceet de l'UntagResourceAPI.

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 CreateFunctionAPI. 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 de plus amples informations, veuillez consulter 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 à l'aide de l'opération GetFunctiond'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 GetResourcesAPI 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’utilisation de get-resources, consultez get-resources dans la Référence des commandes de l’AWS  CLI.