Utilisation de balises sur les mappages de sources d'événements - AWS Lambda
Autorisations requises pour l’utilisation des balisesUtilisation des étiquettes avec la consoleUtilisation de balises avec AWS CLI

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 mappages de sources d'événements

Vous pouvez baliser les mappages de 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 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 mappages de sources d'événements sont associés à des fonctions, qui peuvent avoir leurs propres balises. Les mappages de sources d'événements n'héritent pas automatiquement des balises des fonctions. Vous pouvez utiliser le 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 de source d'événement 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 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 de source d'événements. Pour plus d'informations sur ces sources d'événements, consultezComment Lambda traite les 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énements dans la console, vous devez remplir les conditions préalables suivantes :

  • Une fonction .

  • Une source d'événement provenant d'un service concerné.

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

Pour ajouter une balise lors de la création d'un mappage de sources d'événements

  1. Ouvrez la page Functions (Fonctions) de la console Lambda.

  2. Choisissez le nom de votre fonction .

  3. Sous Function overview (Vue d'ensemble de la fonction), choisissez Add trigger (Ajouter un déclencheur).

  4. Sous Configuration du déclencheur, dans la liste déroulante, choisissez le nom du service dont provient la source de votre événement.

  5. Fournissez la configuration de base de votre source d'événements. Pour plus d'informations sur la configuration de votre source d'événements, consultez la section relative au service correspondant dansInvoquer Lambda avec des événements provenant d'autres services AWS.

  6. Sous Configuration du mappage des sources d'événements, sélectionnez Paramètres supplémentaires.

  7. Sous Balises, choisissez Ajouter une nouvelle étiquette

  8. Dans le champ Clé, entrez la clé de votre tag. Pour plus d'informations sur les restrictions relatives au balisage, consultez la section Limites et exigences relatives au nommage des balises dans le Guide des AWS ressources de balisage et de l'éditeur de balises.

  9. Choisissez Ajouter.

Pour ajouter des balises à un mappage de source d'événement existant

  1. Ouvrez les mappages de sources d'événements dans la console Lambda.

  2. Dans la liste des ressources, choisissez le UUIDmappage de source d'événement correspondant à votre fonction et à votre source d'événement ARN.

  3. Dans la liste d'onglets située sous le volet de configuration générale, choisissez Tags.

  4. Choisissez Gérer les balises.

  5. Choisissez Add new tag (Ajouter une nouvelle balise).

  6. Dans le champ Clé, entrez la clé de votre tag. Pour plus d'informations sur les restrictions relatives au balisage, consultez la section Limites et exigences relatives au nommage des balises dans le Guide des AWS ressources de balisage et de l'éditeur de balises.

  7. Choisissez Save (Enregistrer).

Pour filtrer les mappages de sources d'événements par balise

  1. Ouvrez les mappages de sources d'événements dans la console Lambda.

  2. Choisissez le champ de recherche.

  3. Dans la liste déroulante, sélectionnez votre clé de tag sous le sous-titre Tags.

  4. Sélectionnez Utiliser : « tag-name » pour voir tous les mappages de sources d'événements marqués avec cette clé, 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.

Le champ de recherche permet également de rechercher des clés de balise. Entrez le nom d'une clé pour la retrouver dans la liste.

Utilisation de balises avec AWS CLI

Vous pouvez ajouter et supprimer des balises sur les ressources Lambda existantes, y compris les mappages de sources d'événements, avec le Lambda. API Vous pouvez également ajouter des balises lors de la création d'un mappage de sources d'événements, 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

Ajout de balises lors de la création d'un mappage de sources d'événements

Pour créer un nouveau mappage de source d'événements Lambda avec des balises, utilisez l'CreateEventSourceMappingAPIopération. 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 CLI commande, reportez-vous create-event-source-mappingà la référence des AWS CLI commandes.

Avant d'utiliser le Tags paramètre withCreateEventSourceMapping, 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.

Afficher les tags avec le tag Lambda APIs

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

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.