Filtrando Resultados da Pesquisa de Recurso
Aplique filtros para restringir uma lista de resultados de recursos de acordo com vários atributos de recursos.
A forma como você filtra os resultados de uma pesquisa de recursos depende do modo usado para localizar os resultados.
- Usar a caixa de pesquisa na página
- Usar os cabeçalhos de coluna na lista de resultados
Este tópico descreve como usar a caixa de pesquisa na página para acessar filtros, mas os filtros nos cabeçalhos de coluna na lista de resultados se comportarão da mesma maneira, se você os tiver.
O modo de consulta avançada suporta a filtragem e a classificação de recursos por meio da sintaxe da linguagem de consulta. Você filtra os resultados efetivamente adicionando ou removendo cláusulas ou alterando o conteúdo das cláusulas. A única consulta que você pode executar que não filtra resultados é uma consulta para tudo. O único filtro existente na própria Console para resultados retornados por uma consulta é o filtro de região. A linguagem de consulta não suporta a especificação de uma região na qual os resultados serão localizados.
- Por padrão, se você tiver mais de uma string com espaços entre elas em uma pesquisa de texto livre ou no modo de pesquisa básica, a Console localizará recursos contendo qualquer das strings de pesquisa. A pesquisa não tenta localizar recursos que contenham todas as strings de pesquisa. Para obter mais informações sobre pesquisas de texto livre, consulte Pesquisa de Texto Livre.
- No modo básico, você pode usar a caixa de pesquisa na página ao trabalhar com uma lista de resultados de pesquisa para aplicar filtros aos resultados. Se disponível, você também pode usar os filtros em cabeçalhos de coluna.
- Alguns filtros incluem todos os valores de atributo possíveis por padrão. Ou seja, o filtro de compartimento inclui todos os compartimentos na pesquisa até que você especifique compartimentos a serem removidos do filtro. Enquanto isso, outros filtros não correspondem a nenhum valor de atributo por padrão.
- Você pode limpar os filtros. Para obter mais informações, consulte Removendo Filtros de Pesquisa de Recursos.
- Você não pode alterar filtros. Para obter mais informações, consulte Alterando Filtros de Pesquisa de Recursos.
- Você pode classificar os resultados. Para obter mais informações, consulte Classificando Resultados da Pesquisa de Recursos.
Essas etapas supõem que você já tenha executado uma pesquisa de texto livre e selecionado a categoria de resultados Recursos de acordo com as instruções em Executando uma Pesquisa de Texto Livre.
- Na página Recursos, selecione a caixa de pesquisa e digite ou selecione um tipo de recurso ou atributo de recurso a ser incluído nos resultados da pesquisa filtrada. (Os atributos disponíveis dependem dos tipos de recursos na lista de resultados.)
-
Em seguida, execute um dos seguintes procedimentos:
- Se você selecionou um filtro que fornece opções predefinidas, selecione a opção em um menu ou marcando uma ou mais caixas de seleção.
- Se você selecionou um filtro que exige que você especifique o valor do atributo de recurso com o qual comparar possíveis resultados de pesquisa, selecione a caixa de filtro e insira um valor apropriado. (Observação: os filtros nos quais você pode informar um valor personalizado exigem que você informe pelo menos três caracteres antes de aplicar o filtro.)
- Se você selecionou o filtro Nome para exibição ou OCID, só poderá informar um valor de cada vez para qualquer um dos filtros.
- Se você selecionou o filtro Tag, primeiro selecione o tipo de tag nas opções de menu. Em seguida, especifique o valor ou os valores que você deseja que o filtro corresponda. Por fim, especifique se deseja Corresponder a qualquer valor ou Especificar valores correspondentes. (As informações na Console podem ser mostradas em uma ordem diferente da apresentada neste tópico.)
- Se você selecionou um filtro baseado em tempo, especifique a Data inicial, a Hora inicial, a Data final e a Hora final.
- Quando estiver pronto, selecione Aplicar filtro.
- (Opcional) Para adicionar outro filtro, repita as etapas anteriores.
Use o comando oci search resource Structured-search e os parâmetros necessários para aplicar filtros ao localizar recursos:
oci search resource structured-search --query-text "<query_text_using_query_language_syntax>"Para obter uma lista completa dos parâmetros e valores dos comandos da CLI, consulte a Referência de Comandos da CLI. Para obter informações sobre a sintaxe de consultas, consulte Sintaxe de Idioma do Serviço Search.
Execute a operação SearchResources para usar a linguagem de consulta estruturada para filtrar recursos.
Exemplo: Localizando Todos os Atributos de Recursos de um Tipo de Recurso que Contém uma String EspecíficaEsta seção descreve como usar a API para consultar todos os campos indexados de um tipo de recurso específico para correspondências a uma string específica.
A consulta a seguir localiza usuários com quaisquer atributos que contenham "doe".
query user resources matching 'doe'Quando você usar a operação SearchResources para emitir a consulta, a solicitação será semelhante à seguinte. (Este exemplo omite intencionalmente o cabeçalho de autorização e outros cabeçalhos.)
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 a consulta produzir resultados, a resposta lista os recursos que correspondem ao tipo de recurso e à tag que você especificou. A resposta parece semelhante à seguinte:
{ "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" : { } } ] }Com esses resultados, você pode executar mais ações, se necessário. Para obter mais informações sobre um tipo de recurso, como seus atributos, consulte sua página de referência no Guia de Referência da API. Para obter as páginas de referência dos tipos de recursos que foram indexados para o serviço Search, consulte Recursos Suportados.