Filtre des résultats de recherche de ressources
Appliquez des filtres pour affiner la liste des résultats de ressource en fonction des différents attributs de ressource.
La façon dont vous filtrez les résultats d'une recherche de ressources dépend du mode utilisé pour rechercher les résultats.
- Utiliser la zone de recherche dans la page
- Utiliser les en-têtes de colonne dans la liste de résultats
Cette rubrique explique comment utiliser la zone de recherche dans la page pour accéder aux filtres, mais les filtres dans les en-têtes de colonne de la liste de résultats se comportent de la même manière, si vous les avez.
Le mode de requête avancé prend en charge le filtrage et le tri des ressources via la syntaxe du langage de requête. Vous pouvez filtrer les résultats en ajoutant ou en supprimant des clauses ou en modifiant le contenu des clauses. La seule requête que vous pouvez effectuer et qui ne filtre pas les résultats est une requête pour tout. Le seul filtre qui existe dans la console elle-même pour les résultats renvoyés par une requête est le filtre de région. Le langage de requête ne prend pas en charge la spécification d'une région dans laquelle rechercher des résultats.
- Par défaut, si plusieurs chaînes sont séparées par des espaces dans une recherche en texte libre ou en mode de recherche de base, la console recherche les ressources contenant l'une des chaînes de recherche. La recherche n'essaie pas de trouver des ressources contenant toutes les chaînes de recherche. Pour plus d'informations sur les recherches de texte libre, voir Recherche de texte libre.
- En mode de base, vous pouvez utiliser la zone de recherche dans la page lorsque vous utilisez une liste de résultats de recherche pour appliquer des filtres aux résultats. Si disponible, vous pouvez également utiliser les filtres dans les en-têtes de colonne.
- Certains filtres incluent toutes les valeurs d'attribut possibles par défaut. A savoir, le filtre de compartiment inclut tous les compartiments de la recherche jusqu'à ce que vous indiquiez les compartiments à enlever du filtre. Pendant ce temps, les autres filtres ne correspondent à aucune valeur d'attribut par défaut.
- Vous pouvez effacer les filtres. Pour plus d'informations, voir Effacement des filtres de recherche de ressource.
- Vous pouvez modifier les filtres. Pour plus d'informations, reportez-vous à Modification des filtres de recherche de ressource.
- Vous pouvez trier les résultats. Pour plus d'informations, reportez-vous à la rubrique Tri des résultats de recherche de ressource.
Ces étapes supposent que vous avez déjà effectué une recherche en texte libre et sélectionné la catégorie de résultats Ressources conformément aux instructions de la section Exécution d'une recherche en texte libre.
- Sur la page Ressources, sélectionnez la zone de recherche, puis saisissez ou sélectionnez un type de ressource ou un attribut de ressource à inclure dans les résultats de la recherche filtrée. (Les attributs disponibles dépendent des types de ressource dans la liste des résultats.)
-
Effectuez ensuite l'une des opérations suivantes :
- Si vous avez sélectionné un filtre qui fournit des options prédéfinies, sélectionnez l'option dans un menu ou en cochant une ou plusieurs cases.
- Si vous avez sélectionné un filtre pour lequel vous devez spécifier la valeur de l'attribut de ressource à laquelle comparer les résultats de recherche potentiels, sélectionnez le champ Filtre et saisissez une valeur appropriée. (Remarque : pour les filtres dans lesquels vous pouvez entrer une valeur personnalisée, vous devez saisir au moins trois caractères avant d'appliquer le filtre.)
- Si vous avez sélectionné le filtre Nom d'affichage ou OCID, vous ne pouvez saisir qu'une seule valeur à la fois pour l'un ou l'autre des filtres.
- Si vous avez sélectionné le filtre Balise, sélectionnez d'abord le type de balise dans les options de menu. Indiquez ensuite la ou les valeurs auxquelles le filtre doit correspondre. Enfin, indiquez si vous souhaitez Mettre en correspondance une valeur ou Indiquer des valeurs correspondantes. (Les informations de la console peuvent être affichées dans un ordre différent de celui présenté dans cette rubrique.)
- Si vous avez sélectionné un filtre basé sur l'heure, indiquez la date de début, l'heure de début, la date de fin et l'heure de fin.
- Lorsque vous êtes prêt, sélectionnez Appliquer un filtre.
- (Facultatif) Pour ajouter un autre filtre, répétez les étapes précédentes.
Utilisez la commande oci search resource structured-search et les paramètres requis pour appliquer des filtres lors de la recherche de ressources :
oci search resource structured-search --query-text "<query_text_using_query_language_syntax>"Pour obtenir la liste complète des paramètres et des valeurs des commandes d'interface de ligne de commande, reportez-vous à Référence de commande d'interface de ligne de commande. Pour plus d'informations sur la syntaxe des requêtes, reportez-vous à Syntaxe de langage de recherche.
Exécutez l'opération SearchResources pour utiliser le langage de requête structurée afin de filtrer les ressources.
Exemple : recherche de tous les attributs de ressource d'un type de ressource contenant une chaîne spécifiqueCette section explique comment utiliser l'API pour interroger tous les champs indexés d'un type de ressource particulier pour rechercher des correspondances avec une chaîne spécifique.
La requête suivante recherche les utilisateurs dont les attributs contiennent "doe".
query user resources matching 'doe'Lorsque vous utilisez l'opération SearchResources pour exécuter la requête, celle-ci ressemble à la suivante. (Cet exemple omet volontairement l'en-tête d'autorisation et d'autres en-têtes.)
POST /20180409/resources Host: query.us-phoenix-1.oraclecloud.com <authorization and other headers> { "type": "Structured", "query": "query user resources matching 'doe'", "matchingContextType": "HIGHLIGHTS" }Si la requête génère des résultats, la réponse répertorie les ressources correspondant au type de ressource et à la balise que vous avez spécifiés. La réponse ressemble à ce qui suit :
{ "items" : [ { "resourceType" : "User", "identifier" : "ocid1.user.oc1..examplea26nj4iqy2mbfauxovw5viuyblsbdn3p6cvbdmbrjtalxgjqdnemq", "compartmentId" : "ocid1.tenancy.oc1..exampleagkbzgg6lpzrf47xzy4rjoxg4de6nfaux2rncmjiujvy2cvbxvziq", "timeCreated" : "2020-12-10T14:41:02.185Z", "displayName" : "janedoe", "availabilityDomain" : "ABCd:PHX-AD-3", "lifecycleState" : "ACTIVE", "freeformTags" : { }, "definedTags" : { }, "systemTags" : { }, "searchContext" : { "highlights" : { "displayName" : [ "<hl>janedoe</hl>" ], "name" : [ "<hl>janejdoe</hl>" ], "description" : [ "Jane <hl>Doe</hl> - <hl>jane.doe</hl>@example.com" ] } }, "identityContext" : { }, "additionalDetails" : { } }, { "resourceType" : "User", "identifier" : "ocid1.user.oc1..examplea27jaoic76zube2d6faux5hch5fsj36qetod474g57cvbhguoegfa", "compartmentId" : "ocid1.tenancy.oc1..exampleagkbzgg6lpzrf47xzy4rjoxg4de6nfaux2rncmjiujvy2cvbxvziq", "timeCreated" : "2022-09-22T15:14:44.285Z", "displayName" : "sdoerner", "availabilityDomain" : "ABCd:PHX-AD-3", "lifecycleState" : "ACTIVE", "freeformTags" : { }, "definedTags" : { }, "systemTags" : { }, "searchContext" : { "highlights" : { "displayName" : [ "<hl>sdoerner</hl>" ], "name" : [ "<hl>sdoerner</hl>" ], "description" : [ "Scott <hl>Doerner</hl> - <hl>scott.doerner</hl>@example.com" ] } }, "identityContext" : { }, "additionalDetails" : { } }, { "resourceType" : "User", "identifier" : "ocid1.user.oc1..examplea2agbfauxqj57pwe2txjdc6mjdkcncdt5m5bmcvbbzznxzscixd7a", "compartmentId" : "ocid1.tenancy.oc1..exampleagkbzgg6lpzrf47xzy4rjoxg4de6nfaux2rncmjiujvy2cvbxvziq", "timeCreated" : "2020-09-11T22:00:26.311Z", "displayName" : "patdoerr", "availabilityDomain" : "ABCd:PHX-AD-2", "lifecycleState" : "ACTIVE", "freeformTags" : { }, "definedTags" : { }, "systemTags" : { }, "searchContext" : { "highlights" : { "displayName" : [ "<hl>patdoerr</hl>" ], "name" : [ "<hl>patdoerr</hl>" ], "description" : [ "Pat <hl>Doerr</hl> - <hl>pat.doerr</hl>@example.com" ] } }, "identityContext" : { }, "additionalDetails" : { } } ] }Avec ces résultats, vous pouvez effectuer d'autres actions, si nécessaire. Pour plus d'informations sur un type de ressource, comme ses attributs, reportez-vous à sa page de référence dans le guide de référence d'API. Pour les pages de référence des types de ressource indexés pour le service Search, reportez-vous à Ressources prises en charge.