Utilisation des balises dans les mappages des sources d’événements

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 mappages des sources d’événements 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 mappages des sources d’événements sont associés à des fonctions, qui peuvent avoir leurs propres balises. Les mappages des sources d’événements n’héritent pas automatiquement des balises des fonctions. Vous pouvez utiliser l' AWS Lambda API pour afficher et mettre à jour les balises. Vous pouvez également afficher et mettre à jour les balises tout en gérant un mappage des sources d’événements 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 mappages de sources d’événements comportant des balises, ajouter des balises aux mappages de sources d’événements existants et filtrer les mappages de sources d’événements par balise.

Lorsque vous ajoutez un déclencheur pour les services basés sur les flux et les files d’attente pris en charge à l’aide de la console Lambda, Lambda crée automatiquement un mappage des sources d’événements. Pour plus d’informations sur ces sources d’événements, consultez Procédure de traitement par Lambda des enregistrements provenant de sources d’événements basées sur des flux et des files d’attente. Pour créer un mappage des sources d’événement dans la console, vous devez disposer des éléments suivants :

Vous pouvez ajouter les balises dans le cadre de l’interface utilisateur que vous utilisez pour créer ou mettre à jour des déclencheurs.

La zone de recherche prend également en charge la recherche de clés de balise. Saisissez 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, mappages de sources d’événéments inclus, avec l’API Lambda. Il est également possible d’ajouter des balises lors de la création d’un mappage des sources d’événements, 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’un mappage des sources d’événements

Pour créer un nouveau mappage de source d'événements Lambda avec des balises, utilisez l'opération CreateEventSourceMappingAPI. Spécifiez le paramètre Tags. Vous pouvez appeler cette opération à l'aide de la create-event-source-mapping AWS CLI commande et de l'--tagsoption. Pour plus d'informations sur la commande CLI, consultez create-event-source-mappingla référence des AWS CLI commandes.

Avant d’utiliser le paramètre Tags avec CreateEventSourceMapping, vérifiez que votre rôle dispose de l’autorisation d’étiqueter 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.

Afficher les tags avec le tag Lambda APIs

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

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.