En utilisantExplorateur de ressources AWSpour rechercher des ressources

L'objectif principal de permettreExplorateur de ressources AWSdans votreCompte AWSpermet à vos utilisateurs de rechercher des ressources dans le compte. Utilisez leAWS Management Consoleou leAWS Command Line Interface(AWS CLI) pour rechercher des ressources à l'aide de l'Explorateur de ressources.

Voici quelques-unes des principales caractéristiques de la recherche dans l'Explorateur de ressources.

• Chaque recherche doit utiliser une vue.

  La vue est utilisée par l'Explorateur de ressources pour déterminer qui est autorisé à voir quelles ressources. Pour utiliser une vue dans une opération de recherche dans l'Explorateur de ressources, l'utilisateur doit disposer d'unAllowsur leresource-explorer-2:Searchopération pour la vue spécifiée. Cette autorisation provient d'unpolitique d'autorisation basée sur l'identitéattaché au principal auteur de la demande.

  La vue peut inclure un filtre qui limite les ressources pouvant être incluses dans les résultats. En créant différentes vues qui utilisent des filtres et en accordant à différents principaux utilisateurs l'accès à différentes vues, vous pouvez configurer un environnement dans lequel chaque groupe d'utilisateurs ne peut voir que les ressources qui le concernent.

  Pour plus d'informations sur les vues, voirGestion des vues de l'explorateur de ressources pour fournir un accès à la recherche.

• Resource Explorer utilise des processus d'arrière-plan asynchrones pour gérer ses index.

  Les processus d'indexation de Resource Explorer peuvent mettre un certain temps à découvrir les ressources récemment créées ou modifiées et à les ajouter à l'index local. Resource Explorer peut mettre plus de temps à répliquer les modifications des index locaux vers l'index agrégateur.

  Il en va de même pour les ressources que vous supprimez. Il peut s'écouler un certain temps après la suppression d'une ressource avant que cette suppression soit découverte par le processus d'indexation et que les informations relatives à cette ressource soient supprimées de l'index local. Resource Explorer a besoin de plus de temps pour répliquer cette suppression de l'index local vers l'index agrégateur du compte.

  Les ajouts, modifications et suppressions apportés à vos ressources peuvent prendre jusqu'à 36 heures pour que Resource Explorer affiche ces modifications dans les résultats de recherche dans toutes les régions où vous avez activé Resource Explorer.

• Une recherche dans l'Explorateur de ressources s'effectue dans unRégion AWS.

  Chaque région dans laquelle vous activez l'Explorateur de ressources contient un index contenant uniquement les ressources stockées dans cette région. Les vues sont également associées à des régions et ne peuvent renvoyer que les ressources trouvées dans l'index de cette région. La seule exception à cette règle est l'index agrégateur, qui reçoit une copie répliquée de tous les index locaux afin de permettre la recherche dans toutes les régions du compte.

• La recherche interrégionale nécessite un index agrégateur pour le compte.

  Pour permettre aux utilisateurs de rechercher des ressources dans tousRégions AWS, l'administrateur doit désigner une région pour contenir l'index agrégateur du compte. Une copie de chaque index local est automatiquement répliquée vers l'index agrégateur.

  De ce fait, seules les vues de l'index d'agrégateur Region peuvent renvoyer des résultats qui incluent des ressources provenant de tousRégions AWSdans le compte.

• Une requête se compose d'un certain nombre de mots-clés et de filtres de type texte libre.

  Les mots-clés de forme libre sont combinés dans la requête à l'aide de la logiqueORopérateurs. Filtres utilisant des noms de filtres définis par Resource Explorersont combinés dans la requête à l'aide de la logiqueANDopérateurs. Examinez l'exemple de requête suivant.

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

  Ceci est évalué par Resource Explorer comme suit.

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

  Cette requête nécessite que les ressources correspondantes soient des ressources Amazon EC2 de la région USA Ouest (Oregon) et qu'elles comportent au moins l'un des mots clés (test,exemple) attachés d'une manière ou d'une autre, par exemple dans le nom, la description ou les balises.

  Note

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

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

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

