Oracle Esxi Host API

openapi: 3.2.0
info:
  title: Oracle Esxi Host API
  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/20220518
- url: https://127.0.0.1/20220518
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
  /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
  /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'
  /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
  /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'
  /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'
  /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.
  /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
components:
  schemas:
    IncreaseHostOcpuCountDetails:
      description: The details of the OCPU count scaling operation.
      properties:
        hostOcpuCount:
          description: The host OCPU count to scale to.
          format: float
          minimum: 0
          type: number
      required:
      - hostOcpuCount
    DatastoreAttachment:
      description: 'The details about attachment of datastore

        '
      properties:
        blockVolumeId:
          description: The [OCID](/Content/General/Concepts/identifiers.htm) of the Block Volume that belongs to the datastore.
          maxLength: 255
          minLength: 1
          type: string
        datastoreId:
          description: 'The [OCIDs](/Content/General/Concepts/identifiers.htm) of the Datastore that ESXi host is attached to.

            '
          maxLength: 255
          minLength: 1
          type: string
        ipAddress:
          description: The IP address of datastore attachment.
          maxLength: 255
          minLength: 1
          type: string
        port:
          description: The port of datastore attachment.
          type: integer
        volumeIqn:
          description: An IQN of the Block Storage Volume.
          maxLength: 255
          minLength: 1
          type: string
      required:
      - blockVolumeId
      - volumeIqn
      - datastoreId
      - ipAddress
      - port
      type: object
    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, scoped to a namespace.


              Example: `{"CostCenter": "42"}`

              '
            type: object
          description: 'Defined tags for this resource. Each key is predefined and scoped to a

            namespace. For more information, see [Resource Tags](/Content/General/Concepts/resourcetags.htm).


            Example: `{"Operations": {"CostCenter": "42"}}`

            '
          type: object
        displayName:
          description: 'A descriptive name for the ESXi host. It''s changeable.

            Esxi Host name requirements are 1-16 character length limit, Must start with a letter, Must be English letters, numbers, - only, No repeating hyphens, Must be unique within the SDDC.


            Avoid entering confidential information.

            '
          maxLength: 16
          minLength: 1
          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. For more information, see [Resource Tags](/Content/General/Concepts/resourcetags.htm).


            Example: `{"Department": "Finance"}`

            '
          type: object
        nextSku:
          description: 'The billing option to switch to after the existing billing cycle ends.

            If `nextSku` is null or empty, `currentSku` continues to the next billing cycle.

            [ListSupportedSkus](#/en/vmware/20200501/SupportedSkuSummary/ListSupportedSkus).

            '
          enum:
          - HOUR
          - MONTH
          - ONE_YEAR
          - THREE_YEARS
          type: string
          x-obmcs-top-level-enum: '#/definitions/Sku'
      type: object
    EsxiHost:
      description: 'An ESXi host is a node in an SDDC. At a minimum, each SDDC has 3 ESXi hosts

        that are used to implement a functioning VMware environment.


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

        is configured with the chosen bundle of VMware software.


        Notice that an `EsxiHost` object has its own OCID (`id`), and a separate

        attribute for the OCID of the Compute instance (`computeInstanceId`).

        '
      properties:
        billingContractEndDate:
          description: 'Current billing cycle end date. If the value in `currentSku` and `nextSku` are different, the value specified in `nextSku`

            becomes the new `currentSKU` when the `contractEndDate` is reached.

            Example: `2016-08-25T21:10:29.600Z`

            '
          format: date-time
          type: string
        billingDonorHostId:
          description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the deleted ESXi Host with LeftOver billing cycle.

            '
          maxLength: 255
          minLength: 1
          type: string
        capacityReservationId:
          description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the Capacity Reservation.

            '
          maxLength: 255
          minLength: 1
          type: string
        compartmentId:
          description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the compartment that

            contains the SDDC.

            '
          type: string
        computeAvailabilityDomain:
          description: 'The availability domain of the ESXi host.

            '
          maxLength: 64
          minLength: 1
          type: string
        computeInstanceId:
          description: 'In terms of implementation, an ESXi host is a Compute instance that

            is configured with the chosen bundle of VMware software. The `computeInstanceId`

            is the [OCID](/Content/General/Concepts/identifiers.htm) of that Compute instance.

            '
          type: string
        currentSku:
          description: 'The billing option currently used by the ESXi host.

            [ListSupportedSkus](#/en/vmware/20200501/SupportedSkuSummary/ListSupportedSkus).

            '
          enum:
          - HOUR
          - MONTH
          - ONE_YEAR
          - THREE_YEARS
          type: string
          x-default-description: For ESXi host shapes supporting "MONTH" SKU, the default initialSku is "MONTH". For other shapes, the default initialSku is "HOUR".
          x-obmcs-top-level-enum: '#/definitions/Sku'
        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, scoped to a namespace.


              Example: `{"CostCenter": "42"}`

              '
            type: object
          description: 'Defined tags for this resource. Each key is predefined and scoped to a

            namespace. For more information, see [Resource Tags](/Content/General/Concepts/resourcetags.htm).


            Example: `{"Operations": {"CostCenter": "42"}}`

            '
          type: object
        displayName:
          description: 'A descriptive name for the ESXi host. Does not have to be unique, and it''s changeable.

            Avoid entering confidential information.

            '
          type: string
        failedEsxiHostId:
          description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the ESXi host that failed.

            '
          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. For more information, see [Resource Tags](/Content/General/Concepts/resourcetags.htm).


            Example: `{"Department": "Finance"}`

            '
          type: object
        gracePeriodEndDate:
          description: 'The date and time when the new esxi host should start billing cycle.

            [RFC3339](https://tools.ietf.org/html/rfc3339).

            Example: `2021-07-25T21:10:29.600Z`

            '
          format: date-time
          type: string
        hostOcpuCount:
          description: 'The OCPU count of the ESXi host.

            '
          format: float
          minimum: 0
          type: number
        hostShapeName:
          description: 'The compute shape name of the ESXi host.

            [ListSupportedHostShapes](#/en/vmware/20200501/SupportedHostShapes/ListSupportedHostShapes).

            '
          type: string
        id:
          description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the ESXi host.

            '
          type: string
        isBillingContinuationInProgress:
          default: false
          description: 'Indicates whether this host is in the progress of billing continuation.

            '
          type: boolean
        isBillingSwappingInProgress:
          default: false
          description: 'Indicates whether this host is in the progress of swapping billing.

            '
          type: boolean
        lifecycleDetails:
          description: 'The detailed lifecycle of the licenses of the resource.

            '
          type: string
        lifecycleState:
          description: The current state of the ESXi host.
          enum:
          - CREATING
          - UPDATING
          - ACTIVE
          - DELETING
          - DELETED
          - FAILED
          type: string
          x-obmcs-top-level-enum: '#/definitions/LifecycleStates'
        n

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