Créez une requête basée sur des balises et créez un groupe

Les procédures suivantes vous montrent comment créer une requête basée sur des balises et l'utiliser pour créer un groupe de ressources.

Console

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

2. Dans le volet de navigation, choisissez Create Resource Group.

3. Sur la page Créer un groupe basé sur des requêtes, sous Type de groupe, choisissez le type de groupe basé sur des balises.

4. Sous Critères de regroupement, choisissez les types de ressources que vous souhaitez inclure dans votre groupe de ressources. Vous pouvez avoir un maximum de 20 types de ressources dans une requête. Pour cette procédure pas à pas, choisissez AWS::EC2::Instanceet. AWS::S3::Bucket

5. Toujours sous Critères de regroupement, pour les balises, spécifiez une clé de balise, ou une paire clé-valeur de balise, afin de limiter les ressources correspondantes afin d'inclure uniquement celles qui sont étiquetées avec les valeurs que vous avez spécifiées. Choisissez Add (Ajouter) ou appuyez sur Enter (Entrée) lorsque vous avez terminé votre balise. Dans cet exemple, filtrez les ressources disposant d'une clé de balise Stage (Étape). La valeur de balise est facultative, mais affine les résultats de la requête. Vous pouvez ajouter plusieurs valeurs pour une clé de balise en ajoutant un OR opérateur entre les valeurs de balise. Choisissez Add (Ajouter) pour ajouter plus de balises. Les requêtes attribuent un opérateur AND aux balises, afin que toutes les ressources correspondant aux types de ressources spécifiés et à toutes les balises spécifiées soient renvoyées par la requête.

6. Toujours sous Critères de regroupement, choisissez Prévisualiser les ressources du groupe pour renvoyer la liste des EC2 instances et des compartiments S3 de votre compte qui correspondent à la ou aux clés de balise spécifiées.

7. Une fois que vous avez obtenu les résultats souhaités, créez un groupe basé sur cette requête.

   1. Sous Détails du groupe, dans Nom du groupe, tapez le nom de votre groupe de ressources.

      Un nom de groupe de ressources peut avoir un maximum de 128 caractères, y compris des lettres, des chiffres, des tirets, des points et des traits de soulignement. Le nom ne peut pas commencer par AWS ou aws. Ils sont réservés. Le nom d'un groupe de ressources doit être unique dans la région actuelle de votre compte.

   2. (Facultatif) Dans Group description (Description du groupe), saisissez une description de votre groupe.

   3. (Facultatif) Dans Group tags (Balises du groupe), ajoutez des paires de clés et de valeurs de balise qui s'appliquent uniquement au groupe de ressources, et non aux ressources membres du groupe.

      Les balises de groupe sont utiles si vous envisagez de faire de ce groupe un membre d'un groupe plus important. Veillez à ajouter au moins une clé de balise dans Group tags (Balises de groupe) aux groupes que vous envisagez d'imbriquer dans des groupes plus importants, car vous devez spécifier au moins une clé de balise pour créer un groupe.

8. Lorsque vous avez terminé, choisissez Créer un groupe.

AWS CLI & AWS SDKs

Un groupe basé sur des balises est basé sur une requête de type TAG_FILTERS_1_0.

1. Dans une AWS CLI session, tapez ce qui suit, puis appuyez sur Entrée pour remplacer les valeurs du nom du groupe, de la description, des types de ressources, des clés de balise et des valeurs de balise par les vôtres. Les descriptions peuvent avoir un maximum de 512 caractères, y compris des lettres, des chiffres, des tirets, des traits de soulignement, des signes de ponctuation et des espaces. Vous pouvez avoir un maximum de 20 types de ressources dans une requête. Un nom de groupe de ressources peut avoir un maximum de 128 caractères, y compris des lettres, des chiffres, des tirets, des points et des traits de soulignement. Le nom ne peut pas commencer par AWS ou aws. Ils sont réservés. Un nom de groupe de ressources doit être unique dans votre compte.

   Au moins une valeur pour ResourceTypeFilters est obligatoire. Pour spécifier tous les types de ressources, utilisez AWS::AllSupported en tant que valeur ResourceTypeFilters.

   $ aws resource-groups create-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 create-group \
       --name my-resource-group \
       --resource-query '{"Type":"TAG_FILTERS_1_0","Query":"{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Stage\",\"Values\":[\"Test\"]}]}"}'

   La commande suivante est un exemple qui inclut tous les types de ressources pris en charge.

   $ aws resource-groups create-group \
       --name my-resource-group \
       --resource-query '{"Type":"TAG_FILTERS_1_0","Query":"{\"ResourceTypeFilters\":[\"AWS::AllSupported\"],\"TagFilters\":[{\"Key\":\"Stage\",\"Values\":[\"Test\"]}]}"}'

2. Les éléments suivants sont renvoyés dans la réponse à la commande.

   • Une description complète du groupe que vous avez créé.

   • La requête de ressources que vous avez utilisée pour créer le groupe.

   • Les balises associées au groupe.