Data Source: oci_ocvp_esxi_hosts
This data source provides the list of Esxi Hosts in Oracle Cloud Infrastructure Oracle Cloud VMware Solution service.
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.
Example Usage
data "oci_ocvp_esxi_hosts" "test_esxi_hosts" {
#Optional
cluster_id = oci_ocvp_cluster.test_cluster.id
compartment_id = var.compartment_id
compute_instance_id = oci_core_instance.test_instance.id
display_name = var.esxi_host_display_name
is_billing_donors_only = var.esxi_host_is_billing_donors_only
is_swap_billing_only = var.esxi_host_is_swap_billing_only
sddc_id = oci_ocvp_sddc.test_sddc.id
state = var.esxi_host_state
}
Argument Reference
The following arguments are supported:
cluster_id
- (Optional) The OCID of the SDDC Cluster.compartment_id
- (Optional) The OCID of the compartment as optional parameter.compute_instance_id
- (Optional) The OCID of the Compute instance.display_name
- (Optional) A filter to return only resources that match the given display name exactly.is_billing_donors_only
- (Optional) If this flag/param is set to True, we return only deleted hosts with LeftOver billingCycle.is_swap_billing_only
- (Optional) If this flag/param is set to True, we return only active hosts.sddc_id
- (Optional) The OCID of the SDDC.state
- (Optional) The lifecycle state of the resource.
Attributes Reference
The following attributes are exported:
esxi_host_collection
- The list of esxi_host_collection.
EsxiHost Reference
The following attributes are exported:
billing_contract_end_date
- Current billing cycle end date. If the value incurrentCommitment
andnextCommitment
are different, the value specified innextCommitment
becomes the newcurrentCommitment
when thecontractEndDate
is reached. Example:2016-08-25T21:10:29.600Z
billing_donor_host_id
- The OCID of the deleted ESXi Host with LeftOver billing cycle.capacity_reservation_id
- The OCID of the Capacity Reservation.cluster_id
- The OCID of the Cluster that the ESXi host belongs to.compartment_id
- The OCID of the compartment that contains the Cluster.compute_availability_domain
- The availability domain of the ESXi host.compute_instance_id
- In terms of implementation, an ESXi host is a Compute instance that is configured with the chosen bundle of VMware software. ThecomputeInstanceId
is the OCID of that Compute instance.current_sku
- (Deprecated) The billing option currently used by the ESXi host. ListSupportedSkus. Deprecated. Please usecurrent_commitment
instead.current_commitment
- The billing option currently used by the ESXi host. ListSupportedCommitments.defined_tags
- Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example:{"Operations.CostCenter": "42"}
display_name
- A descriptive name for the ESXi host. Does not have to be unique, and it’s changeable. Avoid entering confidential information.esxi_software_version
- The version of ESXi software that Oracle Cloud VMware Solution installed on the ESXi hosts.failed_esxi_host_id
- The OCID of the ESXi host that failed.freeform_tags
- 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. Example:{"Department": "Finance"}
grace_period_end_date
- The date and time when the new esxi host should start billing cycle. RFC3339. Example:2021-07-25T21:10:29.600Z
host_ocpu_count
- The OCPU count of the ESXi host.host_shape_name
- The compute shape name of the ESXi host. ListSupportedHostShapes.id
- The OCID of the ESXi host.is_billing_continuation_in_progress
- Indicates whether this host is in the progress of billing continuation.is_billing_swapping_in_progress
- Indicates whether this host is in the progress of swapping billing.next_sku
- (Deprecated) The billing option to switch to after the current billing cycle ends. IfnextSku
is null or empty,currentSku
continues to the next billing cycle. ListSupportedSkus. Deprecated. Please usenext_commitment
instead.next_commitment
- The billing option to switch to after the current billing cycle ends. IfnextCommitment
is null or empty,currentCommitment
continues to the next billing cycle. ListSupportedCommitments.non_upgraded_esxi_host_id
- The OCID of the ESXi host that will be upgraded.replacement_esxi_host_id
- The OCID of the esxi host that is newly created to replace the failed node.sddc_id
- The OCID of the SDDC that the ESXi host belongs to.state
- The current state of the ESXi host.swap_billing_host_id
- The OCID of the active ESXi Host to swap billing with current host.time_created
- The date and time the ESXi host was created, in the format defined by RFC3339. Example:2016-08-25T21:10:29.600Z
time_updated
- The date and time the ESXi host was updated, in the format defined by RFC3339.upgraded_replacement_esxi_host_id
- The OCID of the ESXi host that is newly created to upgrade the original host.vmware_software_version
- The version of VMware software that Oracle Cloud VMware Solution installed on the ESXi hosts.