Référence syntaxique des requêtes de recherche pour Resource Explorer - Explorateur de ressources AWS
Fonctionnement des requêtes dans Resource ExplorerSyntaxe des chaînes de requête

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.

Référence syntaxique des requêtes de recherche pour Resource Explorer

Explorateur de ressources AWS vous aide à trouver des AWS ressources individuelles dans votre Comptes AWS. Pour vous aider à trouver les ressources exactes que vous recherchez, Resource Explorer accepte les chaînes de requête de recherche qui prennent en charge la syntaxe décrite dans cette rubrique. Par exemple, des requêtes qui montrent comment utiliser les fonctionnalités décrites ici, voirExemples de requêtes de recherche dans Resource Explorer.

Note

Pour le moment, les balises associées aux ressources AWS Identity and Access Management (IAM), telles que les rôles ou les utilisateurs, ne sont pas indexées.

Fonctionnement des requêtes dans Resource Explorer

Les requêtes de recherche utilisent toujours une vue. Si vous n'en spécifiez pas explicitement une, Resource Explorer utilise la vue désignée par défaut pour la vue dans Région AWS laquelle vous travaillez.

Les vues déterminent les ressources que vous pouvez consulter. Vous pouvez créer différentes vues qui renvoient chacune un ensemble de ressources différent.

Par exemple, vous pouvez créer une vue qui inclut uniquement les ressources étiquetées avec la clé Environment et la valeurProduction. Vous pouvez ensuite choisir d'accorder l'accès à cette vue uniquement aux utilisateurs qui ont des raisons professionnelles de consulter ces ressources. Les Alpha différents utilisateurs qui ont besoin de consulter ces ressources peuvent accéder à une vue distincte qui inclut les ressources de l'Betaenvironnement. Pour plus d'informations sur le contrôle des utilisateurs ayant accès à quelles vues, consultezAutorisation de l'accès aux vues de l'Explorateur de ressources pour la recherche.

Syntaxe des chaînes de requête

Cette section fournit des informations sur les aspects de base de la syntaxe des requêtes, des filtres et des opérateurs de filtre.

Principes de base

Dans sa forme la plus élémentaire, a QueryString est un ensemble de mots clés de texte de forme libre qui sont implicitement joints par un opérateur logiqueOR. Séparez chaque mot clé des autres en utilisant un espace, comme illustré dans l'exemple suivant :

ec2 billing test gamma

Resource Explorer estime que cette liste de mots clés signifie :

ec2 OR billing OR test OR gamma

L'explorateur de ressources trie les résultats par pertinence, en privilégiant les ressources qui correspondent à un plus grand nombre de termes de recherche. Les ressources qui ne correspondent pas à un ou plusieurs termes ne sont pas exclues des résultats. Cependant, Resource Explorer les considère comme moins pertinentes et les place plus bas dans les résultats de recherche.

Si vous spécifiez une chaîne vide pour le QueryString paramètre, votre requête renvoie les 1 000 premières ressources disponibles via la vue utilisée pour l'opération. Le nombre maximum de ressources pouvant être renvoyées par une requête est de 1 000.

Note

AWS se réserve le droit de mettre à jour la logique de correspondance et les algorithmes de pertinence pour évaluer les mots clés en texte libre afin de fournir aux clients les résultats les plus pertinents. Par conséquent, les résultats renvoyés pour les mêmes requêtes utilisant des mots clés en texte libre peuvent changer au fil du temps. Lorsque vous avez besoin de résultats plus déterministes, nous vous recommandons d'utiliser des filtres. La logique de correspondance des filtres ne change pas au fil du temps.

Filtres

Vous pouvez limiter les résultats de votre requête de manière plus stricte en incluant des filtres. Contrairement aux mots clés textuels, les filtres sont évalués dans la requête à l'aide de l'ANDopérateur. Par exemple, considérez la requête suivante composée de deux mots clés libres et de deux filtres :

test instance service:EC2 region:us-west-2

Cette requête est évaluée comme suit :

( test OR instance ) AND service:EC2 AND region:us-west-2

Les filtres sont toujours évalués à l'aide d'opérateurs ANDlogiques. Si une ressource ne correspond pas au filtre, elle n'est pas incluse dans les résultats. Les résultats de l'exemple de requête incluent toutes les ressources associées à AmazonEC2, situées dans l'ouest des États-Unis (Oregon) Région AWS et auxquelles au moins un des mots clés est attaché d'une manière ou d'une autre.

