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.
# Mettre à jour des groupes dans Groupes de ressources AWS
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 dans 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 soit incluse dans votre groupe.
Pour mettre à jour un groupe de ressources CloudFormation basé sur une pile, vous pouvez choisir une autre pile. Vous pouvez également ajouter ou supprimer des types de ressources de la pile dont vous souhaitez faire partie du groupe. Pour modifier les ressources disponibles dans la pile, mettez à jour le CloudFormation modèle utilisé pour créer la pile, puis mettez à jour la pile CloudFormation. Pour plus d'informations sur la mise à jour d'une CloudFormation pile, consultez la section [Mises à jour CloudFormation des piles](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks.html) dans le *Guide de CloudFormation l'utilisateur*.
Dans le AWS CLI, vous mettez à jour les groupes à l'aide de 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 CloudFormation basé sur une pile en un groupe de requêtes basé sur des balises, ou vice versa. Toutefois, vous pouvez le faire en utilisant l'API Resource Groups, notamment dans le AWS CLI.
# 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 Groupes de ressources AWS](https://console.aws.amazon.com/resource-groups).
1. Dans le volet de navigation, sous **[Saved Resource Groups](https://console.aws.amazon.com/resource-groups/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](https://docs.aws.amazon.com//license-manager/latest/userguide/host-resource-groups.html) le *Guide de l'utilisateur du License Manager*.
1. 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.
1. 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.
1. 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éé.
1. (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.
1. Choisissez **Preview group resources** 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)**.
1. Lorsque vous avez terminé, choisissez **Save changes** (Enregistrer les modifications).
------
#### [ AWS CLI & AWS SDKs ]
Dans le AWS CLI, vous mettez à jour la requête d'un groupe et 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.
1. 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 CloudFormation basé sur une pile
Les procédures suivantes indiquent comment mettre à jour un groupe CloudFormation basé sur une pile.
------
#### [ Console ]
Vous ne pouvez pas remplacer un groupe CloudFormation basé sur une pile par un groupe basé sur des balises dans le. AWS Management Console Toutefois, vous pouvez 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 Groupes de ressources AWS](https://console.aws.amazon.com/resource-groups).
1. Dans le volet de navigation, sous **[Groupes de ressources enregistrés](https://console.aws.amazon.com/resource-groups/groups)**, choisissez le nom du groupe, puis sélectionnez **Modifier**.
1.
**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](https://docs.aws.amazon.com//license-manager/latest/userguide/host-resource-groups.html) le *Guide de l'utilisateur du License Manager*.
1. Sur la page **Modifier le groupe**, sous **Critères de regroupement**, pour modifier la pile sur laquelle est basé 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 dans Groupes de ressources AWS](gettingstarted-query.md) de ce guide.
1. 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 Groupes de ressources AWS l'éditeur de balises](supported-resources.md).
1. Choisissez **Prévisualiser les ressources du groupe** pour récupérer la liste des ressources de la CloudFormation pile correspondant aux types de ressources que vous avez sélectionnés.
1. 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éé.
1. 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. 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.
1. Lorsque vous avez terminé, choisissez **Save changes** (Enregistrer les modifications).
------
#### [ AWS CLI & AWS SDKs ]
Dans le AWS CLI, vous mettez à jour la requête d'un groupe et 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. 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.
1. 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.
*stack\$1identifier*Il s'agit de l'ARN de la pile, comme indiqué dans 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.
------