Exemples de requêtes de recherche dans Resource Explorer

Les exemples suivants montrent la syntaxe des types courants de requêtes que vous pouvez utiliser dansExplorateur de ressources AWS.

Important

Si vous utilisez laAWS CLIsearch commande et que la valeur de votre--query-string paramètre contient l'-opérateur comme premier caractère, vous devez séparer le nom du paramètre de sa valeur par un signe égal (=) au lieu de l'espace habituel. Si vous utilisez le caractère d'espace, la CLI interprète mal la chaîne. Par exemple, la requête suivante échoue.

aws resource-explorer-2 search --query-string "-tag:none region:us-east-1"

La requête corrigée suivante, en= remplaçant l'espace, fonctionne comme prévu.

aws resource-explorer-2 search --query-string="-tag:none region:us-east-1"

Si vous modifiez l'ordre des filtres dans la chaîne de requête afin que ce ne- soit pas le premier caractère de la valeur du paramètre, vous pouvez utiliser le caractère d'espace standard. La requête suivante fonctionne.

aws resource-explorer-2 search --query-string "region:us-east-1 -tag:none"

Rechercher des ressources non balisées

Si vous souhaitez utiliser le contrôle d'accès basé sur les attributs (ABAC) sur votre compte, utiliser une allocation basée sur les coûts ou effectuer une automatisation basée sur des balises pour vos ressources, vous devez savoir quelles ressources de votre compte peuvent ne pas comporter de balises. L'exemple de requête suivant utilise la balise de filtre case spéciale : none pour renvoyer toutes les ressources pour lesquelles il manque des balises générées par l'utilisateur.

Letag:none filtre s'applique uniquement aux balises créées par l'utilisateur. Les balises générées et gérées parAWS sont exemptées de ce filtre et apparaissent toujours dans les résultats.

tag:none

Pour exclure également toutes les balises systèmeAWS créées, ajoutez un deuxième filtre, comme indiqué dans l'exemple suivant. Le premier élément de la chaîne de requête reproduit l'exemple précédent en filtrant toutes les balises créées par l'utilisateur. AWSles balises système créées commencent toujours par les lettresaws. Par conséquent, vous pouvez utiliser l'opérateur logique NOT (-) avec le filtre tag.key pour exclure également toutes les ressources dont la balise porte un nom de clé commençant paraws.

tag:none -tag.key:aws*

Rechercher des ressources étiquetées

Pour trouver toutes les ressources dotées d'une balise de n'importe quel type, vous pouvez utiliser l'opérateur logique NOT (-) avec le filtre case spécial : none comme suit.

-tag:none

Rechercher des ressources pour lesquelles il manque un tag spécifique

Également lié à ABAC, vous souhaiterez peut-être rechercher toutes les ressources qui n'ont pas de balise avec une clé spécifiée. L'exemple suivant utilise l'opérateur logique NOT- pour renvoyer toutes les ressources pour lesquelles il manque une balise avec le nom de cléDepartment.

-tag.key:Department

Rechercher des ressources dont les valeurs de balise ne sont pas valides

Pour des raisons de conformité, vous souhaiterez peut-être rechercher toutes les ressources dont les balises importantes sont manquantes ou mal orthographiées. L'exemple suivant renvoie toutes les ressources dont la balise porte le nom de cléenvironment. Toutefois, la requête filtre toute ressource possédant l'une des valeurs validesprodinteg, oudev. Tous les résultats qui apparaissent à partir de cette requête ont une autre valeur que vous devez étudier et corriger.

Important

Les recherches dans l'Explorateur de ressources ne distinguent pas les majuscules des majuscules et ne permettent pas de faire la distinction entre les noms de clés et les valeurs qui ne diffèrent que par la façon dont ils sont mis en majuscules. Par exemple, les valeurs de l'exemple suivant correspondent àPROD,prodPrOd, ou à une variation quelconque. Cependant, certaines applications utilisent des balises en distinguant les majuscules et minuscules. Nous vous recommandons d'adopter une stratégie de capitalisation standard pour votre organisation, par exemple en utilisant uniquement des noms et des valeurs de balises en minuscules. Une approche cohérente peut aider à éviter la confusion qui peut être causée par le fait d'avoir des balises qui ne diffèrent que par la façon dont elles sont mises en majuscules.

tag.key:environment -tag:environment=prod -tag:environment=integ -tag:environment=dev

Rechercher des ressources dans un sous-ensemble deRégions AWS

Utilisez l'opérateur'*' joker pour faire correspondre toutes les régions d'une certaine région du monde. L'exemple suivant renvoie toutes les ressources qui se trouvent dans les régions d'Europe (UE).

region:eu-*

Rechercher des ressources mondiales

Utilisez laglobal valeur des majuscules spéciales pour leregion: filtre afin de rechercher vos ressources considérées comme globales et non associées à une région en particulier.

region:global

Rechercher des ressources d'un certain type situées dans une région spécifique

Lorsque vous utilisez plusieurs filtres, Resource Explorer évalue l'expression en combinant les préfixes avec desAND opérateurs logiques implicites. L'exemple suivant renvoie toutes les ressources de la région Asie-Pacifique (Hong Kong) quiAND sont des instances Amazon EC2.

region:ap-east-1 resourcetype:ec2:instance

Note

En raison de l'impliciteAND, vous ne pouvez utiliser avec succès qu'un seul filtre pour un attribut qui ne peut avoir qu'une seule valeur associée à la ressource. Par exemple, une ressource ne peut faire partie que d'une seule ressourceRégion AWS. Par conséquent, la requête suivante ne renvoie aucun résultat.

region:us-east-1 region:us-west-1

Cette limitation ne s'applique pas aux filtres pour les attributs qui peuvent avoir plusieurs valeurs en même temps, tels quetag:tag.key:, ettag.value:.

Rechercher des ressources contenant un terme composé de plusieurs mots

Entourez un terme comportant plusieurs mots de guillemets doubles (") pour renvoyer uniquement les résultats dont le terme entier est dans l'ordre spécifié. Sans guillemets doubles, Resource Explorer renvoie les ressources qui correspondent aux mots individuels composant le terme. Par exemple, la requête suivante utilise les guillemets doubles pour renvoyer uniquement les ressources correspondant au terme"west wing". La requête ne correspond pas aux ressources de la régionus-west-2Région AWS (ou de toute autre région inclusewest dans son code) ni aux ressources qui correspondent au mot « aile » sans le mot « ouest ».

"west wing"

Recherche de ressources faisant partie d'une CloudFormation pile spécifiée

Lorsque vous créez une ressource dans le cadre d'uneAWS CloudFormation pile, elle est automatiquement balisée avec le nom de la pile. L'exemple suivant renvoie toutes les ressources créées dans le cadre de la pile spécifiée.

tag:aws:cloudformation:stack-name=my-stack-name