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.
- Utilizza la casella di ricerca nella pagina
- Utilizzare le intestazioni di colonna nell'elenco dei risultati
In questo argomento viene descritto come utilizzare la casella di ricerca nella pagina per accedere ai filtri, ma se disponibili, i filtri nelle intestazioni di colonna nell'elenco dei risultati funzionano allo stesso modo.
La modalità di query avanzata supporta l'applicazione di filtri e l'ordinamento delle risorse tramite la sintassi del linguaggio di query. È possibile filtrare i risultati aggiungendo o rimuovendo clausole o modificando il contenuto delle clausole. L'unica query che è possibile eseguire che non filtra i risultati è una query per tutto. L'unico filtro esistente nella console per i risultati restituiti da una query è il filtro dell'area. Il linguaggio di query non supporta la specifica di un'area in cui trovare i risultati.
- 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.
- In modalità base, è possibile utilizzare la casella di ricerca nella pagina quando si utilizza un elenco di risultati della ricerca per applicare filtri ai risultati. Se disponibili, è anche possibile utilizzare i filtri nelle intestazioni di colonna.
- 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 innanzitutto il tipo di tag dalle opzioni di menu. Specificare quindi il valore o i valori che si desidera corrispondano al filtro. Infine, specificare se si desidera abbinare qualsiasi valore o specificare i valori corrispondenti. Le informazioni nella console potrebbero essere visualizzate in un ordine diverso da quello illustrato in questo argomento.
- Se è stato selezionato un filtro basato sull'ora, specificare la data di inizio, l'ora di inizio, la data di fine e l'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.