Mettre à jour les groupes de requêtes basés sur des balises

Les procédures suivantes indiquent comment mettre à jour un groupe de requêtes basé sur des balises.

Console

Mettre à jour un groupe basé sur des balises en modifiant les types de ressources ou des balises dans la requête sur laquelle le groupe est basé. Vous pouvez également ajouter ou modifier la description du groupe.

1. Connectez-vous à la console AWS Resource Groups.

2. Dans le volet de navigation, sous Saved Resource Groups, choisissez le nom du groupe, puis choisissez Edit.

   Note

   Vous ne pouvez mettre à jour que les groupes de ressources dont vous êtes le propriétaire. La colonne Propriétaire indique la propriété du compte pour chaque groupe de ressources. Tous les groupes dont le propriétaire du compte est autre que celui auquel vous êtes connecté ont été créés AWS License Manager. Pour plus d'informations, consultez la section Groupes de ressources Host AWS License Manager dans le Guide de l'utilisateur du License Manager.

3. Sur la page Modifier le groupe, sous Critères de regroupement, ajoutez ou supprimez des types de ressources. Vous pouvez avoir un maximum de 20 types de ressources dans une requête. Pour supprimer un type de ressources, choisissez X sur l'étiquette du type de ressources. Choisissez View group resources (Afficher les ressources du groupe) pour voir en quoi les modifications affectent les ressources membres du groupe. Dans cette procédure pas à pas, nous ajoutons le type de ressource AWS : :RDS : : DBInstance à la requête.

4. Toujours sous Critères de regroupement, modifiez les balises selon vos besoins. Dans cet exemple, nous filtrons les ressources disposant d'une clé de balise Stage (Étape) et ajoutons une valeur de balise Test. La valeur de balise est facultative, mais affine les résultats de la requête. Pour supprimer une balise, choisissez X sur la balise de l'étiquette.

5. Dans Additional information (Informations supplémentaires), vous pouvez modifier la description du groupe. Vous ne pouvez pas modifier un nom du groupe une fois que le groupe a été créé.

6. (Facultatif) Dans Grouper les balises, vous pouvez ajouter ou supprimer des balises. Les balises de groupe sont des métadonnées sur votre groupe de ressources. Elles n'affectent pas les ressources membres. Pour modifier les ressources renvoyées par la requête du groupe de ressources, modifiez les balises situées sous Critères de regroupement.

   Les balises de groupe sont utiles si vous envisagez de faire de ce groupe un membre d'un groupe plus important. La spécification d'au moins une clé de balise est requise pour créer un groupe. Par conséquent, veillez à ajouter au moins une clé de balise dans les balises de groupe aux groupes que vous prévoyez d'imbriquer dans des groupes plus importants.

7. Choisissez Preview group resources pour récupérer la liste mise à jour des EC2 instances, des compartiments S3 et des instances de base de données Amazon RDS de votre compte qui correspondent aux clés de balise spécifiées. Si vous ne voyez pas les ressources que vous attendez dans la liste, veillez à ce qu'elles soient balisées avec des balises que vous avez spécifiées dans la zone Grouping criteria (Critères de regroupement).

8. Lorsque vous avez terminé, choisissez Save changes (Enregistrer les modifications).

AWS CLI & AWS SDKs

Dans le AWS CLI, vous pouvez mettre à jour la requête d'un groupe et mettre à jour la description d'un groupe de ressources à l'aide de deux commandes différentes. Vous ne pouvez pas modifier un nom de groupe existant. Dans le AWS CLI, vous pouvez transformer un groupe basé sur des balises en un groupe basé CloudFormation sur une pile, ou vice versa.

1. Si vous ne souhaitez pas modifier la description de votre groupe, ignorez cette étape et passez à la suivante. Dans une AWS CLI session, tapez ce qui suit, puis appuyez sur Entrée pour remplacer les valeurs du nom et de la description du groupe par les vôtres.

   $ aws resource-groups update-group \
       --group-name resource-group-name \
       --description "description_text"

   Voici un exemple de commande.

   $ aws resource-groups update-group \
       --group-name my-resource-group \
       --description "EC2 instances, S3 buckets, and RDS DBs that we are using for the test stage."

   La commande renvoie une description mise à jour complète du groupe.

2. Pour mettre à jour la requête et les balises d'un groupe, tapez la commande suivante. Remplacez les valeurs du nom du groupe, des types de ressources, des clés de balise et des valeurs de balise par les vôtres. Appuyez ensuite sur Entrée. Vous pouvez avoir un maximum de 20 types de ressources dans une requête.

   $ aws resource-groups update-group-query \
       --group-name resource-group-name \
       --resource-query '{"Type":"TAG_FILTERS_1_0","Query":"{\"ResourceTypeFilters\":[\"resource_type1\",\"resource_type2\"],\"TagFilters\":[{\"Key\":\"Key1\",\"Values\":[\"Value1\",\"Value2\"]},{\"Key\":\"Key2\",\"Values\":[\"Value1\",\"Value2\"]}]}"}'

   Voici un exemple de commande.

   $ aws resource-groups update-group-query \
       --group-name my-resource-group \
       --resource-query '{"Type":"TAG_FILTERS_1_0","Query":"{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\",\"AWS::S3::Bucket\",\"AWS::RDS::DBInstance\"],\"TagFilters\":[{\"Key\":\"Stage\",\"Values\":[\"Test\"]}]}"}'

   La commande renvoie la requête mise à jour comme résultat.