Note

En raison de l'impliciteAND, vous ne pouvez utiliser 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 ressource Ré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 que tag:tag.key:, ettag.value:.

Le tableau suivant répertorie les noms de filtres disponibles que vous pouvez utiliser dans une requête de recherche de l'explorateur de ressources.

Nom du filtre Description et exemple

accountid:

Celui Compte AWS qui possède la ressource. L'explorateur de ressources inclut dans les résultats uniquement les ressources détenues par le compte spécifié.

accountid:123456789012

application:

Ce filtre vous permet de rechercher des ressources avec une clé de awsApplication balise et une valeur de groupe de ressources. Vous pouvez effectuer une recherche par nom d'application ou par groupe de ressources d'applicationsARN.

application:MyApplicationName

application:arn:aws:resource-groups:us-east-1:123456789012:group/MyApplicationName/123456789abced

arn:aws:resource-groups:us-east-1:123456789012:group/MyApplicationName/123456789abced

Note

Pour utiliser ce filtre, votre vue doit avoir accès aux données de balisage.

id:

L'identifiant d'une ressource individuelle, exprimé sous la forme d'un nom de ressource Amazon (ARN).

id:arn:aws:license-manager:us-east-1:123456789012:license-configuration:lic-ecbd5574fd92cb0d312baea26EXAMPLE

region:

L' Région AWS endroit où se trouve la ressource. L'explorateur de ressources inclut dans les résultats uniquement les ressources qui résident dans le fichier spécifié Région AWS.

region:us-east-1

Note

La saisie uniquement du code de région (sans filtre, par exempleus-east-1) ne renvoie pas les mêmes résultats queregion:us-east-1. Ce résultat est dû au fait que, en tant que mot clé de texte libre qui n'est pas un filtre, le code de région est décomposé en plusieurs parties. Par exemple, us-east-1 est recherché sous la forme useast, et1. Cette décomposition en composants ne se produit pas lorsque vous utilisez le region: préfixe.

region:global

Cas particulier pour le region: filtre que vous pouvez utiliser pour rechercher des ressources qui ne sont pas associées à un individu Région AWS mais dont la portée est considérée comme globale.

region:global

Note

Le fait de taper uniquement le mot clé global ne renvoie pas les mêmes résultats region:global car le mot littéral « global » n'est pas associé aux ressources globales. La saisie global en tant que mot-clé renvoie uniquement les ressources auxquelles cette chaîne littérale est associée.

resourcetype:

Type de ressource en service:type notation. L'explorateur de ressources inclut dans les résultats uniquement les ressources du type spécifié.

resourcetype:ec2:instance

resourcetype.supports:

Ce filtre vous permet de rechercher des ressources compatibles avec les balises. tagsest la seule valeur prise en charge. L'explorateur de ressources inclut dans les résultats uniquement les ressources pouvant être balisées.

resourcetype.supports:tags

service:

Le Service AWS qui est associé au type de ressource. L'explorateur de ressources inclut dans les résultats uniquement les ressources créées et gérées par le service spécifié.

service:ec2

tag:

Une paire clé/valeur de balise exprimée sous la forme. <key>=<value> L'explorateur de ressources inclut dans les résultats uniquement les ressources dotées d'une balise comportant à la fois une clé correspondante et la valeur spécifiée.

tag:environment=production

tag:all

Cas particulier du tag: filtre qui vous permet de rechercher des ressources associées à une ou plusieurs balises créées par l'utilisateur, même si le type de ressource n'est pas pris en charge dans Resource Explorer.

Note

Les ressources dotées de balises AWS créées par un service apparaissent toujours dans les résultats de ce filtre.

tag:none

Cas particulier du tag: filtre qui vous permet de rechercher toutes les ressources auxquelles aucune balise créée par l'utilisateur n'est attachée.

Note

Les ressources dotées de balises AWS créées par un service apparaissent toujours dans les résultats de ce filtre.

tag.key:

Une clé de tag. L'explorateur de ressources inclut dans les résultats uniquement les ressources dotées d'une balise avec une clé correspondante, quelle que soit leur valeur.

tag.key:environment

tag.value:

Une valeur de balise. L'explorateur de ressources inclut dans les résultats uniquement les ressources dotées d'une balise avec une valeur correspondante, quel que soit le nom de la clé.

tag.value:production

Opérateurs de filtrage