• Une recherche ne peut renvoyer que les 1 000 premiers résultats.

  Cette exigence inclut une recherche avec une chaîne de requête vide correspondant à toutes les ressources. Pour voir les ressources au-delà des 1 000 renvoyées par une chaîne de requête vide, vous devez utiliser des requêtes pour restreindre les résultats correspondants à ceux que vous souhaitez voir et limiter le nombre de correspondances à moins de 1 000.

• Le nombre d'opérations de recherche que vous pouvez effectuer est limité par compte.

  Les quotas limitent le nombre de requêtes que vous pouvez effectuer par seconde et le nombre de requêtes que vous pouvez effectuer chaque mois. Pour des numéros de quotas spécifiques, voirQuotas pour Resource Explorer.

AWS Management Console

Pour rechercher des ressources à l'aide de l'Explorateur de ressources

1. Sur leRecherche de ressourcespage, commencez par choisir la vue que vous souhaitez utiliser. Vous pouvez choisir uniquement les vues auxquelles vous êtes autorisé à accéder.

2. PourRequête, entrez les termes de recherche etfiltresqui identifient les ressources que vous souhaitez consulter. Pour plus d'informations sur toutes les options de syntaxe disponibles, voirRéférence syntaxique des requêtes de recherche pour Resource Explorer.

3. PresseEntrezpour soumettre votre requête.

   L'Explorateur de ressources affiche tous les résultats qui correspondent à la fois auFilterdéfini dans la vue et dansRequêteque vous fournissez. Les résultats sont triés par pertinence. Les ressources qui correspondent à un plus grand nombre de termes de votre requête apparaissent en haut de la liste et les ressources qui correspondent à moins de termes apparaissent plus bas dans la liste.

4. Choisissez l'identifiant d'une ressource pour accéder à la console native de ce type de ressource, où vous pouvez interagir avec la ressource de toutes les manières prises en charge par ce service.

AWS CLI

Pour rechercher des ressources à l'aide de l'Explorateur de ressources

Exécutez la commande suivante pour rechercher des ressources à l'aide de la vue spécifiée. Cette vue doit exister dans la région dans laquelle vous exécutez l'opération. L'exemple suivant recherche les instances Amazon EC2 qui sont balisées.env=productiondans l'est des États-Unis (Ohio) (us-east-2). Pour plus d'informations sur toutes les options de syntaxe disponibles pourquery-stringparamètre, voirRéférence syntaxique des requêtes de recherche pour Resource Explorer.

$ aws resource-explorer-2 search \
    --region us-east-1 \
    --query-string "resourcetype:AWS::EC2::Instance tag:env=production"
    --view-arn arn:aws:resource-explorer-2:us-east-2:123456789012:view/My-Resources-View/1a2b3c4d-5d6e-7f8a-9b0c-abcd11111111

Exporter les résultats de recherche vers un fichier .csv

Vous pouvez exporter les résultats d'unRecherche de ressourcesrequête vers un fichier de valeurs séparées par des virgules (.csv). Le fichier .csv inclut l'identifiant, le type de ressource, la région,Compte AWS, le nombre total de balises et une colonne pour chaque clé de balise unique de la collection. Le fichier .csv peut vous aider à configurer votreAWSles ressources de votre organisation, ou déterminez les chevauchements ou les incohérences dans le balisage des ressources.

1. Dans les résultats de votreRecherche de ressourcesrequête, choisissezExporter les ressources au format CSV.

   Vous pouvez choisir d'exporter vos résultats uniquement avec les colonnes que vous pouvez voir actuellement ou de les exporter avec toutes les colonnes disponibles.

   

2. Lorsque votre navigateur vous y invite, choisissez d'ouvrir le fichier .csv ou enregistrez-le à un emplacement approprié.