Oracle Resource Search API

The ResourceSearch API from Oracle — 3 operation(s) for resourcesearch.

Documentation

📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/access-governance-cp/20220518/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/adm/20220421/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/advisor/20200606/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/ai-data-platform/20240831/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/analytics/20190331/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/announcements/0.0.1/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/api-gateway/20190501/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/apm-config/20210201/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/apm-control-plane/20200630/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/apm-synthetic-monitoring/20200630/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/apm-trace-explorer/20200630/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/audit/20190901/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/autoscaling/20181001/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/bastion/20210331/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/batch/20251031/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/bigdata/20190531/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/blockchain/20191010/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/budgets/20190111/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/certificates/20210224/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/certificatesmgmt/20210224/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/cloud-guard/20200131/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/clusterplacementgroups/20230801/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/compute-cloud-at-customer/20221208/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/container-instances/20210415/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/container-registry/20180419/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/containerengine/20180222/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/cost-anomaly/20190111/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/dashboard/20210731/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/data-catalog/20190325/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/data-flow/20200129/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/data-integration/20200430/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/data-safe/20181201/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/data-science/20190101/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/database-management/20201101/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/database-migration/20230518/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/database-multicloud-integrations/20240501/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/database-tools/20201005/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/database-tools-runtime/20230222/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/datacc/20251101/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/datalabeling-dp/20211001/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/datalabeling/20211001/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/delegate-access-control/20230801/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/devops/20210630/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/digital-assistant/20190506/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/disaster-recovery/20220125/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/dms/20211101/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/dns/20180115/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/document-understanding/20221109/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/edsfu/20220528/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/emaildelivery/20170907/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/emaildeliverysubmission/20220926/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/events/20181201/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/filestorage/20171215/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/fleet-management/20250228/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/functions/20181201/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/functionsdocgenpbf/1.0/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/fusion-applications/20211201/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/generative-ai-agents-client/20240531/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/generative-ai-agents/20240531/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/generative-ai-inference/20231130/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/generative-ai-nl2sql/20260325/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/generative-ai/20231130/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/generic/20160918/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/globally-distributed-database/20250101/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/goldengate/20200407/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/healthchecks/20180501/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/iaas/20160918/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/identity-domains/v1/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/identity-dp/v1/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/identity/20160918/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/incidentmanagement/20181231/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/instanceagent/20180530/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/integration/20190131/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/iot/20250531/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/itas/v1/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/jms-java-download/20230601/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/jms/20210610/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/jms-utils/20250521/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/kafka/20240901/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/key/release/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/language/20221001/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/licensemanager/20220430/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/limits-increase/20251101/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/limits/20181025/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/loadbalancer/20170115/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/logan-api-spec/20200601/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/logging-dataplane/20200831/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/logging-management/20200531/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/logging-search/20190909/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/lustre/20250228/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/managed-access/20220126/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/management-agent/20200202/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/managementdashboard/20200901/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/marketplace/20181001/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/mngdmac/20250320/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/monitoring/20180401/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/multicloud-omhub-cp/20180828/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/mysql/20190415/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/NetMonitor/20160918/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/network-firewall/20211001/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/network-firewall/20230501/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/networkloadbalancer/20200501/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/nosql-database/20190828/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/notification/20181201/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/objectstorage/20160918/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/OCB/20220509/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/occ/20230515/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/occds/20240430/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/occm/20231107/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/ocicache/20220315/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/ocm/20220919/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/opa/20210621/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/opensearch/20180828/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/operations-insights/20200630/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/operatoraccesscontrol/20200630/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/oracle-api-access-control/20241130/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/organizations/20230401/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/organizations/20200801/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/osmh/20220901/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/postgresql/20220915/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/psasvc/20240301/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/publisher/20241201/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/queue/20210201/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/recovery-service/20210216/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/registry/20160918/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/resource-analytics/20241031/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/resource-discovery-monitoring-control-api/20210330/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/resource-scheduler/20240430/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/resourcemanager/20180917/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/rover/20201210/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/s3objectstorage/20160918/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/scanning/20210215/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/search/20180409/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/secretmgmt/20180608/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/secretretrieval/20190301/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/secure-desktops/20220618/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/security-attribute/20240815/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/self/20260129/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/service-catalog/20210527/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/serviceconnectors/20200909/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/smp/20210914/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/speech/20220101/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/stack-monitoring/20210330/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/streaming/20180418/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/threat-intel/20220901/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/usage/20200107/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/usage-proxy/20190111/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/vision/20220125/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/visual-builder/20210601/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/visual-builder-studio/20180828/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/vmware/20200501/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/vmware/20230701/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/waa/20211230/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/waas/20181116/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/waf/20210930/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/wlms/20241101/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/workrequests/20160918/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/zero-trust-packet-routing/20240301/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/zero-trust-packet-routing-tools/20240301/

