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.
Lister et filtrer vos ressources
Vous pouvez obtenir la liste de certains types de ressource à l’aide de la console Amazon EC2. Vous pouvez obtenir une liste de chaque type de ressource à l’aide de sa commande ou de son action d’API correspondante. Si vous avez plusieurs ressources, vous pouvez filtrer les résultats pour n’inclure ou n’exclure que les ressources qui correspondent à certains critères.
Lister et filtrer des ressources à l’aide de la console
Table des matières
Lister des ressources à l’aide de la console
Vous pouvez afficher les types de ressource Amazon EC2 les plus courants à l’aide de la console. Pour afficher des ressources supplémentaires, utilisez l’interface ligne de commande ou les actions d’API.
Pour afficher les ressources EC2 à l’aide de la console
-
Ouvrez la console Amazon EC2 à l’adresse https://console.aws.amazon.com/ec2/
. -
Dans le volet de navigation, choisissez l’option qui correspond à la ressource. Par exemple, pour créer une liste de vos instances, choisissez Instances.
La page affiche toutes les ressources du type de ressource sélectionné.
Filtrer des ressources à l’aide de la console
Pour filtrer une liste de ressources
-
Dans le panneau de navigation, sélectionnez un type de ressource (par exemple, Instances).
-
Choisissez le champ de recherche.
-
Sélectionnez le filtre dans la liste.
-
Sélectionnez un opérateur, par exemple,= (Equals (égal à)). Certains attributs ont plus d’opérateurs disponibles à sélectionner. Notez que tous les écrans ne prennent pas en charge la sélection d’un opérateur.
-
Sélectionnez une valeur de filtre.
-
Pour modifier un filtre sélectionné, choisissez le jeton de filtre (zone bleue), apportez les modifications requises, puis choisissezAppliquer. Notez que tous les écrans ne prennent pas en charge la modification du filtre sélectionné.
-
Lorsque vous avez terminé, retirez le filtre.
Filtres pris en charge
La console Amazon EC2 prend en charge deux types de filtrage.
-
Le filtrage des API se produit côté serveur. Le filtrage est appliqué à l’appel d’API qui réduit le nombre de ressources renvoyées par le serveur. Il permet un filtrage rapide sur des ensembles volumineux de ressources et peut réduire le temps et le coût du transfert de données entre le serveur et le navigateur. Filtrage d’API est compatible avec les opérateurs =(equals (égal à)) et :(contains (contient), et est toujours sensible à la casse.
-
Le filtrage client se produit du côté du client. Il vous permet de filtrer les données déjà disponibles dans le navigateur (en d’autres termes, les données qui ont déjà été renvoyées par l’API). Le filtrage client fonctionne parfaitement en conjonction avec un filtre d’API de manière à réduire le filtrage à de plus petits ensembles de données dans le navigateur. En plus des opérateurs =(equals (égal à)) et :(contains (contient)) opérateurs, le filtrage client peut également prendre en charge les opérateurs de plage, tels que>=(greater than or equal (supérieur ou égal à)) et les opérateurs de négation (inverse), tels que ! =(does not equal (n’est pas égal à)).
La console Amazon EC2 prend en charge les types de recherches suivants :
- Recherche par mot-clé
-
La recherche par mot clé est une recherche de texte libre qui vous permet de rechercher une valeur parmi tous les attributs de vos ressources ou balises, sans spécifier l’attribut ou la balise à rechercher.
Note
Toutes les recherches par mots-clés utilisent le filtrage client.
Pour rechercher par mot-clé, entrez ou collez ce que vous recherchez dans la zone de recherche, puis choisissez Enter (Entrer). Par exemple, rechercher
123
établit la correspondance avec toutes les instances qui ont 123 dans l’un quelconque de leurs attributs, par exemple, une adresse IP, un ID d’instance, un ID de VPC ou un ID d’AMI, ou dans l’un quelconque de leurs balises telles que Nom. Si votre recherche de texte libre renvoie des correspondances inattendues, appliquez des filtres supplémentaires. - Recherche par attribut
-
La recherche par attribut vous permet de rechercher un attribut spécifique parmi toutes vos ressources.
Note
Les recherches par attribut utilisent le filtrage d’API ou le filtrage client, en fonction de l’attribut sélectionné. Lors d’une recherche par attribut, les attributs sont regroupés en conséquence.
Par exemple, vous pouvez rechercher l’attribut État de l’instance pour toutes vos instances afin de renvoyer uniquement les instances dont l’état est
stopped
. Pour cela :-
Dans le champ de recherche de l’écran Instances, commencez à saisir
Instance state
. Au fur et à mesure que vous entrez les caractères, les deux types de filtres apparaissent pour État de l’instance : les filtres API et les filtres client. -
Pour effectuer une recherche côté serveur, choisissez État de l’instance sous Filtres API. Pour effectuer une recherche côté client, choisissez État de l’instance (client) sous Filtres client.
Une liste d’opérateurs possibles pour l’attribut sélectionné s’affiche.
-
Cliquez sur l’onglet=opérateur (Equals (égal à)).
Une liste des valeurs possibles pour l’attribut et l’opérateur sélectionné s’affiche.
-
Sélectionnez Arrêté dans la liste.
-
- Rechercher par identification
-
La recherche par balise permet de filtrer les ressources du tableau actuellement affiché par une clé de balise ou une valeur de balise.
Les recherches de balises utilisent soitFiltrage APIoufiltrage client, selon les paramètres de la fenêtre Preferences (Préférences).
Pour garantir le filtrage des API pour les balises
-
Ouvrir l’onglet Preferences (Préférences).
-
Effacer la case Utiliser la mise en correspondance d’expressions régulières. Si cette case est cochée, le filtrage client est effectué.
-
Sélectionnez la case Correspondance avec respect des casse. Si cette case est cochée, le filtrage client est effectué.
-
Choisissez Confirmer.
Lorsque vous effectuez une recherche par balise, vous pouvez utiliser les valeurs suivantes :
-
(vide)— Recherchez toutes les ressources avec la clé de balise spécifiée, mais il ne doit pas y avoir de valeur de balise.
-
Toutes les valeurs— Recherchez toutes les ressources avec la clé de balise spécifiée et n’importe quelle valeur de balise.
-
Non balisé – Pour rechercher toutes les ressources qui n’ont pas la clé de balise spécifiée.
-
La valeur affichée : permet de rechercher toutes les ressources avec la clé de balise spécifiée et la valeur de balise spécifiée.
-
Vous pouvez utiliser les techniques suivantes pour améliorer ou affiner vos recherches.
- Recherche inversée
-
Les recherches inverses vous permettent de rechercher des ressources qui ne correspondent pas à une valeur spécifiée. Dans les écrans InstancesetAMI, les recherches inverses sont effectuées en sélectionnant l’opérateur ! =(Does not equal (N’est pas égal à)) ou ! :(Does not contain (Ne contient pas)), puis en sélectionnant une valeur. Dans d’autres écrans, les recherches inverses s’effectuent en préfixant le mot clé de recherche d’un caractère point d’exclamation (!).
Note
La recherche inverse est prise en charge avec des recherches par mot-clé et des recherches par attribut uniquement sur des filtres client. Elle n’est pas prise en charge avec des recherches par attribut sur les filtres d’API.
Par exemple, vous pouvez rechercher l’attribut État de l’instance pour toutes vos instances afin de renvoyer uniquement les instances dont l’état est
terminated
. Pour cela :-
Dans le champ de recherche de l’écran Instances, commencez à saisir
Instance state
. Au fur et à mesure que vous entrez les caractères, les deux types de filtres apparaissent pour État de l’instance : les filtres API et les filtres client. -
Sous Filtres client, choisissez État de l’instance (client). La recherche inverse n’est prise en charge que sur les filtres client.
Une liste d’opérateurs possibles pour l’attribut sélectionné s’affiche.
-
Choisissez ! =(Does not equal (N’est pas égal à)), puis choisissezrésilié.
Pour filtrer les instances en fonction d’un attribut d’état d’instance, vous pouvez également utiliser les icônes de recherche ( ) dans la colonne État de l’instance. L’icône de recherche avec un signe plus ( + ) affiche toutes les instances correspondant à cet attribut. L’icône de recherche avec un signe moins ( - ) exclut toutes les instances correspondant à cet attribut.
Voici un autre exemple d’utilisation de la recherche inverse : pour répertorier toutes les instances qui ne sont pas affectées au groupe de sécurité nommé
launch-wizard-1
, sous Filtres client, effectuez une recherche via l’attribut Security group name (Nom du groupe de sécurité), choisissez !=, et dans la barre de recherche entrezlaunch-wizard-1
. -
- Recherche partielle
-
Avec les recherches partielles, vous pouvez rechercher des valeurs de chaîne partielles. Pour effectuer une recherche partielle, entrez uniquement une partie du mot-clé que vous souhaitez rechercher. Dans les écransInstancesetAMI, les recherches partielles ne peuvent être effectuées qu’avec l’opérateur :(Contains (Contient)). Sur d’autres écrans, vous pouvez sélectionner l’attribut de filtre client et entrer immédiatement uniquement une partie du mot-clé que vous souhaitez rechercher. Par exemple, dans l’écran Type d’instance , pour rechercher toutes les instances , et
t2.micro
, effectuez une recherche par l’attributt2.small
Instance Type (Type d’instance)t2.medium
puis saisissezt2
. - Recherche d’expression régulière
-
Pour utiliser les recherches d’expression régulière, vous devez sélectionner la case à cocher Use regular expression matching (Utiliser la correspondance d’expression régulière) dans la fenêtre Preferences (préférences).
Les expressions régulières sont utiles quand vous avez besoin de faire correspondre les valeurs d’un champ à un modèle spécifique. Par exemple, pour rechercher une valeur qui commence par
s
, recherchez^s
. Pour rechercher une valeur qui se termine parxyz
, recherchezxyz$
. Pour rechercher une valeur commençant par un nombre suivi d’un ou de plusieurs caractères, recherchez[0-9]+.*
.Note
La recherche par expression régulière est prise en charge avec les recherches par mot-clé et les recherches par attribut uniquement sur les filtres client. Elle n’est pas prise en charge avec des recherches par attribut sur les filtres d’API.
- Recherche sensible à la casse
-
Pour utiliser des recherches sensibles à la casse, vous devez sélectionner leCorrespondance avec respect des cassedans la fenêtrePreferences (Préférences). La préférence sensible à la casse s’applique uniquement aux filtres des clients et des balises.
Note
Les filtres d’API sont toujours sensibles à la casse.
- Recherche par caractère générique
-
Utilisez le caractère générique
*
pour faire correspondre zéro ou plusieurs caractères. Utilisez le caractère générique?
pour faire correspondre zéro ou un caractère. Par exemple, si vous disposez d’un ensemble de données contenant les valeursprod
,prods
, etproduction
, une recherche deprod*
correspond à toutes les valeurs, tandis queprod?
correspondances uniquementprod
etprods
. Pour utiliser les valeurs littérales, échappez-les avec une barre oblique inverse (\). Par exemple, "prod\*
" correspondrait àprod*
.Note
La recherche par caractère générique est prise en charge avec les recherches par attribut et balise uniquement sur les filtres d’API. Elle n’est pas prise en charge avec les recherches par mot-clé et les recherches par attribut et balise uniquement sur les filtres client.
- Combinaison de recherches
En général, plusieurs filtres avec le même attribut sont automatiquement joints avec
OR
. Par exemple, la rechercheInstance State : Running
etInstance State : Stopped
renvoie toutes les instances en cours d’exécution OU arrêtées. Pour joindre la recherche avecAND
, recherchez sur différents attributs. Par exemple, les recherchesInstance State : Running
etInstance Type : c4.large
renvoient uniquement les instances de typec4.large
ET qui sont dans l’état d’exécution.
Lister et filtrer à l’aide de la CLI et de l’API
Chaque type de ressource possède une commande de CLI ou une action d’API correspondante que vous utilisez pour afficher les ressources de ce type. Les listes de ressources qui en résultent peuvent être longues, de sorte qu’il peut être plus rapide et plus utile de filtrer les résultats pour inclure uniquement les ressources qui répondent à des critères spécifiques.
Considérations relatives au filtrage
-
Vous pouvez spécifier plusieurs filtres et plusieurs valeurs de filtre dans une seule requête.
-
Vous pouvez aussi utiliser des caractères génériques avec les valeurs de filtre. Un astérisque (*) correspond à zéro ou plusieurs caractères, et un point d’interrogation (?) correspond à zéro ou un caractère.
-
Les valeurs de filtre sont sensibles à la casse.
-
Votre recherche peut inclure les valeurs littérales des caractères génériques ; vous devez simplement leur associer une séquence d’échappement avec une barre oblique inverse devant le caractère. Par exemple, la valeur
\*amazon\?\\
recherche la chaîne littérale*amazon?\
.
Filtres pris en charge
Pour découvrir les filtres pris en charge pour chaque ressource Amazon EC2, consultez la documentation suivante :
-
AWS CLI : commandes
describe
dans AWS CLI Référence des commandes Amazon EC2. -
Outils pour Windows PowerShell : les
Get
commandes de l'AWS Tools for PowerShell applet de commande Reference-Amazon EC2. -
API de requête : les
Describe
actions des API dans Référence des API Amazon EC2.
Exemple : spécifier un filtre unique
Vous pouvez lister vos instances Amazon EC2 à l’aide de la commande describe-instances. Sans aucun filtre, la réponse contient les informations pour toutes vos ressources. Vous pouvez utiliser la commande suivante pour inclure uniquement les instances en cours d’exécution dans votre sortie.
aws ec2 describe-instances --filters Name=instance-state-name,Values=running
Pour répertorier uniquement les ID des instances en cours d’exécution, ajoutez le paramètre --query
comme suit.
aws ec2 describe-instances --filters Name=instance-state-name,Values=running --query "Reservations[*].Instances[*].InstanceId" --output text
Voici un exemple de sortie.
i-0ef1f57f78d4775a4 i-0626d4edd54f1286d i-04a636d18e83cfacb
Exemple : spécifier plusieurs filtres ou valeurs de filtre
Si vous spécifiez plusieurs filtres ou plusieurs valeurs de filtre, la ressource doit correspondre à tous les filtres pour pouvoir apparaître dans les résultats.
Vous pouvez utiliser la commande suivante pour répertorier toutes les instances dont le type est m5.large
ou m5d.large
.
aws ec2 describe-instances --filters Name=instance-type,Values=m5.large,m5d.large
Vous pouvez utiliser la commande suivante pour répertorier toutes les instances arrêtées dont le type est t2.micro
.
aws ec2 describe-instances --filters Name=instance-state-name,Values=stopped Name=instance-type,Values=t2.micro
Exemple : utiliser des caractères génériques dans une valeur de filtre
Si vous spécifiez database
comme valeur de filtre pour le filtre description
lors de la description des instantanés EBS via describe-snapshots, la commande renvoie uniquement les instantanés dont la description correspond à « database ».
aws ec2 describe-snapshots --filters Name=description,Values=database
Le caractère générique * correspond à zéro ou plusieurs caractères. Si vous spécifiez *database*
comme valeur de filtre, la commande renvoie uniquement les instantanés dont la description inclut ce terme.
aws ec2 describe-snapshots --filters Name=description,Values=*database*
Le caractère générique ? correspond à 1 seul caractère. Si vous spécifiez database?
comme valeur de filtre, la commande renvoie uniquement les instantanés dont la description correspond à « database » ou à ce terme, suivi d’un caractère.
aws ec2 describe-snapshots --filters Name=description,Values=database?
Si vous indiquez database????
, la commande renvoie uniquement les instantanés dont la description correspond à « database », suivi d’un maximum de quatre caractères. Elle exclut les descriptions contenant le terme « database » suivi de cinq caractères ou plus.
aws ec2 describe-snapshots --filters Name=description,Values=database????
Exemple : filtre basé sur la date
Avec le AWS CLI, vous pouvez utiliser JMESPath pour filtrer les résultats à l'aide d'expressions. Par exemple, la describe-snapshotscommande suivante affiche les ID de tous les instantanés créés par votre Compte AWS (représenté par
Si vous ne spécifiez pas le propriétaire, les résultats incluent tous les instantanés publics.123456789012
) avant la date spécifiée (représentée par le 31/03/2020).
aws ec2 describe-snapshots --filters Name=owner-id,Values=
123456789012
--query "Snapshots[?(StartTime<='2020-03-31
')].[SnapshotId]" --output text
La commande suivante affiche les ID de tous les instantanés créés dans la plage de dates spécifiée.
aws ec2 describe-snapshots --filters Name=owner-id,Values=
123456789012
--query "Snapshots[?(StartTime>='2019-01-01
') && (StartTime<='2019-12-31
')].[SnapshotId]" --output text
Filtre basé sur les balises
Pour obtenir des exemples de filtrage d’une liste de ressources en fonction de leurs balises, consultez Utiliser des balises à l’aide de la ligne de commande.
Afficher les ressources entre Régions à l’aide d’Amazon EC2 Global View
Amazon EC2 Global View vous permet de consulter et de rechercher des ressources Amazon EC2 et Amazon VPC dans AWS une seule région ou dans plusieurs régions simultanément sur une seule console. Pour de plus amples informations, veuillez consulter Amazon EC2 Global View (Amazon EC2 Global View).