find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/oracle-esxihost-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Oracle Esxi Host API
  x-refined-note:
  - x-evidence differs across the merged source definitions and was not carried
  - x-provenance differs across the merged source definitions and was not carried
  version: '1.0'
  description: 'Operations tagged esxiHost across 2 of this provider''s published API definitions: oci-vmware-1-openapi.yaml, oci-vmware-openapi.yaml. Each path carries the servers of the definition it was published in.'
servers:
- url: http://127.0.0.1/20200501
- url: https://127.0.0.1/20200501
- url: http://127.0.0.1/20230701
- url: https://127.0.0.1/20230701
tags:
- name: esxiHost
paths:
  /esxiHosts:
    get:
      description: 'Lists the ESXi hosts in the specified SDDC. The list can be filtered

        by Compute instance OCID or ESXi display name.


        Remember that in terms of implementation, an ESXi host is a Compute instance that

        is configured with the chosen bundle of VMware software. Each `EsxiHost`

        object has its own OCID (`id`), and a separate attribute for the OCID of

        the Compute instance (`computeInstanceId`). When filtering the list of

        ESXi hosts, you can specify the OCID of the Compute instance, not the

        ESXi host OCID.

        '
      operationId: ListEsxiHosts
      parameters:
      - $ref: '#/components/parameters/SddcIdentifierQueryParam'
      - $ref: '#/components/parameters/ComputeInstanceIdentifierQueryParam'
      - $ref: '#/components/parameters/DisplayNameQueryParam'
      - $ref: '#/components/parameters/PaginationLimitQueryParam'
      - $ref: '#/components/parameters/PaginationTokenQueryParam'
      - $ref: '#/components/parameters/SortOrderQueryParam'
      - $ref: '#/components/parameters/SortByQueryParam'
      - $ref: '#/components/parameters/RequestIdHeader'
      - $ref: '#/components/parameters/LifecycleState'
      - $ref: '#/components/parameters/DeletedDonorHostQueryParam'
      - $ref: '#/components/parameters/ActiveDonorHostQueryParam'
      - $ref: '#/components/parameters/CompartmentIdOptionalQueryParam'
      responses:
        200:
          description: The list is being retrieved.
          headers:
            Sunset:
              description: Sunset date when this operation will stop working, in <HTTP-date> format, e.g. "Wed, 21 Jun 2023 11:11:11 GMT"
              schema:
                type: string
            opc-next-page:
              description: 'For list pagination. When this header appears in the response, additional pages

                of results remain. For important details about how pagination works, see

                [List Pagination](/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/EsxiHostCollection'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/default'
      summary: Lists the ESXi hosts in the specified SDDC
      tags:
      - esxiHost
      x-related-resource: '#/definitions/EsxiHostSummary'
    post:
      description: 'Adds another ESXi host to an existing SDDC. The attributes of the specified

        `Sddc` determine the VMware software and other configuration settings used

        by the ESXi host.


        Use the [WorkRequest](#/en/vmware/20200501/WorkRequest/) operations to track the

        creation of the ESXi host.

        '
      operationId: CreateEsxiHost
      parameters:
      - $ref: '#/components/parameters/RetryTokenHeader'
      - $ref: '#/components/parameters/RequestIdHeader'
      responses:
        202:
          description: The request was accepted and the ESXi host will be created.
          headers:
            Sunset:
              description: Sunset date when this operation will stop working, in <HTTP-date> format, e.g. "Wed, 21 Jun 2023 11:11:11 GMT"
              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
            opc-work-request-id:
              description: 'Unique Oracle-assigned identifier for the asynchronous request. You can use this to query status of the asynchronous operation.

                '
              schema:
                type: string
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        409:
          $ref: '#/components/responses/409'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/default'
      summary: Creates an ESXi host
      tags:
      - esxiHost
      x-related-resource: '#/definitions/EsxiHost'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateEsxiHostDetails'
        description: Details for the ESXi host.
        required: true
    servers:
    - url: http://127.0.0.1/20200501
    - url: https://127.0.0.1/20200501
  /esxiHosts/{esxiHostId}:
    delete:
      description: 'Deletes the specified ESXi host. Before deleting the host, back up or

        migrate any VMware workloads running on it.


        When you delete an ESXi host, Oracle does not remove the node

        configuration within the VMware environment itself. That is

        your responsibility.


        **Note:** If you delete EXSi hosts from the SDDC to total less than 3,

        you are still billed for the 3 minimum recommended EXSi hosts. Also,

        you cannot add more VMware workloads to the SDDC until it again has at

        least 3 ESXi hosts.


        Use the [WorkRequest](#/en/vmware/20200501/WorkRequest/) operations to track the

        deletion of the ESXi host.

        '
      operationId: DeleteEsxiHost
      parameters:
      - $ref: '#/components/parameters/EsxiHostIdentifierPathParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/RequestIdHeader'
      responses:
        202:
          description: The request was accepted and the ESXi host will be deleted.
          headers:
            Sunset:
              description: Sunset date when this operation will stop working, in <HTTP-date> format, e.g. "Wed, 21 Jun 2023 11:11:11 GMT"
              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
            opc-work-request-id:
              description: 'Unique Oracle-assigned identifier for the asynchronous request. You can use this to query status of the asynchronous operation.

                '
              schema:
                type: string
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/default'
      summary: Deletes the specified ESXi host
      tags:
      - esxiHost
      x-related-resource: '#/definitions/EsxiHost'
    get:
      description: Gets the specified ESXi host's information.
      operationId: GetEsxiHost
      parameters:
      - $ref: '#/components/parameters/EsxiHostIdentifierPathParam'
      - $ref: '#/components/parameters/RequestIdHeader'
      responses:
        200:
          description: The ESXi host was retrieved.
          headers:
            Sunset:
              description: Sunset date when this operation will stop working, in <HTTP-date> format, e.g. "Wed, 21 Jun 2023 11:11:11 GMT"
              schema:
                type: string
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              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/EsxiHost'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/default'
      summary: Gets the specified ESXi host's information
      tags:
      - esxiHost
    put:
      description: Updates the specified ESXi host.
      operationId: UpdateEsxiHost
      parameters:
      - $ref: '#/components/parameters/EsxiHostIdentifierPathParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/RequestIdHeader'
      responses:
        200:
          description: The ESXi host was updated.
          headers:
            Sunset:
              description: Sunset date when this operation will stop working, in <HTTP-date> format, e.g. "Wed, 21 Jun 2023 11:11:11 GMT"
              schema:
                type: string
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              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/EsxiHost'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/default'
      summary: Updates the specified ESXi host
      tags:
      - esxiHost
      x-related-resource: '#/definitions/EsxiHost'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateEsxiHostDetails'
        description: The information to be updated.
        required: true
    servers:
    - url: http://127.0.0.1/20200501
    - url: https://127.0.0.1/20200501
  /esxiHosts/{esxiHostId}/actions/acknowledgeLicenseReplacement:
    post:
      description: Acknowledge the replacement of ESXi host licenses.
      operationId: AcknowledgeEsxiHostLicenseReplacement
      parameters:
      - $ref: '#/components/parameters/EsxiHostIdentifierPathParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/RequestIdHeader'
      - $ref: '#/components/parameters/RetryTokenHeader'
      responses:
        200:
          description: The replacement of ESXi host licenses was acknowledged.
          headers:
            Sunset:
              description: Sunset date when this operation will stop working, in <HTTP-date> format, e.g. "Wed, 21 Jun 2023 11:11:11 GMT"
              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
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        409:
          $ref: '#/components/responses/409'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/default'
      summary: Acknowledge the replacement of ESXi host licenses.
      tags:
      - esxiHost
      x-obmcs-terraform:
        actionType: UPDATE_FIELD
      x-related-resource: '#/definitions/EsxiHost'
    servers:
    - url: http://127.0.0.1/20200501
    - url: https://127.0.0.1/20200501
  /esxiHosts/{esxiHostId}/actions/increaseHostOcpuCount:
    post:
      description: Increase the OCPU count of the specified ESXi host.
      operationId: IncreaseHostOcpuCount
      parameters:
      - $ref: '#/components/parameters/EsxiHostIdentifierPathParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/RequestIdHeader'
      - $ref: '#/components/parameters/RetryTokenHeader'
      responses:
        202:
          description: The request was accepted to increase host OCPU count.
          headers:
            Sunset:
              description: Sunset date when this operation will stop working, in <HTTP-date> format, e.g. "Wed, 21 Jun 2023 11:11:11 GMT"
              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
            opc-work-request-id:
              description: 'Unique Oracle-assigned identifier for the asynchronous request. You can use this to query status of the asynchronous operation.

                '
              schema:
                type: string
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        409:
          $ref: '#/components/responses/409'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/default'
      summary: Increase the OCPU count of the specified ESXi host
      tags:
      - esxiHost
      x-obmcs-terraform:
        actionType: UPDATE_FIELD
      x-related-resource: '#/definitions/EsxiHost'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/IncreaseHostOcpuCountDetails'
        description: The details of the OCPU count scaling operation.
        required: true
    servers:
    - url: http://127.0.0.1/20200501
    - url: https://127.0.0.1/20200501
  /esxiHosts/{esxiHostId}/actions/swapBilling:
    post:
      description: 'Swap billing between two Active ESXi hosts.

        '
      operationId: SwapBilling
      parameters:
      - $ref: '#/components/parameters/EsxiHostIdentifierPathParam'
      - $ref: '#/components/parameters/SwapBillingEsxiHostIdentifierQueryParam'
      - $ref: '#/components/parameters/RetryTokenHeader'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/RequestIdHeader'
      responses:
        202:
          description: The request was accepted and the billing will be swapped.
          headers:
            Sunset:
              description: Sunset date when this operation will stop working, in <HTTP-date> format, e.g. "Wed, 21 Jun 2023 11:11:11 GMT"
              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
            opc-work-request-id:
              description: 'Unique Oracle-assigned identifier for the asynchronous request. You can use this to query status of the asynchronous operation.

                '
              schema:
                type: string
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        409:
          $ref: '#/components/responses/409'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/default'
      summary: Swap billing between two Active ESXi hosts.
      tags:
      - esxiHost
      x-obmcs-terraform:
        actionType: SPECIAL_UPDATE
      x-related-resource: '#/definitions/EsxiHost'
    servers:
    - url: http://127.0.0.1/20200501
    - url: https://127.0.0.1/20200501
  /esxiHostByComputeInstanceId/{computeInstanceId}:
    get:
      description: Gets ESXi host's information from provided compute instance Id.
      operationId: GetEsxiHostByComputeInstanceId
      parameters:
      - $ref: '#/components/parameters/ComputeInstanceIdentifierPathParam'
      - $ref: '#/components/parameters/RequestIdHeader_2'
      responses:
        200:
          description: The ESXi host was retrieved.
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              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/EsxiHost_2'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/default_2'
      summary: Gets ESXi host's information from provided compute instance Id.
      tags:
      - esxiHost
      x-related-resource: '#/definitions/EsxiHost'
    servers:
    - url: http://127.0.0.1/20230701
    - url: https://127.0.0.1/20230701
  /esxiHosts/{esxiHostId}/actions/inplaceUpgrade:
    post:
      description: 'In-place upgrade a ESXi host.

        '
      operationId: InplaceUpgrade
      parameters:
      - $ref: '#/components/parameters/EsxiHostIdentifierPathParam'
      - $ref: '#/components/parameters/RetryTokenHeader'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/RequestIdHeader_2'
      responses:
        202:
          description: The request was accepted and the in-place upgrade initiated.
          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
            opc-work-request-id:
              description: 'Unique Oracle-assigned identifier for the asynchronous request. You can use this to query status of the asynchronous operation.

                '
              schema:
                type: string
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        409:
          $ref: '#/components/responses/409'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/default_2'
      summary: In-place upgrade a ESXi host.
      tags:
      - esxiHost
      x-obmcs-terraform:
        actionType: UPDATE_FIELD
      x-related-resource: '#/definitions/EsxiHost'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InplaceUpgradeDetails'
        description: The details for upgrading ESXi host.
    servers:
    - url: http://127.0.0.1/20230701
    - url: https://127.0.0.1/20230701
  /esxiHosts/{esxiHostId}/actions/replaceHost:
    post:
      description: 'Replace a faulty ESXi host whose underlying bare metal is broken

        '
      operationId: ReplaceHost
      parameters:
      - $ref: '#/components/parameters/EsxiHostIdentifierPathParam'
      - $ref: '#/components/parameters/RetryTokenHeader'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/RequestIdHeader_2'
      responses:
        202:
          description: The request was accepted and the host replacement initiated.
          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
            opc-work-request-id:
              description: 'Unique Oracle-assigned identifier for the asynchronous request. You can use this to query status of the asynchronous operation.

                '
              schema:
                type: string
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        409:
          $ref: '#/components/responses/409'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/default_2'
      summary: Replace a faulty ESXi host whose underlying bare metal is broken
      tags:
      - esxiHost
      x-obmcs-terraform:
        actionType: UPDATE_FIELD
      x-related-resource: '#/definitions/EsxiHost'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReplaceHostDetails'
        description: The details for replacing ESXi host
        required: true
    servers:
    - url: http://127.0.0.1/20230701
    - url: https://127.0.0.1/20230701
components:
  parameters:
    SddcIdentifierQueryParam:
      description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the SDDC.

        '
      in: query
      name: sddcId
      required: false
      x-default-description: 'null'
      schema:
        type: string
    SortByQueryParam:
      description: 'The field to sort by. You can provide one sort order (`sortOrder`). Default order for

        TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME

        sort order is case sensitive.


        **Note:** In general, some "List" operations (for example, `ListInstances`) let you

        optionally filter by availability domain if the scope of the resource type is within a

        single availability domain. If you call one of these "List" operations without specifying

        an availability domain, the resources are grouped by availability domain, then sorted.

        '
      in: query
      name: sortBy
      schema:
        type: string
        enum:
        - timeCreated
        - displayName
        default: timeCreated
    ActiveDonorHostQueryParam:
      description: 'If this flag/param is set to True, we return only active hosts.

        '
      in: query
      name: isSwapBillingOnly
      required: false
      x-default-description: 'null'
      schema:
        type: boolean
        default: false
    ComputeInstanceIdentifierQueryParam:
      description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the Compute instance.

        '
      in: query
      name: computeInstanceId
      required: false
      x-default-description: 'null'
      schema:
        type: string
    CompartmentIdOptionalQueryParam:
      description: The [OCID](/Content/General/Concepts/identifiers.htm) of the compartment as optional parameter.
      in: query
      name: compartmentId
      required: false
      schema:
        type: string
    SwapBillingEsxiHostIdentifierQueryParam:
      description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the active ESXi Host to swap billing with current host.

        '
      in: query
      name: swapBillingHostId
      required: true
      x-default-description: 'null'
      schema:
        type: string
    EsxiHostIdentifierPathParam:
      description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the ESXi host.

        '
      in: path
      name: esxiHostId
      required: true
      schema:
        type: string
    SortOrderQueryParam:
      description: 'The sort order to use, either ascending (`ASC`) or descending (`DESC`). The DISPLAYNAME sort order

        is case sensitive.

        '
      in: query
      name: sortOrder
      x-obmcs-top-level-enum: '#/definitions/SortOrders'
      schema:
        type: string
        enum:
        - ASC
        - DESC
        default: ASC
    LifecycleState:
      description: The lifecycle state of the resource.
      in: query
      name: lifecycleState
      required: false
      x-default-description: 'null'
      x-obmcs-top-level-enum: '#/definitions/LifecycleStates'
      schema:
        type: string
        enum:
        - CREATING
        - UPDATING
        - ACTIVE
        - DELETING
        - DELETED
        - FAILED
    RequestIdHeader:
      description: The client request ID for tracing.
      in: header
      name: opc-request-id
      schema:
        type: string
    DeletedDonorHostQueryParam:
      description: 'If this flag/param is set to True, we return only deleted hosts with LeftOver billingCycle.

        '
      in: query
      name: isBillingDonorsOnly
      required: false
      x-default-description: 'null'
      schema:
        type: boolean
        default: false
    PaginationTokenQueryParam:
      description: 'For list pagination. The value of the `opc-next-page` response header from the previous "List"

        call. For important details about how pagination works, see

        [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).

        '
      in: query
      name: page
      x-default-description: 'null'
      schema:
        type: string
        maxLength: 1024
        minLength: 1
    DisplayNameQueryParam:
      description: A filter to return only resources that match the given display name exactly.
      in: query
      name: displayName
      x-default-description: 'null'
      schema:
        type: string
        maxLength: 255
        minLength: 1
    RetryTokenHeader:
      description: 'A token that uniquely identifies a request so it can be retried in case of a timeout or

        server error without risk of executing that same action again. Retry tokens expire after 24

        hours, but can be invalidated before then due to conflicting operations (for example, if a resource

        has been deleted and purged from the system, then a retry of the original creation request

        may be rejected).

        '
      in: header
      name: opc-retry-token
      required: false
      schema:
        type: string
        maxLength: 64
        minLength: 1
    PaginationLimitQueryParam:
      description: 'For list pagination. The maximum number of results per page, or items to return in a paginated

        "List" call. For important details about how pagination works, see

        [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).

        '
      in: query
      name: limit
      x-default-description: 'null'
      schema:
        type: integer
        default: 10
        maximum: 1000
        minimum: 1
    IfMatchHeader:
      description: 'For optimistic concurrency control. In the PUT or DELETE call

        for a resource, set the `if-match` parameter to the value of the

        etag from a previous GET or POST response for that resource.

        The resource will be updated or deleted only if the etag you

        provide matches the resource''s current etag value.

        '
      in: header
      name: if-match
      required: false
      schema:
        type: string
    ClusterIdentifierQueryParam:
      description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the SDDC Cluster.

        '
      in: query
      name: clusterId
      required: false
      x-default-description: 'null'
      schema:
        type: string
    BillingTransferCommitmentQueryParam:
      description: 'A filter to return the source ESXi hosts that can transfer billing to the selected target ESXi host commitment.

        '
      in: query
      name: billingTransferCommitment
      required: false
      x-default-description: 'null'
      x-obmcs-top-level-enum: '#/definitions/Commitment'
      schema:
        type: string
        enum:
        - HOUR
        - MONTH
        - ONE_YEAR
        - THREE_YEARS
        maxLength: 255
        minLength: 1
    ComputeInstanceIdentifierPathParam:
      description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the Compute instance.

        '
      in: path
      name: computeInstanceId
      required: true
      schema:
        type: string
    RequestIdHeader_2:
      description: 'Unique identifier for the request. If you need to contact Oracle about a particular

        request, please provide the request ID.

        '
      in: header
      name: opc-request-id
      schema:
        type: string
    BillingTransferOcpuCountQueryParam:
      description: 'A filter to return the source ESXi hosts that can transfer billing to the selected target ESXi host Ocpu count.

        '
      in: query
      name: billingTransferOcpuCount
      required: false
      x-default-description: 'null'
      schema:
        type: number
        format: float
        minimum: 0
    BillingTransferShapeNameQueryParam:
      description: 'A filter to return the source ESXi hosts that can transfer billing to the selected target ESXi host shape.

        '
      in: query
      name: billingTransferShapeName
      required: false
      x-default-description: 'null'
      schema:
        type: string
        maxLength: 255
        minLength: 1
  schemas:
    UpdateEsxiHostDetails:
      description: The ESXi host information to be updated.
      properties:
        billingDonorHostId:
          description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the deleted ESXi Host with LeftOver billing cycle.

            '
          maxLength: 255
          minLength: 1
          type: string
        definedTags:
          additionalProperties:
            additionalProperties:
              description: 'The value of the tag. Only the String type is supported.

                '
              type: object
            description: 'Key-value pair representing a defined tag key and value

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