Specifications

OpenAPI Specification

oracle-resourcesearch-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  description: Search for resources in your cloud network.
  title: Search Service Resource Search API
  version: '20180409'
  x-provenance:
    method: harvested
    first_party: true
    publisher: Oracle
    source: https://docs.oracle.com/en-us/iaas/api/specs/b63d06c4cfd359bac0d6d407f3a255c7b03fc403937fe089ab94f759b40e16b1.yaml
    harvested: '2026-08-04'
    note: Published by Oracle as the contract for the Search Service API OCI service and stored verbatim; API Evangelist added only this provenance block.
  x-evidence:
  - url: https://docs.oracle.com/en-us/iaas/api/specs/index.json
    what: Oracle's own index of every OCI service specification
  - url: https://docs.oracle.com/en-us/iaas/api/specs/b63d06c4cfd359bac0d6d407f3a255c7b03fc403937fe089ab94f759b40e16b1.yaml
    what: the harvested document for Search Service API
servers:
- url: /20180409
tags:
- name: ResourceSearch
paths:
  /resourceTypes:
    get:
      description: 'Lists all resource types that you can search or query for.

        '
      operationId: ListResourceTypes
      parameters:
      - $ref: '#/components/parameters/PaginationLimitQueryParam'
      - $ref: '#/components/parameters/PaginationTokenQueryParam'
      - $ref: '#/components/parameters/TenantIdQueryParam'
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      responses:
        400:
          description: A bad request was made or the request is not supported for the current tenant.
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        401:
          description: User authentication has failed.
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        404:
          description: Not authorized or not found.
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        429:
          description: Too many requests.
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        500:
          description: Internal server error.
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        default:
          description: An error has occurred.
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '200':
          description: A page of search or query results.
          headers:
            opc-next-page:
              description: Pagination token
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/ResourceType'
                type: array
      summary: Lists the types of resources available for querying.
      tags:
      - ResourceSearch
      x-example: 'GET /20180409/resourceTypes

        Host: query.us-phoenix-1.oraclecloud.com

        <var>&lt;authorization and other headers&gt;</var>

        '
  /resourceTypes/{name}:
    get:
      description: 'Gets detailed information about a resource type by using the resource type name.

        '
      operationId: GetResourceType
      parameters:
      - $ref: '#/components/parameters/TenantIdQueryParam'
      - $ref: '#/components/parameters/ResourceNamePathParam'
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      responses:
        400:
          description: A bad request was made or the request is not supported for the current tenant.
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        401:
          description: User authentication has failed.
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        404:
          description: Not authorized or not found.
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        429:
          description: Too many requests.
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        500:
          description: Internal server error.
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        default:
          description: An error has occurred.
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '200':
          description: The resource type definition.
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceType'
      summary: Gets the resource type definition.
      tags:
      - ResourceSearch
      x-example: 'GET /20180409/resourceTypes/Vcn

        Host: query.us-phoenix-1.oraclecloud.com

        <var>&lt;authorization and other headers&gt;</var>

        '
  /resources:
    post:
      description: "Queries any and all compartments in the specified tenancy to find resources that match the specified criteria.\nResults include resources that you have permission to view and can span different resource types. \nYou can also sort results based on a specified resource attribute.\n"
      operationId: SearchResources
      parameters:
      - $ref: '#/components/parameters/PaginationLimitQueryParam'
      - $ref: '#/components/parameters/PaginationTokenQueryParam'
      - $ref: '#/components/parameters/TenantIdQueryParam'
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      responses:
        400:
          description: A bad request was made or the request is not supported for the current tenant.
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        401:
          description: User authentication has failed.
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        404:
          description: Not authorized or not found.
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        429:
          description: Too many requests.
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        500:
          description: Internal server error.
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        default:
          description: An error has occurred.
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '200':
          description: A page of search or query results.
          headers:
            opc-next-page:
              description: 'For pagination of a list of items. When paging through a list, if this header appears in the response, then there are additional items still to get. Include this value as the page parameter for the subsequent GET request. For information about pagination, see [ListPagination](https://docs.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).

                '
              schema:
                type: string
            opc-previous-page:
              description: 'For pagination of a list of items. When paging through a list, if this header appears in the response, then there are additional items in previous pages to get. Include this value as the page parameter for the subsequent GET request. The absence of this header indicates that you have reached the first page of the list. For more information, see [ListPagination](https://docs.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceSummaryCollection'
      summary: Finds resources in your cloud network.
      tags:
      - ResourceSearch
      x-example: "POST /20180409/resources\nHost: query.us-phoenix-1.oraclecloud.com\n<var>&lt;authorization and other headers&gt;</var>\n{\n  \"type\": \"FreeText\",\n  \"text\": \"jane\",\n  \"matchingContextType\": \"HIGHLIGHTS\"\n}\n"
      x-related-resource: '#/definitions/ResourceSummary'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SearchDetails'
        description: 'Request parameters that describe query criteria. For more information, see [SearchDetails](#/en/search/latest/datatypes/SearchDetails).

          '
        required: true
