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

Les procédures suivantes vous montrent comment mettre à jour un groupe 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 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 AWS Resource Groups.

2. Dans le volet de navigation, sous Groupes de ressources enregistrés, choisissez le nom du groupe, puis sélectionnez Modifier.

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

4. 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 AWS 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 Prévisualiser les ressources du groupe pour récupérer la liste des ressources de la AWS CloudFormation pile correspondant 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. 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.

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

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