Filtro de resultados de búsqueda de recursos
Aplique filtros para acotar una lista de resultados de recursos según varios atributos de recursos.
La forma de filtrar los resultados de una búsqueda de recursos depende del modo que utilice para buscar los resultados.
- Usar el cuadro de búsqueda en la página
- Utilizar las cabeceras de columna en la lista de resultados
En este tema se describe cómo utilizar el cuadro de búsqueda en la página para acceder a los filtros, pero los filtros de los encabezados de columna de la lista de resultados se comportan de la misma manera, si los tiene.
El modo de consulta avanzada admite el filtrado y la ordenación de recursos mediante la sintaxis del lenguaje de consulta. Puede filtrar los resultados de manera efectiva agregando o eliminando cláusulas o cambiando el contenido de las cláusulas. La única consulta que puede realizar que no filtre los resultados es una consulta para todo. El único filtro que existe en la consola para los resultados devueltos por una consulta es el filtro de región. El lenguaje de consulta no soporta la especificación de una región en la que buscar resultados.
- Por defecto, si tiene más de una cadena con espacios entre ellas en una búsqueda de texto libre o en modo de búsqueda básico, la consola busca recursos que contengan cualquier de las cadenas de búsqueda. La búsqueda no intenta encontrar recursos que contengan todas las cadenas de búsqueda. Para obtener más información sobre las búsquedas de texto libre, consulte Búsqueda de texto libre.
- En el modo básico, puede utilizar el cuadro de búsqueda en la página al trabajar con una lista de resultados de búsqueda para aplicar filtros a los resultados. Si está disponible, también puede utilizar los filtros en los encabezados de columna.
- Algunos filtros incluyen todos los valores de atributo posibles por defecto. A saber, el filtro de compartimento incluye todos los compartimentos de la búsqueda hasta que especifique los compartimentos que desea eliminar del filtro. Mientras tanto, otros filtros no coinciden con ningún valor de atributo por defecto.
- Puede borrar filtros. Para obtener más información, consulte Borrado de filtros de búsqueda de recursos.
- Puede cambiar los filtros. Para obtener más información, consulte Cambio de filtros de búsqueda de recursos.
- Puede ordenar los resultados. Para obtener más información, consulte Ordenación de resultados de búsqueda de recursos.
En estos pasos se asume que ya ha realizado una búsqueda de texto libre y ha seleccionado la categoría Recursos de resultados según las instrucciones de Realización de una Búsqueda de Texto Libre.
- En la página Recursos, seleccione el cuadro de búsqueda y, a continuación, escriba o seleccione un tipo de recurso o atributo de recurso para incluirlo en los resultados de búsqueda filtrados. (Los atributos disponibles dependen de los tipos de recursos de la lista de resultados).
-
A continuación, realice una de las siguientes acciones:
- Si ha seleccionado un filtro que proporciona opciones predefinidas, seleccione la opción en un menú o seleccionando una o más casillas de control.
- Si ha seleccionado un filtro que requiere que especifique el valor del atributo de recurso con el que comparar posibles resultados de búsqueda, seleccione el cuadro de filtro y escriba un valor adecuado. (Nota: los filtros en los que puede introducir un valor personalizado requieren que introduzca al menos tres caracteres antes de aplicar el filtro).
- Si ha seleccionado el filtro Nombre mostrado u OCID, solo puede introducir un valor a la vez para cualquiera de los filtros.
- Si ha seleccionado el filtro Etiqueta, seleccione primero el tipo de etiqueta en las opciones de menú. A continuación, especifique el valor o los valores que desea que coincida con el filtro. Por último, especifique si desea coincidir con cualquier valor o especificar valores coincidentes. (La información de la consola puede mostrarse en un orden diferente al que se presenta en este tema).
- Si ha seleccionado un filtro basado en la hora, especifique la fecha de inicio, la hora de inicio, la fecha de finalización y la hora de finalización.
- Cuando esté listo, seleccione Aplicar filtro.
- (Opcional) Para agregar otro filtro, repita los pasos anteriores.
Utilice el comando oci search resource Structured-search y los parámetros necesarios para aplicar filtros al buscar recursos:
oci search resource structured-search --query-text "<query_text_using_query_language_syntax>"
Para obtener una lista completa de parámetros y valores para los comandos de la CLI, consulte la Referencia de comandos de CLI. Para obtener información sobre la sintaxis de consultas, consulte Sintaxis de lenguaje de búsqueda.
Ejecute la operación SearchResources para utilizar el lenguaje de consulta estructurado para filtrar recursos.
Ejemplo: Búsqueda de todos los atributos de recursos de un tipo de recurso que contienen una cadena específicaEn esta sección se describe cómo utilizar la API para consultar todos los campos indexados de un tipo de recurso concreto para las coincidencias con una cadena específica.
La siguiente consulta busca usuarios con cualquier atributo que contenga "doe".
query user resources matching 'doe'
Al utilizar la operación SearchResources para emitir la consulta, la solicitud tiene un aspecto similar al siguiente. (En este ejemplo, se omite por completo la cabecera de autorización y otras cabeceras).
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 consulta genera resultados, la respuesta muestra los recursos que coinciden con el tipo de recurso y la etiqueta que especificó. La respuesta tiene el siguiente aspecto:
{ "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 estos resultados, puede realizar más acciones si es necesario. Para obtener más información sobre un tipo de recurso como, por ejemplo, sus atributos, consulte su página de referencia en la Guía de referencia de API. Para ver las páginas de referencia de los tipos de recursos que se han indexado para la búsqueda, consulte Recursos soportados.