components:
  parameters:
    PaginationTokenQueryParam:
      description: The page at which to start retrieving results.
      in: query
      name: page
      x-default-description: 'null'
      schema:
        type: string
        maxLength: 1024
        minLength: 1
    ResourceNamePathParam:
      description: The name of the resource type.
      in: path
      name: name
      required: true
      schema:
        type: string
        minLength: 1
    TenantIdQueryParam:
      description: 'The tenancy ID, which can be used to specify a different tenancy (for cross-tenancy authorization) when searching for resources in a different tenancy.

        '
      in: query
      name: tenantId
      required: false
      x-default-description: 'null'
      schema:
        type: string
        minLength: 1
    PaginationLimitQueryParam:
      description: The maximum number of items to return. The value must be between 1 and 1000.
      in: query
      name: limit
      schema:
        type: integer
        default: 1000
        maximum: 1000
        minimum: 1
    OpcRequestIdHeaderParam:
      description: 'The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular

        request, please provide the complete request ID.

        '
      in: header
      name: opc-request-id
      schema:
        type: string
  schemas:
    SearchDetails:
      description: A base request type that contains common criteria for searching for resources.
      discriminator:
        propertyName: type
      properties:
        matchingContextType:
          description: 'The type of matching context returned in the response. If you specify `HIGHLIGHTS`, then the service will highlight fragments in its response. (For more information, see ResourceSummary.searchContext and SearchContext.) The default setting is `NONE`.

            '
          enum:
          - NONE
          - HIGHLIGHTS
          type: string
        type:
          description: The type of SearchDetails, whether `FreeText` or `Structured`.
          type: string
      required:
      - type
      type: object
      x-example: "{\n  \"type\": \"FreeText\",\n  \"text\": \"jane\",\n  \"matchingContextType\": \"HIGHLIGHTS\"\n}\n"
    SearchContext:
      description: Contains search context, such as highlighting, for found resources.
      properties:
        highlights:
          additionalProperties:
            items:
              type: string
            type: array
          description: "Describes what in each field matched the search criteria by showing highlighted values, but only for free text searches or for structured \nqueries that use a MATCHING clause. The list of strings represents fragments of values that matched the query conditions. Highlighted \nvalues are wrapped with &lt;h1&gt;..&lt;/h1&gt; tags. All values are HTML-encoded (except &lt;h1&gt; tags).\n"
          type: object
      type: object
      x-example: "{\n  \"searchContext\": {\n    \"highlights\": {\n      \"description\": [\n        \"Compartment for &lt;h1&gt;Jane&lt;/h1&gt; Doe to use\"\n      ]\n    }\n  }\n}\n"
    Error:
      description: The representation of an error.
      properties:
        code:
          description: 'A short error code that defines the error, meant for programmatic parsing. See [API Errors](/Content/API/References/apierrors.htm).

            '
          type: string
        message:
          description: A human-readable error string.
          type: string
      required:
      - code
      - message
      type: object
    ResourceType:
      description: Defines a type of resource that you can find with a search or query.
      properties:
        fields:
          description: 'List of all the fields and their value type that are indexed for querying.

            '
          items:
            $ref: '#/components/schemas/QueryableFieldDescription'
          type: array
        name:
          description: 'The unique name of the resource type, which matches the value returned as part of the ResourceSummary object.

            '
          type: string
      required:
      - name
      - fields
      type: object
      x-example: "[\n  {\n    \"fields\": [\n      {\n        \"fieldName\": \"freeformTags\", \n        \"fieldType\": \"OBJECT\", \n        \"isArray\": true, \n        \"objectProperties\": [\n          {\n            \"fieldName\": \"freeformTags.value\", \n            \"fieldType\": \"STRING\", \n            \"isArray\": false, \n            \"objectProperties\": null\n          }, \n          {\n            \"fieldName\": \"freeformTags.key\", \n            \"fieldType\": \"STRING\", \n            \"isArray\": false, \n            \"objectProperties\": null\n          }\n        ]\n      }, \n      {\n        \"fieldName\": \"displayName\", \n        \"fieldType\": \"STRING\", \n        \"isArray\": false, \n        \"objectProperties\": null\n      }, \n      {\n        \"fieldName\": \"definedTags\", \n        \"fieldType\": \"OBJECT\", \n        \"isArray\": true, \n        \"objectProperties\": [\n          {\n            \"fieldName\": \"definedTags.key\", \n            \"fieldType\": \"STRING\", \n            \"isArray\": false, \n            \"objectProperties\": null\n          }, \n          {\n            \"fieldName\": \"definedTags.namespace\", \n            \"fieldType\": \"STRING\", \n            \"isArray\": false, \n            \"objectProperties\": null\n          }, \n          {\n            \"fieldName\": \"definedTags.value\", \n            \"fieldType\": \"STRING\", \n            \"isArray\": false, \n            \"objectProperties\": null\n          }\n        ]\n      },\n      {\n        \"fieldName\": \"systemTags\",\n        \"fieldType\": \"OBJECT\",\n        \"isArray\": true,\n        \"objectProperties\": [\n          {\n            \"fieldName\": \"systemTags.key\",\n            \"fieldType\": \"STRING\",\n            \"isArray\": false,\n            \"objectProperties\": null\n          },\n          {\n            \"fieldName\": \"systemTags.namespace\",\n            \"fieldType\": \"STRING\",\n            \"isArray\": false,\n            \"objectProperties\": null\n          },\n          {\n            \"fieldName\": \"systemTags.value\",\n            \"fieldType\": \"STRING\",\n            \"isArray\": false,\n            \"objectProperties\": null\n          }\n        ]\n      },\n      {\n        \"fieldName\": \"lifecycleState\", \n        \"fieldType\": \"STRING\", \n        \"isArray\": false, \n        \"objectProperties\": null\n      }, \n      {\n        \"fieldName\": \"compartmentId\", \n        \"fieldType\": \"IDENTIFIER\", \n        \"isArray\": false, \n        \"objectProperties\": null\n      }, \n      {\n        \"fieldName\": \"availabilityDomain\", \n        \"fieldType\": \"STRING\", \n        \"isArray\": false, \n        \"objectProperties\": null\n      }, \n      {\n        \"fieldName\": \"timeLastIndexed\", \n        \"fieldType\": \"DATETIME\", \n        \"isArray\": false, \n        \"objectProperties\": null\n      }, \n      {\n        \"fieldName\": \"timeCreated\", \n        \"fieldType\": \"DATETIME\", \n        \"isArray\": false, \n        \"objectProperties\": null\n      }, \n      {\n        \"fieldName\": \"identifier\", \n        \"fieldType\": \"IDENTIFIER\", \n        \"isArray\": false, \n        \"objectProperties\": null\n      }, \n      {\n        \"fieldName\": \"cidrBlock\", \n        \"fieldType\": \"STRING\", \n        \"isArray\": false, \n        \"objectProperties\": null\n      }, \n      {\n        \"fieldName\": \"dnsLabel\", \n        \"fieldType\": \"STRING\", \n        \"isArray\": false, \n        \"objectProperties\": null\n      }, \n      {\n        \"fieldName\": \"vcnDomainName\", \n        \"fieldType\": \"STRING\", \n        \"isArray\": false, \n        \"objectProperties\": null\n      }\n    ], \n    \"name\": \"Vcn\"\n  },\n  ...\n]\n"
    ResourceSummaryCollection:
      description: A summary representation of resources that matched the search criteria.
      properties:
        items:
          description: A list of resources.
          items:
            $ref: '#/components/schemas/ResourceSummary'
          type: array
      type: object
      x-example: "{\n  \"items\": [\n    {\n      \"resourceType\": \"User\",\n      \"identifier\": \"ocid1.user.oc1..exampleavephoafuxcvbwb4t7dvik5m2ibuokweo6ofaux5pda7nxv2nwp3a\",\n      \"compartmentId\": \"ocidv1:tenancy:oc1:phx:1457636318783:examplea3lagrcvbljxg6mk55eo2fauxwy\",\n      \"timeCreated\": \"2016-12-12T19:31:03.749Z\",\n      \"displayName\": \"Jane.Doe\",\n      \"availabilityDomain\": null,\n      \"lifecycleState\": \"ACTIVE\",\n      \"freeformTags\": {},\n      \"definedTags\": {},\n      \"searchContext\": {\n        \"highlights\": {\n          \"description\": [\n            \"&lt;h1&gt;Jane&lt;/h1&gt; Doe's account\"\n          ]\n        }\n      }\n    },\n    {\n      \"resourceType\": \"Compartment\",\n      \"identifier\": \"ocid1.compartment.oc1..exampleaeug24qzjpmwcvb33f3zz5kdh2jpvzm52n5faux3nndh3diys7pca\",\n      \"compartmentId\": \"ocidv1:tenancy:oc1:phx:1457636318783:examplea3lagrcvbljxg6mk55eo2fauxwy\",\n      \"timeCreated\": \"2017-01-20T00:18:14.236Z\",\n      \"displayName\": \"JanesCompartment\",\n      \"availabilityDomain\": null,\n      \"lifecycleState\": \"ACTIVE\",\n      \"freeformTags\": {},\n      \"definedTags\": {},\n      \"searchContext\": {\n        \"highlights\": {\n          \"description\": [\n            \"Compartment for &lt;h1&gt;Jane&lt;/h1&gt; Doe to use\"\n          ]\n        }\n      }\n    }\n  ]\n}\n"
    QueryableFieldDescription:
      description: An individual field that can be used as part of a query filter.
      properties:
        fieldName:
          description: 'The name of the field to use when constructing the query. Field names are present for all types except `OBJECT`.

            '
          type: string
        fieldType:
          description: 'The type of the field, which dictates what semantics and query constraints you can use when searching or querying.

            '
          enum:
          - IDENTIFIER
          - STRING
          - INTEGER
          - RATIONAL
          - BOOLEAN
          - DATETIME
          - IP
          - OBJECT
          type: string
        isArray:
          description: 'Indicates that this field is actually an array of the specified field type.

            '
          type: boolean
        objectProperties:
          description: 'If the field type is `OBJECT`, then this property will provide all the individual properties of the object that can

            be queried.

            '
          items:
            $ref: '#/components/schemas/QueryableFieldDescription'
          type: array
      required:
      - fieldType
      - fieldName
      type: object
      x-example: "{\n  \"fieldName\": \"definedTags\", \n  \"fieldType\": \"OBJECT\", \n  \"isArray\": true, \n  \"objectProperties\": [\n    {\n      \"fieldName\": \"definedTags.key\", \n      \"fieldType\": \"STRING\", \n      \"isArray\": false, \n      \"objectProperties\": null\n    }, \n    {\n      \"fieldName\": \"definedTags.namespace\", \n      \"fieldType\": \"STRING\", \n      \"isArray\": false, \n      \"objectProperties\": null\n    }, \n    {\n      \"fieldName\": \"definedTags.value\", \n      \"fieldType\": \"STRING\", \n      \"isArray\": false, \n      \"objectProperties\": null\n    }\n  ]\n}\n\n  \n"
    ResourceSummary:
      description: A resource that exists in the cloud network that you're querying.
      properties:
        availabilityDomain:
          description: The availability domain where this resource exists, if applicable.
          type: string
        compartmentId:
          description: The OCID of the compartment that contains this resource.
          type: string
        definedTags:
          additionalProperties:
            additionalProperties:
              type: object
            type: object
          description: "Defined tags for this resource. Each key is predefined and scoped to a namespace. \nFor more information, see [Resource Tags](/Content/General/Concepts/resourcetags.htm). \nExample: `{\"Operations\": {\"CostCenter\": \"42\"}}`\n"
          type: object
        displayName:
          description: The display name (or name) of this resource, if one exists.
          type: string
        freeformTags:
          additionalProperties:
            type: string
          description: "Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. \nFor more information, see [Resource Tags](/Content/General/Concepts/resourcetags.htm). \nExample: `{\"Department\": \"Finance\"}`\n"
          type: object
        identifier:
          description: The unique identifier for this particular resource, usually an OCID.
          type: string
        identityContext:
          additionalProperties:
            type: object
          description: "Additional identifiers to use together in a \"Get\" request for a specified resource, only required for resource types \nthat explicitly cannot be retrieved by using a single identifier, such as the resource's OCID.\n"
          type: object
        lifecycleState:
          description: The lifecycle state of this resource, if applicable.
          type: string
        resourceType:
          description: The resource type name.
          type: string
        searchContext:
          $ref: '#/components/schemas/SearchContext'
        systemTags:
          additionalProperties:
            additionalProperties:
              type: object
            type: object
          description: 'System tags associated with this resource, if any. System tags are set by Oracle Cloud Infrastructure services. Each key is predefined and scoped to namespaces.

            For more information, see [Resource Tags](https://docs.oracle.com/iaas/Content/General/Concepts/resourcetags.htm).

            Example: `{orcl-cloud: {free-tier-retain: true}}`

            '
          type: object
        timeCreated:
          description: The time that this resource was created.
          format: date-time
          type: string
      required:
      - resourceType
      - identifier
      - compartmentId
      type: object
      x-example: "{\n  \"resourceType\": \"Compartment\",\n  \"identifier\": \"ocid1.compartment.oc1..exampleaeug24qzjpmwcvb33f3zz5kdh2jpvzm52n5faux3nndh3diys7pca\",\n  \"compartmentId\": \"ocidv1:tenancy:oc1:phx:1457636318783:examplea3lagrcvbljxg6mk55eo2fauxwy\",\n  \"timeCreated\": \"2017-01-20T00:18:14.236Z\",\n  \"displayName\": \"JanesCompartment\",\n  \"availabilityDomain\": null,\n  \"lifecycleState\": \"ACTIVE\",\n  \"freeformTags\": null,\n  \"definedTags\": null,\n  \"systemTags\": null,\n  \"additionalDetails\" : {\n    \"attachedVnic\" : [\n      {\n        \"publicIP\" : \"172.110.110.110\",\n        \"privateIP\" : \"10.10.10.10\",\n        \"isPrimary\" : true\n      },\n      {\n        \"publicIP\" : \"172.110.110.111\",\n        \"privateIP\" : \"10.10.10.11\",\n        \"isPrimary\" : false\n      }]\n  },\n  \"searchContext\": {\n    \"highlights\": {\n      \"description\": [\n        \"Compartment for &lt;h1&gt;Jane&lt;/h1&gt; Doe to use\"\n      ]\n    }\n  }\n}\n"
x-anchors:
  x-headers:
    opc-next-page:
      description: 'For pagination of a list of items. When paging through a list, if this header appears in the response, then there are additional items still to get. Include this value as the page parameter for the subsequent GET request. For information about pagination, see [ListPagination](https://docs.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).

        '
      type: string
    opc-previous-page:
      description: 'For pagination of a list of items. When paging through a list, if this header appears in the response, then there are additional items in previous pages to get. Include this value as the page parameter for the subsequent GET request. The absence of this header indicates that you have reached the first page of the list. For more information, see [ListPagination](https://docs.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).

        '
      type: string
    opc-request-id:
      description: 'Unique Oracle-assigned identifier for the request. If you need to contact

        Oracle about a particular request, please provide the request ID.

        '
      type: string
x-httpStatuses:
  400:
    description: A bad request was made or the request is not supported for the current tenant.
    headers:
      opc-request-id:
        description: 'Unique Oracle-assigned identifier for the request. If you need to contact

          Oracle about a particular request, please provide the request ID.

          '
        type: string
    schema:
      $ref: '#/components/schemas/Error'
  401:
    description: User authentication has failed.
    headers:
      opc-request-id:
        description: 'Unique Oracle-assigned identifier for the request. If you need to contact

          Oracle about a particular request, please provide the request ID.

          '
        type: string
    schema:
      $ref: '#/components/schemas/Error'
  404:
    description: Not authorized or not found.
    headers

# --- truncated at 32 KB (33 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/oracle/refs/heads/main/openapi/oracle-resourcesearch-api-openapi.yml