Filtro dei risultati della ricerca di risorse
Applicare i filtri per limitare un elenco di risultati delle risorse in base ai vari attributi delle risorse.
La modalità di filtro dei risultati da una ricerca di risorse dipende dalla modalità utilizzata per trovare i risultati.
La modalità di ricerca di base supporta diversi modi per filtrare i risultati della ricerca delle risorse tramite la console. È possibile utilizzare la casella di ricerca nella pagina oppure le intestazioni di colonna nell'elenco dei risultati. Questo argomento descrive come utilizzare la casella di ricerca nella pagina per accedere ai filtri, ma il funzionamento dei filtri nelle intestazioni di colonna nell'elenco dei risultati è lo stesso.
La modalità query avanzata supporta l'applicazione di filtri e l'ordinamento delle risorse mediante la sintassi del linguaggio di query. È possibile filtrare efficacemente i risultati aggiungendo o rimuovendo clausole o modificando il contenuto delle clausole. L'unica query che puoi eseguire che non filtra i risultati è una query per tutto. Nella console stessa non esistono filtri per i risultati restituiti da una query.
- Per impostazione predefinita, se sono presenti più stringhe con spazi tra loro in una ricerca di testo libero o in modalità di ricerca di base, la console trova le risorse contenenti qualsiasi stringa di ricerca. La ricerca non tenta di trovare risorse contenenti tutte le stringhe di ricerca. Per ulteriori informazioni sulle ricerche di testo libero, vedere Ricerca di testo libero.
- Per applicare filtri ai risultati, è possibile utilizzare la casella di ricerca nella pagina oppure le intestazioni di colonna in un elenco di risultati della ricerca. La console riflette eventuali modifiche ai filtri in entrambe le posizioni.
- Alcuni filtri includono tutti i possibili valori di attributo per impostazione predefinita. In altre parole, il filtro del compartimento include tutti i compartimenti nella ricerca fino a quando non si specificano i compartimenti da rimuovere dal filtro. Nel frattempo, altri filtri non corrispondono ai valori degli attributi per impostazione predefinita.
- È possibile cancellare i filtri. Per ulteriori informazioni, vedere Cancellazione dei filtri di ricerca delle risorse.
- È possibile modificare i filtri. Per ulteriori informazioni, vedere Modifica dei filtri di ricerca delle risorse.
- È possibile ordinare i risultati. Per ulteriori informazioni, vedere Ordinamento dei risultati della ricerca delle risorse.
Questi passi presuppongono di aver già eseguito una ricerca di testo libero e di aver selezionato la categoria di risultati Risorse in base alle istruzioni in Esecuzione di una ricerca di testo libero.
- Nella pagina Risorse, selezionare la casella di ricerca, quindi digitare o selezionare un tipo di risorsa o un attributo di risorsa da includere nei risultati della ricerca filtrata. Gli attributi disponibili dipendono dai tipi di risorsa nell'elenco dei risultati.
-
Eseguire una delle operazioni riportate di seguito.
- Se è stato selezionato un filtro che fornisce opzioni predefinite, selezionare l'opzione da un menu o selezionando una o più caselle di controllo.
- Se è stato selezionato un filtro che richiede di specificare il valore dell'attributo risorsa in cui confrontare i potenziali risultati della ricerca, selezionare la casella di filtro e immettere un valore appropriato. Nota: i filtri in cui è possibile immettere un valore personalizzato richiedono l'immissione di almeno tre caratteri prima di applicare il filtro.
- Se è stato selezionato il filtro Nome visualizzato o OCID, è possibile immettere un solo valore alla volta per uno dei due filtri.
- Se è stato selezionato il filtro Tag, selezionare prima il tipo di tag dalle opzioni di menu. Specificare quindi se si desidera abbinare qualsiasi valore o Specificare i valori corrispondenti. Infine, specificare il valore o i valori che si desidera corrispondano al filtro.
- Se è stato selezionato un filtro basato sull'ora, specificare Data di inizio, Ora di inizio, Data di fine e Ora di fine.
- Quando si è pronti, selezionare Applica filtro.
- (Facoltativo) Per aggiungere un altro filtro, ripetere i passi precedenti.
Utilizzare il comando oci search resource Structured-search e i parametri necessari per applicare i filtri quando si trovano le risorse:
oci search resource structured-search --query-text "<query_text_using_query_language_syntax>"Per un elenco completo dei parametri e dei valori per i comandi della CLI, vedere il manuale CLI Command Reference. Per informazioni sulla sintassi delle query, vedere Sintassi della lingua di ricerca.
Eseguire l'operazione SearchResources per utilizzare il linguaggio di query strutturato per filtrare le risorse.
Esempio: ricerca di tutti gli attributi risorsa di un tipo di risorsa che contiene una stringa specificaIn questa sezione viene descritto come utilizzare l'API per eseguire una query su tutti i campi indicizzati di un determinato tipo di risorsa per le corrispondenze a una stringa specifica.
La query seguente trova gli utenti con qualsiasi attributo che contiene "doe".
query user resources matching 'doe'Quando si utilizza l'operazione SearchResources per eseguire la query, la richiesta ha un aspetto simile al seguente. Questo esempio omette intenzionalmente l'intestazione di autorizzazione e altre intestazioni.
POST /20180409/resources Host: query.us-phoenix-1.oraclecloud.com <authorization and other headers> { "type": "Structured", "query": "query user resources matching 'doe'", "matchingContextType": "HIGHLIGHTS" }Se la query produce risultati, la risposta elenca le risorse che corrispondono al tipo di risorsa e alla tag specificati. La risposta ha un aspetto simile al seguente:
{ "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" : { } } ] }Con questi risultati, è possibile intraprendere ulteriori azioni, se necessario. Per ulteriori informazioni su un tipo di risorsa, ad esempio i relativi attributi, vedere la relativa pagina di riferimento nel manuale API Reference Guide. Per le pagine di riferimento dei tipi di risorsa indicizzati per la ricerca, vedere Risorse supportate.