Documentación de Oracle Cloud Infrastructure

Ejecución de una consulta personalizada de formato libre

Las consultas de formato libre permiten personalizar una búsqueda de recursos mediante un lenguaje de consulta estructurado que puede especificar condiciones, atributos de recursos y valores de recursos que desee de los resultados.

Las consultas soportan el filtrado y la ordenación de recursos mediante la sintaxis del lenguaje de consulta. Puede filtrar los resultados de manera eficaz agregando o eliminando cláusulas o cambiando el contenido de las cláusulas. La única consulta que puede realizar que no filtra los resultados es una consulta para todo.

Para obtener más información sobre la sintaxis de consultas de recursos avanzadas, consulte Sintaxis de lenguaje de búsqueda.

    1. En la barra de navegación superior, seleccione Buscar recursos, servicios, documentación y Marketplace y, a continuación, seleccione Consulta de recursos avanzada.

    2. En el cuadro de texto de consulta, introduzca una consulta que se ajuste a la sintaxis del lenguaje de consulta y, a continuación, seleccione Buscar. Para obtener más información sobre la sintaxis, consulte Search Language Syntax.

    3. Si es necesario, cambie las regiones que desea buscar: junto a Aplicado actualmente, seleccione Regiones, active la casilla de control situada junto a hasta tres regiones que desea incluir y, a continuación, seleccione Aplicar filtro.

    4. Para filtrar aún más los resultados, cambie el idioma de la consulta.

      Nota

      En el modo de consulta avanzada, aunque puede filtrar y ordenar los resultados cambiando el lenguaje de consulta, no puede filtrar ni ordenar los resultados por la lista de resultados que se muestra en la consola. Además, si cambia al modo de consulta avanzada desde el modo de búsqueda básica, por defecto, los resultados se ordenan por el momento en que se creó el recurso. Puede cambiar la ordenación de los resultados por la mejor coincidencia eliminando la cláusula sorted by en el lenguaje de consulta.

    Los resultados son finalmente coherentes, pero es posible que no incluyan de forma inmediata los recursos creados recientemente. Si no ve los resultados esperados, puede cambiar a una región diferente o editar la consulta.

  • Utilice el comando oci search resource Struct-search y los parámetros necesarios para utilizar el lenguaje de consulta estructurado para 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 buscar recursos.

    Ejemplo: búsqueda de recursos de instancia con una etiqueta definida específica

    En esta sección se describe cómo utilizar la API para consultar un tipo específico de recurso basado en las etiquetas definidas del recurso.

    La siguiente consulta busca instancias con una etiqueta definida en el espacio de nombres "rqs", donde la clave de la etiqueta es "centro de costos" y el valor de la clave es "1234".

    query
 instance resources
 where
 (definedTags.namespace = 'rqs' && definedTags.key = 'costcenter' && definedTags.value = '1234')

    Al utilizar la operación SearchResources para emitir la consulta, la solicitud tendrá 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 instance resources where (definedTags.namespace = 'rqs' && definedTags.key = 'costcenter' && definedTags.value = '1234')",
  "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" : "Instance",
    "identifier" : "ocid1.instance.oc1.phx.exampleawcbfhncvbh3siw2svbpgr3bopovy6hgnywfauxqo37ckdmr6hjya",
    "compartmentId" : "ocid1.tenancy.oc1..examplea46vssm7l5wsk5qa7cvbl63ctajep4bh6lv4vaifauxz6ec7jzg4q",
    "timeCreated" : "2018-10-31T22:48:47.855Z",
    "displayName" : "service-pkgs",
    "availabilityDomain" : "ABCd:PHX-AD-1",
    "lifecycleState" : "RUNNING",
    "freeformTags" : { },
    "definedTags" : {
      "rqs" : {
        "costcenter" : "1234"
      }
    },
    "searchContext" : null
  }, {
    "resourceType" : "Instance",
    "identifier" : "ocid1.instance.oc1.phx.exampleanb3poce6z4omcvbzw66epp3pvbbww6hq7e2jfaux2lxvi3daxhra",
    "compartmentId" : "ocid1.compartment.oc1..examplea43m3udlwrzwmbcvbk5hm3umk2khgfhjcgdttawjlfauxuqwsjiya",
    "timeCreated" : "2018-10-09T23:35:30.167Z",
    "displayName" : "prod-test",
    "availabilityDomain" : "ABCd:PHX-AD-2",
    "lifecycleState" : "RUNNING",
    "freeformTags" : { },
    "definedTags" : {
      "rqs" : {
        "costcenter" : "1234"
      }
    },
    "searchContext" : null
  }, {
    "resourceType" : "Instance",
    "identifier" : "ocid1.instance.oc1.phx.examples7cz4z6b5hpdly2cvb56obhaiy4gvh2hdpz4akq4fauxpakvlqgya",
    "compartmentId" : "ocid1.tenancy.oc1..examplea46vssm7l5wsk5qa7cvbl63ctajep4bh6lv4fauxf4iz6ec7jzg4q",
    "timeCreated" : "2018-06-12T19:45:24.945Z",
    "displayName" : "BackupTest",
    "availabilityDomain" : "ABCd:PHX-AD-3",
    "lifecycleState" : "STOPPED",
    "freeformTags" : { },
    "definedTags" : {
      "rqs" : {
        "costcenter" : "1234"
      }
    },
    "searchContext" : null
  }, {
    "resourceType" : "Instance",
    "identifier" : "ocid1.compartment.oc1..exampleaexfjsiad7gbi6r4hvmcvbk3a5hgkvutlswf54ulfauxks4p2jasq",
    "compartmentId" : "ocid1.tenancy.oc1..examplea46vssm7l5cvb5qa7gg5l63ctajep4bh6lv4fauxf4iz6ec7jzg4q",
    "timeCreated" : "2018-06-12T19:25:16.942Z",
    "displayName" : "personal_abc",
    "availabilityDomain" : "ABCd:PHX-AD-2",
    "lifecycleState" : "TERMINATED",
    "freeformTags" : { },
    "definedTags" : {
      "rqs" : {
        "costcenter" : "1234"
      }
    },
    "searchContext" : null
  }, {
    "resourceType" : "Instance",
    "identifier" : "ocid1.compartment.oc1..examplealrskzczjqmrb3cvbj4yxdvqxahhffauxtu24tk5dhikoff4uliha",
    "compartmentId" : "ocid1.tenancy.oc1..examplea46vssm7l5wsk5qa7gg5l63cvbjep4bh6lv4fauxf4iz6ec7jzg4q",
    "timeCreated" : "2018-11-29T23:40:29.005Z",
    "displayName" : "test_unused",
    "availabilityDomain" : null,
    "lifecycleState" : "AVAILABLE",
    "freeformTags" : { },
    "definedTags" : {
      "rqs" : {
        "costcenter" : "1234"
      }
    },
    "searchContext" : null
  } ]
}

    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.