Oracle Cloud VMware Solution: EsxiHost¶
Manage OCI Oracle Cloud VMware Solution resources from Kubernetes. This page is generated from checked-in package metadata, CRD schemas, and sample manifests.
Resource Snapshot¶
| Field | Value |
|---|---|
| Service | ocvp |
| Resource | EsxiHost |
| API Version | ocvp.oracle.com/v1beta1 |
| Package | Oracle Cloud VMware Solution |
| Support Status | Preview |
| Latest Released Version | v2.1.0-alpha |
| Install Namespace | oci-service-operator-ocvp-system |
Quick Links¶
- Resource Guide Index
- Setup Guide
- Package Page
- API Reference
- Spec Reference
- Status Reference
- Rendered Sample (
config/samples/ocvp_v1beta1_esxihost.yaml)
Spec Fields¶
This summary shows the top-level spec fields. Use the full API reference for nested fields, defaults, and enum values.
| Field | Description | Type | Required |
|---|---|---|---|
billingDonorHostId |
The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the deleted ESXi Host with LeftOver billing cycle. | string |
No |
capacityReservationId |
The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the Capacity Reservation. | string |
No |
clusterId |
The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the Cluster to add the ESXi host to. | string |
Yes |
computeAvailabilityDomain |
The availability domain to create the ESXi host in. If keep empty, for AD-specific Cluster, new ESXi host will be created in the same availability domain; for multi-AD Cluster, new ESXi host will be auto assigned to the next availability domain following evenly distribution strategy. | string |
No |
currentCommitment |
The billing option currently used by the ESXi host. ListSupportedCommitments. | string |
No |
definedTags |
Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags (https://docs.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: {"Operations": {"CostCenter": "42"}} |
map[string, map[string, string]] |
No |
displayName |
A descriptive name for the ESXi host. It's changeable. Esxi Host name requirements are 1-25 character length limit, Must start with a letter, Must be English letters, numbers, - only, No repeating hyphens, Must be unique within the Cluster. If this attribute is not specified, the Cluster's instanceDisplayNamePrefix attribute is used to name and incrementally number the ESXi host. For example, if you're creating the fourth ESXi host in the Cluster, and instanceDisplayNamePrefix is MyCluster, the host's display name is MyCluster-4. Avoid entering confidential information. |
string |
No |
esxiSoftwareVersion |
The ESXi software bundle to install on the ESXi host. Only versions under the same vmwareSoftwareVersion and have been validate by Oracle Cloud VMware Solution will be accepted. To get a list of the available versions, use ListSupportedVmwareSoftwareVersions. | string |
No |
freeformTags |
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 (https://docs.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: {"Department": "Finance"} |
map[string, string] |
No |
hostOcpuCount |
The OCPU count of the ESXi host. | number |
No |
hostShapeName |
The compute shape name of the ESXi host. ListSupportedHostShapes. | string |
No |
isVsanByolEnabled |
Indicates whether this host embedded VMware vSAN with BYOL Allocation. | boolean |
No |
nextCommitment |
The billing option to switch to after the existing billing cycle ends. If nextCommitment is null or empty, currentCommitment continues to the next billing cycle. ListSupportedCommitments. |
string |
No |
vcfByolAllocationId |
The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the Byol Allocation for VCF (VMware Cloud Foundation) deployment. | string |
No |
Status Fields¶
This summary shows the top-level status fields. Use the full API reference for nested fields, defaults, and enum values.
| Field | Description | Type | Required |
|---|---|---|---|
billingContractEndDate |
Current billing cycle end date. If the value in currentCommitment and nextCommitment are different, the value specified in nextCommitment becomes the new currentCommitment when the contractEndDate is reached. Example: 2016-08-25T21:10:29.600Z |
string |
No |
billingDonorHostId |
The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the deleted ESXi Host with LeftOver billing cycle. | string |
No |
capacityReservationId |
The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the Capacity Reservation. | string |
No |
clusterId |
The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the Cluster that the ESXi host belongs to. | string |
No |
compartmentId |
The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment that contains the Cluster. | string |
No |
computeAvailabilityDomain |
The availability domain of the ESXi host. | string |
No |
computeInstanceId |
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 (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of that Compute instance. |
string |
No |
currentCommitment |
The billing option currently used by the ESXi host. ListSupportedCommitments. | string |
No |
datastoreAttachments |
List of DatastoreAttachment objects containing information about attachment details | list[object] |
No |
datastoreClusterIds |
A list of datastore clusters. | list[string] |
No |
definedTags |
Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags (https://docs.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: {"Operations": {"CostCenter": "42"}} |
map[string, map[string, string]] |
No |
displayName |
A descriptive name for the ESXi host. Does not have to be unique, and it's changeable. Avoid entering confidential information. | string |
No |
esxiSoftwareVersion |
The version of ESXi software that Oracle Cloud VMware Solution installed on the ESXi hosts. | string |
No |
failedEsxiHostId |
The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the ESXi host that failed. | string |
No |
freeformTags |
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 (https://docs.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: {"Department": "Finance"} |
map[string, string] |
No |
gracePeriodEndDate |
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 |
string |
No |
hostOcpuCount |
The OCPU count of the ESXi host. | number |
No |
hostShapeName |
The compute shape name of the ESXi host. ListSupportedHostShapes. | string |
No |
id |
The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the ESXi host. | string |
No |
isBillingContinuationInProgress |
Indicates whether this host is in the progress of billing continuation. | boolean |
No |
isBillingSwappingInProgress |
Indicates whether this host is in the progress of swapping billing. | boolean |
No |
isVsanByolEnabled |
Indicates whether this host embedded VMware vSAN with BYOL Allocation. | boolean |
No |
lifecycleState |
The current state of the ESXi host. | string |
No |
nextCommitment |
The billing option to switch to after the current billing cycle ends. If nextCommitment is null or empty, currentCommitment continues to the next billing cycle. ListSupportedCommitments. |
string |
No |
nonUpgradedEsxiHostId |
The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the ESXi host that will be upgraded. | string |
No |
primaryVnicMacAddress |
MAC address of ESXi host's compute instance primary VNIC. | string |
No |
replacementEsxiHostId |
The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the ESXi host that is created to replace the failed host. | string |
No |
sddcId |
The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the SDDC that the ESXi host belongs to. | string |
No |
status |
- | object |
Yes |
swapBillingHostId |
The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the active ESXi Host to swap billing with current host. | string |
No |
systemTags |
Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {orcl-cloud: {free-tier-retain: true}} |
map[string, map[string, string]] |
No |
timeCreated |
The date and time the ESXi host was created, in the format defined by RFC3339 (https://tools.ietf.org/html/rfc3339). Example: 2016-08-25T21:10:29.600Z |
string |
No |
timeUpdated |
The date and time the ESXi host was updated, in the format defined by RFC3339 (https://tools.ietf.org/html/rfc3339). | string |
No |
upgradedReplacementEsxiHostId |
The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the ESXi host that is newly created to upgrade the original host. | string |
No |
vcfByolAllocationId |
The OCID (https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the Byol Allocation for VCF (VMware Cloud Foundation) deployment. | string |
No |
vmwareSoftwareVersion |
The version of VMware software that Oracle Cloud VMware Solution installed on the ESXi hosts. | string |
No |
Sample Manifest¶
This example is generated from the checked-in sample manifest at config/samples/ocvp_v1beta1_esxihost.yaml. Replace placeholder values before applying it.
#
# Copyright (c) 2021, Oracle and/or its affiliates. All rights reserved.
# Licensed under the Universal Permissive License v 1.0 as shown at http://oss.oracle.com/licenses/upl.
#
apiVersion: ocvp.oracle.com/v1beta1
kind: EsxiHost
metadata:
name: esxihost-sample
spec: {}