Mettre à jour des groupes dans AWS Resource Groups

Pour mettre à jour un groupe de ressources basé sur des balises dans Resource Groups, vous pouvez modifier la requête et les balises qui constituent la base de votre groupe. Vous pouvez ajouter et supprimer des ressources de votre groupe uniquement en modifiant la requête ou les balises. Vous ne pouvez pas sélectionner des ressources spécifiques à ajouter ou à supprimer de votre groupe. La meilleure façon d'ajouter ou de supprimer une ressource spécifique d'un groupe est de modifier les balises de la ressource. Vérifiez ensuite que votre requête de balise de groupe de ressources inclut ou omet la balise, selon que vous souhaitez que la ressource fasse partie de votre groupe.

Pour mettre à jour un groupe de ressources AWS CloudFormation basé sur une pile, vous pouvez choisir une autre pile. Vous pouvez également ajouter ou supprimer des types de ressources de la pile que vous souhaitez intégrer au groupe. Pour modifier les ressources qui sont disponibles dans la pile, mettez à jour le modèle AWS CloudFormation utilisé pour créer la pile, puis la pile dans AWS CloudFormation. Pour plus d'informations sur la façon de mettre à jour une AWS CloudFormation pile, consultez les mises à jour AWS CloudFormation des piles dans le Guide de l'AWS CloudFormationutilisateur.

Dans l'AWS CLI, vous mettez à jour les groupes dans deux commandes.

• update-group, que vous exécutez pour mettre à jour la description d'un groupe.

• update-group-query, que vous exécutez pour mettre à jour la requête d'une ressource et les balises qui déterminent les ressources membres du groupe.

Dans la console, vous ne pouvez pas transformer un groupe AWS CloudFormation basé sur une pile en un groupe de requêtes basé sur des balises, ou vice versa. Pour ce faire, utilisez l'API Resource Groups, notamment dans leAWS CLI.

Mettre à jour les groupes de requêtes basés sur les 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 Resource Groups enregistrés, choisissez le nom du groupe, puis choisissez Modifier.

   Note

   Vous ne pouvez mettre à jour que les groupes de ressources que vous possédez. La colonne Propriétaire indique la propriété du compte pour chaque groupe de ressources. Tous les groupes dont le propriétaire du compte n'est pas celui auquel vous êtes connecté ont été créésAWS License Manager. Pour plus d'informations, consultez Groupes de ressources hôte AWS License Manager dans le Guide de l'utilisateur 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, nous ajoutons le type de ressources 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 les balises de groupe, 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. Veillez donc à 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 Aperçu des ressources du groupe pour récupérer la liste mise à jour des instances EC2, 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 l'AWS CLI, vous mettez à jour la requête d'un groupe ainsi que la description d'un groupe de ressources à l'aide de deux commandes. Vous ne pouvez pas modifier un nom de groupe existant. Dans leAWS 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 session de l'AWS CLI, saisissez ce qui suit, puis appuyez sur Enter (Entrée) en remplaçant les valeurs pour le nom et 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.

Mettre à jour un groupe AWS CloudFormation basé sur une pile

Console

Vous ne pouvez pas remplacer un groupe AWS CloudFormation basé sur une pile par un groupe basé sur des balises dans le. AWS Management Console Vous pouvez toutefois modifier la pile sur laquelle le groupe est basé ou modifier les types de ressources de pile que vous souhaitez inclure dans le groupe. 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 Groupes de ressources enregistrés, choisissez le nom du groupe, puis choisissez Modifier.

3. Note

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

4. Sur la page Modifier le groupe, sous Critères de regroupement, pour modifier la pile sur laquelle repose votre groupe, choisissez la pile dans la liste déroulante. Un groupe de ressources peut être basé sur une seule pile. Pour filtrer la liste des piles, commencez par taper le nom de la pile. Seuls les piles avec des états pris en charge apparaissent dans la liste. Pour obtenir une liste des statuts pris en charge, consultez la section Création de groupes basés sur des requêtes dansAWS Resource Groups de ce guide.

5. Ajouter ou supprimer des types de ressources. Seuls les types de ressource qui sont disponibles dans la pile sont affichés dans la liste déroulante. La valeur par défaut est All supported resource types (Tous les types de ressources pris en charge). 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. Pour plus d'informations sur les types de ressources qui sont pris en charge et peuvent faire partie du groupe, consultez Types de ressources que vous pouvez utiliser avec AWS Resource Groups l'éditeur de balises.

6. Choisissez Aperçu des ressources du groupe pour récupérer la liste des ressources de la AWS CloudFormation pile qui correspondent aux types de ressources que vous avez sélectionnés.

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

8. Dans Group tags (Balises de groupe), 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 dans la zone Grouping criteria (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. Veillez donc à 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.

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

AWS CLI & AWS SDKs

Dans l'AWS CLI, vous mettez à jour la requête d'un groupe ainsi que la description d'un groupe de ressources à l'aide de deux commandes. Vous ne pouvez pas modifier un nom de groupe existant. Dans leAWS 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. Exécutez la commande suivante en remplaçant 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-CFN-stack-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, exécutez la commande suivante. Remplacez les valeurs du nom du groupe, de l'identifiant de pile et des types de ressources par les vôtres. Pour ajouter des types de ressources, fournissez la liste complète des types de ressources dans la commande, et pas uniquement les types de ressources que vous ajoutez. Vous pouvez avoir un maximum de 20 types de ressources dans une requête.

   Le stack_identifier est l'ARN de la pile, comme le montre l'exemple de commande.

   $ aws resource-groups update-group-query \
       --group-name resource-group-name \
       --description "description" \
       --resource-query '{"Type":"CLOUDFORMATION_STACK_1_0","Query":"{\"StackIdentifier\":\"stack_identifier\",\"ResourceTypeFilters\":[\"resource_type1\",\"resource_type2\"]}"}'

   Voici un exemple de commande.

   $ aws resource-groups update-group-query \
       --group-name "my-resource-group" \
       --description "Updated CloudFormation stack-based group" \
       --resource-query '{"Type":"CLOUDFORMATION_STACK_1_0","Query":"{\"StackIdentifier\":\"arn:aws:cloudformation:us-west-2:810000000000:stack\/AWStestuseraccount\/fb0d5000-aba8-00e8-aa9e-50d5cEXAMPLE\",\"ResourceTypeFilters\":[\"AWS::EC2::Instance\",\"AWS::S3::Bucket\"]}"}'

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