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.
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
}
The following arguments are supported:
cluster_id
- (Optional) The OCID of the 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.The following attributes are exported:
esxi_host_collection
- The list of esxi_host_collection.The following attributes are exported:
billing_contract_end_date
- 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
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. The computeInstanceId
is the OCID of that Compute instance. current_sku
- (Deprecated) The billing option currently used by the ESXi host. ListSupportedSkus. Deprecated. Please use current_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. If nextSku
is null or empty, currentSku
continues to the next billing cycle. ListSupportedSkus. Deprecated. Please use next_commitment
instead.next_commitment
- 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.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.