Vous pouvez modifier vos mots clés et vos filtres en incluant l'un des opérateurs présentés dans le tableau suivant dans la chaîne.

Opérateur Description et exemple

"multiple word phrase"

or

"hyphenated-phrase"

Entourez une phrase comportant plusieurs mots qui doit être traitée comme un seul mot clé par des guillemets doubles (" "). L'explorateur de ressources inclut uniquement les ressources qui correspondent à la phrase complète, avec tous les mots ensemble et dans l'ordre spécifié.

Si vous n'utilisez pas de guillemets doubles, Resource Explorer divise la phrase en ses composants par des espaces ou des tirets, et inclut les ressources correspondant aux composants individuels, même s'ils ne sont pas ensemble ou dans un ordre différent. Les devis doivent porter sur tout ce qui concerne l'opérateur.

"This matches only resources with the whole sentence."

This matches resources with any of the words.

"us-east-1"— ne correspond qu'aux ressources associées à cette région précise.

us-east-1— correspond à toute ressource contenant « nous », « est » ou « 1 ».

-tag:"environment=production"

keyword*

Correspondance des préfixes avec caractères génériques. Vous pouvez placer un caractère générique (un astérisque*) uniquement à la fin de la chaîne. L'explorateur de ressources inclut dans les résultats uniquement les ressources dont les valeurs commencent par le texte du préfixe situé avant le*. L'exemple suivant correspond à tout Régions AWS ce qui commence parus-east.

region:us-east*

Important

La recherche unifiée insère automatiquement un opérateur de caractère générique (*) à la fin du premier mot clé de la chaîne. Cela signifie que les résultats de recherche unifiés incluent des ressources correspondant à n'importe quelle chaîne commençant par le mot clé spécifié.

La recherche effectuée par la zone de texte Requête sur la page de recherche de ressources de la console Resource Explorer n'ajoute pas automatiquement de caractère générique. Vous pouvez insérer un * manuellement après n'importe quel terme dans la chaîne de recherche.

-keyword

Notopérateur. Vous pouvez placer un tiret (-) au début de son mot clé ou filtrer pour inverser les résultats de recherche. L'explorateur de ressources exclut des résultats toutes les ressources correspondant au mot-clé ou au filtre qui suit cet opérateur. Dans l'exemple suivant, toutes les ressources associées au EC2 service Amazon sont exclues des résultats.

-service:ec2

Important

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

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

La chaîne de requête corrigée suivante, avec un espace de = remplacement, 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 qu'il ne s'-agisse pas du premier caractère de la valeur du paramètre, vous pouvez utiliser le caractère d'espace standard. La chaîne de requête suivante fonctionne.

aws resource-explorer-2 search --query-string "region:us-east-1 -tag:none"
\<special character>

Vous pouvez éviter les caractères spéciaux qui doivent être inclus exactement comme indiqué plutôt que interprétés. Si votre texte contient l'un des caractères spéciaux ( * " - : = \), vous devez le faire précéder d'une barre oblique inverse (\) pour vous assurer qu'il est pris au pied de la lettre. L'exemple suivant montre comment utiliser un mot-clé de texte libre qui inclut le caractère tiret (-) (). "my-key-word"

En outre, pour empêcher Resource Explorer de diviser l'expression au niveau des traits d'union en trois mots clés distincts, vous pouvez placer la phrase entière entre guillemets doubles.

"my\-key\-word"

Pour insérer une barre oblique inverse littérale, insérez deux barres obliques inversées d'affilée. La première barre oblique inverse est interprétée comme un échappement et la seconde est le caractère littéral à insérer.

"some_text\\some_more_text"
Note

Si la vue inclut les balises associées aux ressources, l'Searchopération ne génère pas d'erreurs de validation pour les chaînes de recherche, car un filtre non valide peut également être interprété comme une recherche de texte libre. Par exemple, même s'il cat:blue ressemble à un filtre, Resource Explorer ne peut pas l'analyser comme tel car il cat: ne fait pas partie des filtres définis et valides. Resource Explorer interprète plutôt la chaîne entière comme une chaîne de recherche de forme libre pour lui permettre de correspondre à des éléments tels que le nom d'une clé de balise ou une partie d'un. ARN

L'opération génère une erreur de validation si l'une des conditions suivantes est vraie :

  • La vue n'inclut pas d'informations sur les balises

  • La requête de recherche utilise explicitement un filtre de balises (tag.key:tag.value:, outag:)