Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. Ocvp
  5. EsxiHost
Oracle Cloud Infrastructure v2.33.0 published on Thursday, May 1, 2025 by Pulumi
pulumi/pulumi-oci

oci.Ocvp.EsxiHost

Explore with Pulumi AI

oci logo
Oracle Cloud Infrastructure v2.33.0 published on Thursday, May 1, 2025 by Pulumi
pulumi/pulumi-oci

    Import

    EsxiHosts can be imported using the id, e.g.

    $ pulumi import oci:Ocvp/esxiHost:EsxiHost test_esxi_host "id"

    Create EsxiHost Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new EsxiHost(name: string, args?: EsxiHostArgs, opts?: CustomResourceOptions);
    @overload
def EsxiHost(resource_name: str,
             args: Optional[EsxiHostArgs] = None,
             opts: Optional[ResourceOptions] = None)

@overload
def EsxiHost(resource_name: str,
             opts: Optional[ResourceOptions] = None,
             billing_donor_host_id: Optional[str] = None,
             capacity_reservation_id: Optional[str] = None,
             cluster_id: Optional[str] = None,
             compute_availability_domain: Optional[str] = None,
             current_sku: Optional[str] = None,
             defined_tags: Optional[Mapping[str, str]] = None,
             display_name: Optional[str] = None,
             esxi_software_version: Optional[str] = None,
             failed_esxi_host_id: Optional[str] = None,
             freeform_tags: Optional[Mapping[str, str]] = None,
             host_ocpu_count: Optional[float] = None,
             host_shape_name: Optional[str] = None,
             next_sku: Optional[str] = None,
             non_upgraded_esxi_host_id: Optional[str] = None,
             sddc_id: Optional[str] = None)
    func NewEsxiHost(ctx *Context, name string, args *EsxiHostArgs, opts ...ResourceOption) (*EsxiHost, error)
    public EsxiHost(string name, EsxiHostArgs? args = null, CustomResourceOptions? opts = null)
    public EsxiHost(String name, EsxiHostArgs args)
public EsxiHost(String name, EsxiHostArgs args, CustomResourceOptions options)

    type: oci:Ocvp:EsxiHost
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args EsxiHostArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args EsxiHostArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args EsxiHostArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args EsxiHostArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args EsxiHostArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var esxiHostResource = new Oci.Ocvp.EsxiHost("esxiHostResource", new()
{
    CapacityReservationId = "string",
    ClusterId = "string",
    ComputeAvailabilityDomain = "string",
    DefinedTags = 
    {
        { "string", "string" },
    },
    DisplayName = "string",
    EsxiSoftwareVersion = "string",
    FreeformTags = 
    {
        { "string", "string" },
    },
    HostOcpuCount = 0,
    HostShapeName = "string",
});

    example, err := ocvp.NewEsxiHost(ctx, "esxiHostResource", &ocvp.EsxiHostArgs{
	CapacityReservationId:     pulumi.String("string"),
	ClusterId:                 pulumi.String("string"),
	ComputeAvailabilityDomain: pulumi.String("string"),
	DefinedTags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	DisplayName:         pulumi.String("string"),
	EsxiSoftwareVersion: pulumi.String("string"),
	FreeformTags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	HostOcpuCount: pulumi.Float64(0),
	HostShapeName: pulumi.String("string"),
})

    var esxiHostResource = new EsxiHost("esxiHostResource", EsxiHostArgs.builder()
    .capacityReservationId("string")
    .clusterId("string")
    .computeAvailabilityDomain("string")
    .definedTags(Map.of("string", "string"))
    .displayName("string")
    .esxiSoftwareVersion("string")
    .freeformTags(Map.of("string", "string"))
    .hostOcpuCount(0.0)
    .hostShapeName("string")
    .build());

    esxi_host_resource = oci.ocvp.EsxiHost("esxiHostResource",
    capacity_reservation_id="string",
    cluster_id="string",
    compute_availability_domain="string",
    defined_tags={
        "string": "string",
    },
    display_name="string",
    esxi_software_version="string",
    freeform_tags={
        "string": "string",
    },
    host_ocpu_count=0,
    host_shape_name="string")

    const esxiHostResource = new oci.ocvp.EsxiHost("esxiHostResource", {
    capacityReservationId: "string",
    clusterId: "string",
    computeAvailabilityDomain: "string",
    definedTags: {
        string: "string",
    },
    displayName: "string",
    esxiSoftwareVersion: "string",
    freeformTags: {
        string: "string",
    },
    hostOcpuCount: 0,
    hostShapeName: "string",
});

    type: oci:Ocvp:EsxiHost
properties:
    capacityReservationId: string
    clusterId: string
    computeAvailabilityDomain: string
    definedTags:
        string: string
    displayName: string
    esxiSoftwareVersion: string
    freeformTags:
        string: string
    hostOcpuCount: 0
    hostShapeName: string

    EsxiHost Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The EsxiHost resource accepts the following input properties:

    BillingDonorHostId string
    (Optional) (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.

    Deprecated: This 'billing_donor_host_id' argument has been deprecated and will be computed only.

    CapacityReservationId string
    The OCID of the Capacity Reservation.
    ClusterId string
    The OCID of the Cluster to add the ESXi host to.
    ComputeAvailabilityDomain string
    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.
    CurrentSku string
    (Optional) The billing option currently used by the ESXi host. It is only effective during resource creation. Changes to its value after creation will be ignored. ListSupportedSkus. Deprecated. Please use current_commitment instead.

    Deprecated: The 'current_sku' field has been deprecated. It is no longer supported.

    DefinedTags Dictionary<string, string>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    DisplayName string

    (Updatable) 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 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.

    EsxiSoftwareVersion string
    (Updatable) 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.
    FailedEsxiHostId string
    (Optional) The OCID of the ESXi host that is failed. This is an optional parameter. If this parameter is specified, a new ESXi host will be created to replace the failed one, and the failedEsxiHostId field will be updated in the newly created Esxi host.

    Deprecated: This 'failed_esxi_host_id' argument has been deprecated and will be computed only.

    FreeformTags Dictionary<string, string>
    (Updatable) 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"}
    HostOcpuCount double
    The OCPU count of the ESXi host.
    HostShapeName string
    The compute shape name of the ESXi host. ListSupportedHostShapes.
    NextSku string

    Deprecated: The 'next_sku' field has been deprecated. It is no longer supported.

    NonUpgradedEsxiHostId string
    (Optional) The OCID of the ESXi host that will be upgraded. This is an optional parameter. If this parameter is specified, an ESXi host with the new software version is created to replace the original one, and the nonUpgradedEsxiHostId field is updated in the newly created Esxi host. See Upgrading VMware Software for more information.

    Deprecated: This 'non_upgraded_esxi_host_id' argument has been deprecated and will be computed only.

    SddcId string

    (Optional) The OCID of the SDDC to add the ESXi host to. This field has been deprecated. Please use cluster_id instead. Either sddc_id or cluster_id must be configured for oci.Ocvp.EsxiHost resource. Deprecated. Please use cluster_id instead.

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    Deprecated: The 'sddc_id' field has been deprecated. Please use 'cluster_id' instead.

    BillingDonorHostId string
    (Optional) (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.

    Deprecated: This 'billing_donor_host_id' argument has been deprecated and will be computed only.

    CapacityReservationId string
    The OCID of the Capacity Reservation.
    ClusterId string
    The OCID of the Cluster to add the ESXi host to.
    ComputeAvailabilityDomain string
    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.
    CurrentSku string
    (Optional) The billing option currently used by the ESXi host. It is only effective during resource creation. Changes to its value after creation will be ignored. ListSupportedSkus. Deprecated. Please use current_commitment instead.

    Deprecated: The 'current_sku' field has been deprecated. It is no longer supported.

    DefinedTags map[string]string
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    DisplayName string

    (Updatable) 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 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.

    EsxiSoftwareVersion string
    (Updatable) 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.
    FailedEsxiHostId string
    (Optional) The OCID of the ESXi host that is failed. This is an optional parameter. If this parameter is specified, a new ESXi host will be created to replace the failed one, and the failedEsxiHostId field will be updated in the newly created Esxi host.

    Deprecated: This 'failed_esxi_host_id' argument has been deprecated and will be computed only.

    FreeformTags map[string]string
    (Updatable) 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"}
    HostOcpuCount float64
    The OCPU count of the ESXi host.
    HostShapeName string
    The compute shape name of the ESXi host. ListSupportedHostShapes.
    NextSku string

    Deprecated: The 'next_sku' field has been deprecated. It is no longer supported.

    NonUpgradedEsxiHostId string
    (Optional) The OCID of the ESXi host that will be upgraded. This is an optional parameter. If this parameter is specified, an ESXi host with the new software version is created to replace the original one, and the nonUpgradedEsxiHostId field is updated in the newly created Esxi host. See Upgrading VMware Software for more information.

    Deprecated: This 'non_upgraded_esxi_host_id' argument has been deprecated and will be computed only.

    SddcId string

    (Optional) The OCID of the SDDC to add the ESXi host to. This field has been deprecated. Please use cluster_id instead. Either sddc_id or cluster_id must be configured for oci.Ocvp.EsxiHost resource. Deprecated. Please use cluster_id instead.

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    Deprecated: The 'sddc_id' field has been deprecated. Please use 'cluster_id' instead.

    billingDonorHostId String
    (Optional) (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.

    Deprecated: This 'billing_donor_host_id' argument has been deprecated and will be computed only.

    capacityReservationId String
    The OCID of the Capacity Reservation.
    clusterId String
    The OCID of the Cluster to add the ESXi host to.
    computeAvailabilityDomain String
    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.
    currentSku String
    (Optional) The billing option currently used by the ESXi host. It is only effective during resource creation. Changes to its value after creation will be ignored. ListSupportedSkus. Deprecated. Please use current_commitment instead.

    Deprecated: The 'current_sku' field has been deprecated. It is no longer supported.

    definedTags Map<String,String>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    displayName String

    (Updatable) 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 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.

    esxiSoftwareVersion String
    (Updatable) 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.
    failedEsxiHostId String
    (Optional) The OCID of the ESXi host that is failed. This is an optional parameter. If this parameter is specified, a new ESXi host will be created to replace the failed one, and the failedEsxiHostId field will be updated in the newly created Esxi host.

    Deprecated: This 'failed_esxi_host_id' argument has been deprecated and will be computed only.

    freeformTags Map<String,String>
    (Updatable) 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"}
    hostOcpuCount Double
    The OCPU count of the ESXi host.
    hostShapeName String
    The compute shape name of the ESXi host. ListSupportedHostShapes.
    nextSku String

    Deprecated: The 'next_sku' field has been deprecated. It is no longer supported.

    nonUpgradedEsxiHostId String
    (Optional) The OCID of the ESXi host that will be upgraded. This is an optional parameter. If this parameter is specified, an ESXi host with the new software version is created to replace the original one, and the nonUpgradedEsxiHostId field is updated in the newly created Esxi host. See Upgrading VMware Software for more information.

    Deprecated: This 'non_upgraded_esxi_host_id' argument has been deprecated and will be computed only.

    sddcId String

    (Optional) The OCID of the SDDC to add the ESXi host to. This field has been deprecated. Please use cluster_id instead. Either sddc_id or cluster_id must be configured for oci.Ocvp.EsxiHost resource. Deprecated. Please use cluster_id instead.

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    Deprecated: The 'sddc_id' field has been deprecated. Please use 'cluster_id' instead.

    billingDonorHostId string
    (Optional) (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.

    Deprecated: This 'billing_donor_host_id' argument has been deprecated and will be computed only.

    capacityReservationId string
    The OCID of the Capacity Reservation.
    clusterId string
    The OCID of the Cluster to add the ESXi host to.
    computeAvailabilityDomain string
    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.
    currentSku string
    (Optional) The billing option currently used by the ESXi host. It is only effective during resource creation. Changes to its value after creation will be ignored. ListSupportedSkus. Deprecated. Please use current_commitment instead.

    Deprecated: The 'current_sku' field has been deprecated. It is no longer supported.

    definedTags {[key: string]: string}
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    displayName string

    (Updatable) 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 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.

    esxiSoftwareVersion string
    (Updatable) 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.
    failedEsxiHostId string
    (Optional) The OCID of the ESXi host that is failed. This is an optional parameter. If this parameter is specified, a new ESXi host will be created to replace the failed one, and the failedEsxiHostId field will be updated in the newly created Esxi host.

    Deprecated: This 'failed_esxi_host_id' argument has been deprecated and will be computed only.

    freeformTags {[key: string]: string}
    (Updatable) 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"}
    hostOcpuCount number
    The OCPU count of the ESXi host.
    hostShapeName string
    The compute shape name of the ESXi host. ListSupportedHostShapes.
    nextSku string

    Deprecated: The 'next_sku' field has been deprecated. It is no longer supported.

    nonUpgradedEsxiHostId string
    (Optional) The OCID of the ESXi host that will be upgraded. This is an optional parameter. If this parameter is specified, an ESXi host with the new software version is created to replace the original one, and the nonUpgradedEsxiHostId field is updated in the newly created Esxi host. See Upgrading VMware Software for more information.

    Deprecated: This 'non_upgraded_esxi_host_id' argument has been deprecated and will be computed only.

    sddcId string

    (Optional) The OCID of the SDDC to add the ESXi host to. This field has been deprecated. Please use cluster_id instead. Either sddc_id or cluster_id must be configured for oci.Ocvp.EsxiHost resource. Deprecated. Please use cluster_id instead.

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    Deprecated: The 'sddc_id' field has been deprecated. Please use 'cluster_id' instead.

    billing_donor_host_id str
    (Optional) (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.

    Deprecated: This 'billing_donor_host_id' argument has been deprecated and will be computed only.

    capacity_reservation_id str
    The OCID of the Capacity Reservation.
    cluster_id str
    The OCID of the Cluster to add the ESXi host to.
    compute_availability_domain str
    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.
    current_sku str
    (Optional) The billing option currently used by the ESXi host. It is only effective during resource creation. Changes to its value after creation will be ignored. ListSupportedSkus. Deprecated. Please use current_commitment instead.

    Deprecated: The 'current_sku' field has been deprecated. It is no longer supported.

    defined_tags Mapping[str, str]
    (Updatable) 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 str

    (Updatable) 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 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.

    esxi_software_version str
    (Updatable) 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.
    failed_esxi_host_id str
    (Optional) The OCID of the ESXi host that is failed. This is an optional parameter. If this parameter is specified, a new ESXi host will be created to replace the failed one, and the failedEsxiHostId field will be updated in the newly created Esxi host.

    Deprecated: This 'failed_esxi_host_id' argument has been deprecated and will be computed only.

    freeform_tags Mapping[str, str]
    (Updatable) 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"}
    host_ocpu_count float
    The OCPU count of the ESXi host.
    host_shape_name str
    The compute shape name of the ESXi host. ListSupportedHostShapes.
    next_sku str

    Deprecated: The 'next_sku' field has been deprecated. It is no longer supported.

    non_upgraded_esxi_host_id str
    (Optional) The OCID of the ESXi host that will be upgraded. This is an optional parameter. If this parameter is specified, an ESXi host with the new software version is created to replace the original one, and the nonUpgradedEsxiHostId field is updated in the newly created Esxi host. See Upgrading VMware Software for more information.

    Deprecated: This 'non_upgraded_esxi_host_id' argument has been deprecated and will be computed only.

    sddc_id str

    (Optional) The OCID of the SDDC to add the ESXi host to. This field has been deprecated. Please use cluster_id instead. Either sddc_id or cluster_id must be configured for oci.Ocvp.EsxiHost resource. Deprecated. Please use cluster_id instead.

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    Deprecated: The 'sddc_id' field has been deprecated. Please use 'cluster_id' instead.

    billingDonorHostId String
    (Optional) (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.

    Deprecated: This 'billing_donor_host_id' argument has been deprecated and will be computed only.

    capacityReservationId String
    The OCID of the Capacity Reservation.
    clusterId String
    The OCID of the Cluster to add the ESXi host to.
    computeAvailabilityDomain String
    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.
    currentSku String
    (Optional) The billing option currently used by the ESXi host. It is only effective during resource creation. Changes to its value after creation will be ignored. ListSupportedSkus. Deprecated. Please use current_commitment instead.

    Deprecated: The 'current_sku' field has been deprecated. It is no longer supported.

    definedTags Map<String>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    displayName String

    (Updatable) 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 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.

    esxiSoftwareVersion String
    (Updatable) 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.
    failedEsxiHostId String
    (Optional) The OCID of the ESXi host that is failed. This is an optional parameter. If this parameter is specified, a new ESXi host will be created to replace the failed one, and the failedEsxiHostId field will be updated in the newly created Esxi host.

    Deprecated: This 'failed_esxi_host_id' argument has been deprecated and will be computed only.

    freeformTags Map<String>
    (Updatable) 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"}
    hostOcpuCount Number
    The OCPU count of the ESXi host.
    hostShapeName String
    The compute shape name of the ESXi host. ListSupportedHostShapes.
    nextSku String

    Deprecated: The 'next_sku' field has been deprecated. It is no longer supported.

    nonUpgradedEsxiHostId String
    (Optional) The OCID of the ESXi host that will be upgraded. This is an optional parameter. If this parameter is specified, an ESXi host with the new software version is created to replace the original one, and the nonUpgradedEsxiHostId field is updated in the newly created Esxi host. See Upgrading VMware Software for more information.

    Deprecated: This 'non_upgraded_esxi_host_id' argument has been deprecated and will be computed only.

    sddcId String

    (Optional) The OCID of the SDDC to add the ESXi host to. This field has been deprecated. Please use cluster_id instead. Either sddc_id or cluster_id must be configured for oci.Ocvp.EsxiHost resource. Deprecated. Please use cluster_id instead.

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    Deprecated: The 'sddc_id' field has been deprecated. Please use 'cluster_id' instead.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the EsxiHost resource produces the following output properties:

    BillingContractEndDate string
    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
    CompartmentId string
    The OCID of the compartment that contains the Cluster.
    ComputeInstanceId string
    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.
    CurrentCommitment string
    The billing option currently used by the ESXi host. ListSupportedCommitments.
    GracePeriodEndDate string
    The date and time when the new esxi host should start billing cycle. RFC3339. Example: 2021-07-25T21:10:29.600Z
    Id string
    The provider-assigned unique ID for this managed resource.
    IsBillingContinuationInProgress bool
    Indicates whether this host is in the progress of billing continuation.
    IsBillingSwappingInProgress bool
    Indicates whether this host is in the progress of swapping billing.
    NextCommitment string
    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.
    ReplacementEsxiHostId string
    The OCID of the esxi host that is newly created to replace the failed node.
    State string
    The current state of the ESXi host.
    SwapBillingHostId string
    The OCID of the active ESXi Host to swap billing with current host.
    TimeCreated string
    The date and time the ESXi host was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    TimeUpdated string
    The date and time the ESXi host was updated, in the format defined by RFC3339.
    UpgradedReplacementEsxiHostId string
    The OCID of the ESXi host that is newly created to upgrade the original host.
    VmwareSoftwareVersion string
    The version of VMware software that Oracle Cloud VMware Solution installed on the ESXi hosts.
    BillingContractEndDate string
    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
    CompartmentId string
    The OCID of the compartment that contains the Cluster.
    ComputeInstanceId string
    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.
    CurrentCommitment string
    The billing option currently used by the ESXi host. ListSupportedCommitments.
    GracePeriodEndDate string
    The date and time when the new esxi host should start billing cycle. RFC3339. Example: 2021-07-25T21:10:29.600Z
    Id string
    The provider-assigned unique ID for this managed resource.
    IsBillingContinuationInProgress bool
    Indicates whether this host is in the progress of billing continuation.
    IsBillingSwappingInProgress bool
    Indicates whether this host is in the progress of swapping billing.
    NextCommitment string
    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.
    ReplacementEsxiHostId string
    The OCID of the esxi host that is newly created to replace the failed node.
    State string
    The current state of the ESXi host.
    SwapBillingHostId string
    The OCID of the active ESXi Host to swap billing with current host.
    TimeCreated string
    The date and time the ESXi host was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    TimeUpdated string
    The date and time the ESXi host was updated, in the format defined by RFC3339.
    UpgradedReplacementEsxiHostId string
    The OCID of the ESXi host that is newly created to upgrade the original host.
    VmwareSoftwareVersion string
    The version of VMware software that Oracle Cloud VMware Solution installed on the ESXi hosts.
    billingContractEndDate String
    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
    compartmentId String
    The OCID of the compartment that contains the Cluster.
    computeInstanceId String
    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.
    currentCommitment String
    The billing option currently used by the ESXi host. ListSupportedCommitments.
    gracePeriodEndDate String
    The date and time when the new esxi host should start billing cycle. RFC3339. Example: 2021-07-25T21:10:29.600Z
    id String
    The provider-assigned unique ID for this managed resource.
    isBillingContinuationInProgress Boolean
    Indicates whether this host is in the progress of billing continuation.
    isBillingSwappingInProgress Boolean
    Indicates whether this host is in the progress of swapping billing.
    nextCommitment String
    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.
    replacementEsxiHostId String
    The OCID of the esxi host that is newly created to replace the failed node.
    state String
    The current state of the ESXi host.
    swapBillingHostId String
    The OCID of the active ESXi Host to swap billing with current host.
    timeCreated String
    The date and time the ESXi host was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    timeUpdated String
    The date and time the ESXi host was updated, in the format defined by RFC3339.
    upgradedReplacementEsxiHostId String
    The OCID of the ESXi host that is newly created to upgrade the original host.
    vmwareSoftwareVersion String
    The version of VMware software that Oracle Cloud VMware Solution installed on the ESXi hosts.
    billingContractEndDate string
    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
    compartmentId string
    The OCID of the compartment that contains the Cluster.
    computeInstanceId string
    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.
    currentCommitment string
    The billing option currently used by the ESXi host. ListSupportedCommitments.
    gracePeriodEndDate string
    The date and time when the new esxi host should start billing cycle. RFC3339. Example: 2021-07-25T21:10:29.600Z
    id string
    The provider-assigned unique ID for this managed resource.
    isBillingContinuationInProgress boolean
    Indicates whether this host is in the progress of billing continuation.
    isBillingSwappingInProgress boolean
    Indicates whether this host is in the progress of swapping billing.
    nextCommitment string
    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.
    replacementEsxiHostId string
    The OCID of the esxi host that is newly created to replace the failed node.
    state string
    The current state of the ESXi host.
    swapBillingHostId string
    The OCID of the active ESXi Host to swap billing with current host.
    timeCreated string
    The date and time the ESXi host was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    timeUpdated string
    The date and time the ESXi host was updated, in the format defined by RFC3339.
    upgradedReplacementEsxiHostId string
    The OCID of the ESXi host that is newly created to upgrade the original host.
    vmwareSoftwareVersion string
    The version of VMware software that Oracle Cloud VMware Solution installed on the ESXi hosts.
    billing_contract_end_date str
    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
    compartment_id str
    The OCID of the compartment that contains the Cluster.
    compute_instance_id str
    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_commitment str
    The billing option currently used by the ESXi host. ListSupportedCommitments.
    grace_period_end_date str
    The date and time when the new esxi host should start billing cycle. RFC3339. Example: 2021-07-25T21:10:29.600Z
    id str
    The provider-assigned unique ID for this managed resource.
    is_billing_continuation_in_progress bool
    Indicates whether this host is in the progress of billing continuation.
    is_billing_swapping_in_progress bool
    Indicates whether this host is in the progress of swapping billing.
    next_commitment str
    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.
    replacement_esxi_host_id str
    The OCID of the esxi host that is newly created to replace the failed node.
    state str
    The current state of the ESXi host.
    swap_billing_host_id str
    The OCID of the active ESXi Host to swap billing with current host.
    time_created str
    The date and time the ESXi host was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    time_updated str
    The date and time the ESXi host was updated, in the format defined by RFC3339.
    upgraded_replacement_esxi_host_id str
    The OCID of the ESXi host that is newly created to upgrade the original host.
    vmware_software_version str
    The version of VMware software that Oracle Cloud VMware Solution installed on the ESXi hosts.
    billingContractEndDate String
    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
    compartmentId String
    The OCID of the compartment that contains the Cluster.
    computeInstanceId String
    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.
    currentCommitment String
    The billing option currently used by the ESXi host. ListSupportedCommitments.
    gracePeriodEndDate String
    The date and time when the new esxi host should start billing cycle. RFC3339. Example: 2021-07-25T21:10:29.600Z
    id String
    The provider-assigned unique ID for this managed resource.
    isBillingContinuationInProgress Boolean
    Indicates whether this host is in the progress of billing continuation.
    isBillingSwappingInProgress Boolean
    Indicates whether this host is in the progress of swapping billing.
    nextCommitment String
    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.
    replacementEsxiHostId String
    The OCID of the esxi host that is newly created to replace the failed node.
    state String
    The current state of the ESXi host.
    swapBillingHostId String
    The OCID of the active ESXi Host to swap billing with current host.
    timeCreated String
    The date and time the ESXi host was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    timeUpdated String
    The date and time the ESXi host was updated, in the format defined by RFC3339.
    upgradedReplacementEsxiHostId String
    The OCID of the ESXi host that is newly created to upgrade the original host.
    vmwareSoftwareVersion String
    The version of VMware software that Oracle Cloud VMware Solution installed on the ESXi hosts.

    Look up Existing EsxiHost Resource

    Get an existing EsxiHost resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: EsxiHostState, opts?: CustomResourceOptions): EsxiHost
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        billing_contract_end_date: Optional[str] = None,
        billing_donor_host_id: Optional[str] = None,
        capacity_reservation_id: Optional[str] = None,
        cluster_id: Optional[str] = None,
        compartment_id: Optional[str] = None,
        compute_availability_domain: Optional[str] = None,
        compute_instance_id: Optional[str] = None,
        current_commitment: Optional[str] = None,
        current_sku: Optional[str] = None,
        defined_tags: Optional[Mapping[str, str]] = None,
        display_name: Optional[str] = None,
        esxi_software_version: Optional[str] = None,
        failed_esxi_host_id: Optional[str] = None,
        freeform_tags: Optional[Mapping[str, str]] = None,
        grace_period_end_date: Optional[str] = None,
        host_ocpu_count: Optional[float] = None,
        host_shape_name: Optional[str] = None,
        is_billing_continuation_in_progress: Optional[bool] = None,
        is_billing_swapping_in_progress: Optional[bool] = None,
        next_commitment: Optional[str] = None,
        next_sku: Optional[str] = None,
        non_upgraded_esxi_host_id: Optional[str] = None,
        replacement_esxi_host_id: Optional[str] = None,
        sddc_id: Optional[str] = None,
        state: Optional[str] = None,
        swap_billing_host_id: Optional[str] = None,
        time_created: Optional[str] = None,
        time_updated: Optional[str] = None,
        upgraded_replacement_esxi_host_id: Optional[str] = None,
        vmware_software_version: Optional[str] = None) -> EsxiHost
    func GetEsxiHost(ctx *Context, name string, id IDInput, state *EsxiHostState, opts ...ResourceOption) (*EsxiHost, error)
    public static EsxiHost Get(string name, Input<string> id, EsxiHostState? state, CustomResourceOptions? opts = null)
    public static EsxiHost get(String name, Output<String> id, EsxiHostState state, CustomResourceOptions options)
    resources:  _:    type: oci:Ocvp:EsxiHost    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    BillingContractEndDate string
    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
    BillingDonorHostId string
    (Optional) (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.

    Deprecated: This 'billing_donor_host_id' argument has been deprecated and will be computed only.

    CapacityReservationId string
    The OCID of the Capacity Reservation.
    ClusterId string
    The OCID of the Cluster to add the ESXi host to.
    CompartmentId string
    The OCID of the compartment that contains the Cluster.
    ComputeAvailabilityDomain string
    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.
    ComputeInstanceId string
    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.
    CurrentCommitment string
    The billing option currently used by the ESXi host. ListSupportedCommitments.
    CurrentSku string
    (Optional) The billing option currently used by the ESXi host. It is only effective during resource creation. Changes to its value after creation will be ignored. ListSupportedSkus. Deprecated. Please use current_commitment instead.

    Deprecated: The 'current_sku' field has been deprecated. It is no longer supported.

    DefinedTags Dictionary<string, string>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    DisplayName string

    (Updatable) 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 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.

    EsxiSoftwareVersion string
    (Updatable) 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.
    FailedEsxiHostId string
    (Optional) The OCID of the ESXi host that is failed. This is an optional parameter. If this parameter is specified, a new ESXi host will be created to replace the failed one, and the failedEsxiHostId field will be updated in the newly created Esxi host.

    Deprecated: This 'failed_esxi_host_id' argument has been deprecated and will be computed only.

    FreeformTags Dictionary<string, string>
    (Updatable) 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"}
    GracePeriodEndDate string
    The date and time when the new esxi host should start billing cycle. RFC3339. Example: 2021-07-25T21:10:29.600Z
    HostOcpuCount double
    The OCPU count of the ESXi host.
    HostShapeName string
    The compute shape name of the ESXi host. ListSupportedHostShapes.
    IsBillingContinuationInProgress bool
    Indicates whether this host is in the progress of billing continuation.
    IsBillingSwappingInProgress bool
    Indicates whether this host is in the progress of swapping billing.
    NextCommitment string
    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.
    NextSku string

    Deprecated: The 'next_sku' field has been deprecated. It is no longer supported.

    NonUpgradedEsxiHostId string
    (Optional) The OCID of the ESXi host that will be upgraded. This is an optional parameter. If this parameter is specified, an ESXi host with the new software version is created to replace the original one, and the nonUpgradedEsxiHostId field is updated in the newly created Esxi host. See Upgrading VMware Software for more information.

    Deprecated: This 'non_upgraded_esxi_host_id' argument has been deprecated and will be computed only.

    ReplacementEsxiHostId string
    The OCID of the esxi host that is newly created to replace the failed node.
    SddcId string

    (Optional) The OCID of the SDDC to add the ESXi host to. This field has been deprecated. Please use cluster_id instead. Either sddc_id or cluster_id must be configured for oci.Ocvp.EsxiHost resource. Deprecated. Please use cluster_id instead.

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    Deprecated: The 'sddc_id' field has been deprecated. Please use 'cluster_id' instead.

    State string
    The current state of the ESXi host.
    SwapBillingHostId string
    The OCID of the active ESXi Host to swap billing with current host.
    TimeCreated string
    The date and time the ESXi host was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    TimeUpdated string
    The date and time the ESXi host was updated, in the format defined by RFC3339.
    UpgradedReplacementEsxiHostId string
    The OCID of the ESXi host that is newly created to upgrade the original host.
    VmwareSoftwareVersion string
    The version of VMware software that Oracle Cloud VMware Solution installed on the ESXi hosts.
    BillingContractEndDate string
    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
    BillingDonorHostId string
    (Optional) (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.

    Deprecated: This 'billing_donor_host_id' argument has been deprecated and will be computed only.

    CapacityReservationId string
    The OCID of the Capacity Reservation.
    ClusterId string
    The OCID of the Cluster to add the ESXi host to.
    CompartmentId string
    The OCID of the compartment that contains the Cluster.
    ComputeAvailabilityDomain string
    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.
    ComputeInstanceId string
    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.
    CurrentCommitment string
    The billing option currently used by the ESXi host. ListSupportedCommitments.
    CurrentSku string
    (Optional) The billing option currently used by the ESXi host. It is only effective during resource creation. Changes to its value after creation will be ignored. ListSupportedSkus. Deprecated. Please use current_commitment instead.

    Deprecated: The 'current_sku' field has been deprecated. It is no longer supported.

    DefinedTags map[string]string
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    DisplayName string

    (Updatable) 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 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.

    EsxiSoftwareVersion string
    (Updatable) 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.
    FailedEsxiHostId string
    (Optional) The OCID of the ESXi host that is failed. This is an optional parameter. If this parameter is specified, a new ESXi host will be created to replace the failed one, and the failedEsxiHostId field will be updated in the newly created Esxi host.

    Deprecated: This 'failed_esxi_host_id' argument has been deprecated and will be computed only.

    FreeformTags map[string]string
    (Updatable) 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"}
    GracePeriodEndDate string
    The date and time when the new esxi host should start billing cycle. RFC3339. Example: 2021-07-25T21:10:29.600Z
    HostOcpuCount float64
    The OCPU count of the ESXi host.
    HostShapeName string
    The compute shape name of the ESXi host. ListSupportedHostShapes.
    IsBillingContinuationInProgress bool
    Indicates whether this host is in the progress of billing continuation.
    IsBillingSwappingInProgress bool
    Indicates whether this host is in the progress of swapping billing.
    NextCommitment string
    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.
    NextSku string

    Deprecated: The 'next_sku' field has been deprecated. It is no longer supported.

    NonUpgradedEsxiHostId string
    (Optional) The OCID of the ESXi host that will be upgraded. This is an optional parameter. If this parameter is specified, an ESXi host with the new software version is created to replace the original one, and the nonUpgradedEsxiHostId field is updated in the newly created Esxi host. See Upgrading VMware Software for more information.

    Deprecated: This 'non_upgraded_esxi_host_id' argument has been deprecated and will be computed only.

    ReplacementEsxiHostId string
    The OCID of the esxi host that is newly created to replace the failed node.
    SddcId string

    (Optional) The OCID of the SDDC to add the ESXi host to. This field has been deprecated. Please use cluster_id instead. Either sddc_id or cluster_id must be configured for oci.Ocvp.EsxiHost resource. Deprecated. Please use cluster_id instead.

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    Deprecated: The 'sddc_id' field has been deprecated. Please use 'cluster_id' instead.

    State string
    The current state of the ESXi host.
    SwapBillingHostId string
    The OCID of the active ESXi Host to swap billing with current host.
    TimeCreated string
    The date and time the ESXi host was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    TimeUpdated string
    The date and time the ESXi host was updated, in the format defined by RFC3339.
    UpgradedReplacementEsxiHostId string
    The OCID of the ESXi host that is newly created to upgrade the original host.
    VmwareSoftwareVersion string
    The version of VMware software that Oracle Cloud VMware Solution installed on the ESXi hosts.
    billingContractEndDate String
    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
    billingDonorHostId String
    (Optional) (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.

    Deprecated: This 'billing_donor_host_id' argument has been deprecated and will be computed only.

    capacityReservationId String
    The OCID of the Capacity Reservation.
    clusterId String
    The OCID of the Cluster to add the ESXi host to.
    compartmentId String
    The OCID of the compartment that contains the Cluster.
    computeAvailabilityDomain String
    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.
    computeInstanceId String
    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.
    currentCommitment String
    The billing option currently used by the ESXi host. ListSupportedCommitments.
    currentSku String
    (Optional) The billing option currently used by the ESXi host. It is only effective during resource creation. Changes to its value after creation will be ignored. ListSupportedSkus. Deprecated. Please use current_commitment instead.

    Deprecated: The 'current_sku' field has been deprecated. It is no longer supported.

    definedTags Map<String,String>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    displayName String

    (Updatable) 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 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.

    esxiSoftwareVersion String
    (Updatable) 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.
    failedEsxiHostId String
    (Optional) The OCID of the ESXi host that is failed. This is an optional parameter. If this parameter is specified, a new ESXi host will be created to replace the failed one, and the failedEsxiHostId field will be updated in the newly created Esxi host.

    Deprecated: This 'failed_esxi_host_id' argument has been deprecated and will be computed only.

    freeformTags Map<String,String>
    (Updatable) 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"}
    gracePeriodEndDate String
    The date and time when the new esxi host should start billing cycle. RFC3339. Example: 2021-07-25T21:10:29.600Z
    hostOcpuCount Double
    The OCPU count of the ESXi host.
    hostShapeName String
    The compute shape name of the ESXi host. ListSupportedHostShapes.
    isBillingContinuationInProgress Boolean
    Indicates whether this host is in the progress of billing continuation.
    isBillingSwappingInProgress Boolean
    Indicates whether this host is in the progress of swapping billing.
    nextCommitment String
    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.
    nextSku String

    Deprecated: The 'next_sku' field has been deprecated. It is no longer supported.

    nonUpgradedEsxiHostId String
    (Optional) The OCID of the ESXi host that will be upgraded. This is an optional parameter. If this parameter is specified, an ESXi host with the new software version is created to replace the original one, and the nonUpgradedEsxiHostId field is updated in the newly created Esxi host. See Upgrading VMware Software for more information.

    Deprecated: This 'non_upgraded_esxi_host_id' argument has been deprecated and will be computed only.

    replacementEsxiHostId String
    The OCID of the esxi host that is newly created to replace the failed node.
    sddcId String

    (Optional) The OCID of the SDDC to add the ESXi host to. This field has been deprecated. Please use cluster_id instead. Either sddc_id or cluster_id must be configured for oci.Ocvp.EsxiHost resource. Deprecated. Please use cluster_id instead.

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    Deprecated: The 'sddc_id' field has been deprecated. Please use 'cluster_id' instead.

    state String
    The current state of the ESXi host.
    swapBillingHostId String
    The OCID of the active ESXi Host to swap billing with current host.
    timeCreated String
    The date and time the ESXi host was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    timeUpdated String
    The date and time the ESXi host was updated, in the format defined by RFC3339.
    upgradedReplacementEsxiHostId String
    The OCID of the ESXi host that is newly created to upgrade the original host.
    vmwareSoftwareVersion String
    The version of VMware software that Oracle Cloud VMware Solution installed on the ESXi hosts.
    billingContractEndDate string
    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
    billingDonorHostId string
    (Optional) (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.

    Deprecated: This 'billing_donor_host_id' argument has been deprecated and will be computed only.

    capacityReservationId string
    The OCID of the Capacity Reservation.
    clusterId string
    The OCID of the Cluster to add the ESXi host to.
    compartmentId string
    The OCID of the compartment that contains the Cluster.
    computeAvailabilityDomain string
    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.
    computeInstanceId string
    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.
    currentCommitment string
    The billing option currently used by the ESXi host. ListSupportedCommitments.
    currentSku string
    (Optional) The billing option currently used by the ESXi host. It is only effective during resource creation. Changes to its value after creation will be ignored. ListSupportedSkus. Deprecated. Please use current_commitment instead.

    Deprecated: The 'current_sku' field has been deprecated. It is no longer supported.

    definedTags {[key: string]: string}
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    displayName string

    (Updatable) 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 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.

    esxiSoftwareVersion string
    (Updatable) 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.
    failedEsxiHostId string
    (Optional) The OCID of the ESXi host that is failed. This is an optional parameter. If this parameter is specified, a new ESXi host will be created to replace the failed one, and the failedEsxiHostId field will be updated in the newly created Esxi host.

    Deprecated: This 'failed_esxi_host_id' argument has been deprecated and will be computed only.

    freeformTags {[key: string]: string}
    (Updatable) 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"}
    gracePeriodEndDate string
    The date and time when the new esxi host should start billing cycle. RFC3339. Example: 2021-07-25T21:10:29.600Z
    hostOcpuCount number
    The OCPU count of the ESXi host.
    hostShapeName string
    The compute shape name of the ESXi host. ListSupportedHostShapes.
    isBillingContinuationInProgress boolean
    Indicates whether this host is in the progress of billing continuation.
    isBillingSwappingInProgress boolean
    Indicates whether this host is in the progress of swapping billing.
    nextCommitment string
    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.
    nextSku string

    Deprecated: The 'next_sku' field has been deprecated. It is no longer supported.

    nonUpgradedEsxiHostId string
    (Optional) The OCID of the ESXi host that will be upgraded. This is an optional parameter. If this parameter is specified, an ESXi host with the new software version is created to replace the original one, and the nonUpgradedEsxiHostId field is updated in the newly created Esxi host. See Upgrading VMware Software for more information.

    Deprecated: This 'non_upgraded_esxi_host_id' argument has been deprecated and will be computed only.

    replacementEsxiHostId string
    The OCID of the esxi host that is newly created to replace the failed node.
    sddcId string

    (Optional) The OCID of the SDDC to add the ESXi host to. This field has been deprecated. Please use cluster_id instead. Either sddc_id or cluster_id must be configured for oci.Ocvp.EsxiHost resource. Deprecated. Please use cluster_id instead.

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    Deprecated: The 'sddc_id' field has been deprecated. Please use 'cluster_id' instead.

    state string
    The current state of the ESXi host.
    swapBillingHostId string
    The OCID of the active ESXi Host to swap billing with current host.
    timeCreated string
    The date and time the ESXi host was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    timeUpdated string
    The date and time the ESXi host was updated, in the format defined by RFC3339.
    upgradedReplacementEsxiHostId string
    The OCID of the ESXi host that is newly created to upgrade the original host.
    vmwareSoftwareVersion string
    The version of VMware software that Oracle Cloud VMware Solution installed on the ESXi hosts.
    billing_contract_end_date str
    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 str
    (Optional) (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.

    Deprecated: This 'billing_donor_host_id' argument has been deprecated and will be computed only.

    capacity_reservation_id str
    The OCID of the Capacity Reservation.
    cluster_id str
    The OCID of the Cluster to add the ESXi host to.
    compartment_id str
    The OCID of the compartment that contains the Cluster.
    compute_availability_domain str
    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.
    compute_instance_id str
    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_commitment str
    The billing option currently used by the ESXi host. ListSupportedCommitments.
    current_sku str
    (Optional) The billing option currently used by the ESXi host. It is only effective during resource creation. Changes to its value after creation will be ignored. ListSupportedSkus. Deprecated. Please use current_commitment instead.

    Deprecated: The 'current_sku' field has been deprecated. It is no longer supported.

    defined_tags Mapping[str, str]
    (Updatable) 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 str

    (Updatable) 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 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.

    esxi_software_version str
    (Updatable) 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.
    failed_esxi_host_id str
    (Optional) The OCID of the ESXi host that is failed. This is an optional parameter. If this parameter is specified, a new ESXi host will be created to replace the failed one, and the failedEsxiHostId field will be updated in the newly created Esxi host.

    Deprecated: This 'failed_esxi_host_id' argument has been deprecated and will be computed only.

    freeform_tags Mapping[str, str]
    (Updatable) 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 str
    The date and time when the new esxi host should start billing cycle. RFC3339. Example: 2021-07-25T21:10:29.600Z
    host_ocpu_count float
    The OCPU count of the ESXi host.
    host_shape_name str
    The compute shape name of the ESXi host. ListSupportedHostShapes.
    is_billing_continuation_in_progress bool
    Indicates whether this host is in the progress of billing continuation.
    is_billing_swapping_in_progress bool
    Indicates whether this host is in the progress of swapping billing.
    next_commitment str
    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.
    next_sku str

    Deprecated: The 'next_sku' field has been deprecated. It is no longer supported.

    non_upgraded_esxi_host_id str
    (Optional) The OCID of the ESXi host that will be upgraded. This is an optional parameter. If this parameter is specified, an ESXi host with the new software version is created to replace the original one, and the nonUpgradedEsxiHostId field is updated in the newly created Esxi host. See Upgrading VMware Software for more information.

    Deprecated: This 'non_upgraded_esxi_host_id' argument has been deprecated and will be computed only.

    replacement_esxi_host_id str
    The OCID of the esxi host that is newly created to replace the failed node.
    sddc_id str

    (Optional) The OCID of the SDDC to add the ESXi host to. This field has been deprecated. Please use cluster_id instead. Either sddc_id or cluster_id must be configured for oci.Ocvp.EsxiHost resource. Deprecated. Please use cluster_id instead.

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    Deprecated: The 'sddc_id' field has been deprecated. Please use 'cluster_id' instead.

    state str
    The current state of the ESXi host.
    swap_billing_host_id str
    The OCID of the active ESXi Host to swap billing with current host.
    time_created str
    The date and time the ESXi host was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    time_updated str
    The date and time the ESXi host was updated, in the format defined by RFC3339.
    upgraded_replacement_esxi_host_id str
    The OCID of the ESXi host that is newly created to upgrade the original host.
    vmware_software_version str
    The version of VMware software that Oracle Cloud VMware Solution installed on the ESXi hosts.
    billingContractEndDate String
    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
    billingDonorHostId String
    (Optional) (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.

    Deprecated: This 'billing_donor_host_id' argument has been deprecated and will be computed only.

    capacityReservationId String
    The OCID of the Capacity Reservation.
    clusterId String
    The OCID of the Cluster to add the ESXi host to.
    compartmentId String
    The OCID of the compartment that contains the Cluster.
    computeAvailabilityDomain String
    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.
    computeInstanceId String
    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.
    currentCommitment String
    The billing option currently used by the ESXi host. ListSupportedCommitments.
    currentSku String
    (Optional) The billing option currently used by the ESXi host. It is only effective during resource creation. Changes to its value after creation will be ignored. ListSupportedSkus. Deprecated. Please use current_commitment instead.

    Deprecated: The 'current_sku' field has been deprecated. It is no longer supported.

    definedTags Map<String>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    displayName String

    (Updatable) 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 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.

    esxiSoftwareVersion String
    (Updatable) 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.
    failedEsxiHostId String
    (Optional) The OCID of the ESXi host that is failed. This is an optional parameter. If this parameter is specified, a new ESXi host will be created to replace the failed one, and the failedEsxiHostId field will be updated in the newly created Esxi host.

    Deprecated: This 'failed_esxi_host_id' argument has been deprecated and will be computed only.

    freeformTags Map<String>
    (Updatable) 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"}
    gracePeriodEndDate String
    The date and time when the new esxi host should start billing cycle. RFC3339. Example: 2021-07-25T21:10:29.600Z
    hostOcpuCount Number
    The OCPU count of the ESXi host.
    hostShapeName String
    The compute shape name of the ESXi host. ListSupportedHostShapes.
    isBillingContinuationInProgress Boolean
    Indicates whether this host is in the progress of billing continuation.
    isBillingSwappingInProgress Boolean
    Indicates whether this host is in the progress of swapping billing.
    nextCommitment String
    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.
    nextSku String

    Deprecated: The 'next_sku' field has been deprecated. It is no longer supported.

    nonUpgradedEsxiHostId String
    (Optional) The OCID of the ESXi host that will be upgraded. This is an optional parameter. If this parameter is specified, an ESXi host with the new software version is created to replace the original one, and the nonUpgradedEsxiHostId field is updated in the newly created Esxi host. See Upgrading VMware Software for more information.

    Deprecated: This 'non_upgraded_esxi_host_id' argument has been deprecated and will be computed only.

    replacementEsxiHostId String
    The OCID of the esxi host that is newly created to replace the failed node.
    sddcId String

    (Optional) The OCID of the SDDC to add the ESXi host to. This field has been deprecated. Please use cluster_id instead. Either sddc_id or cluster_id must be configured for oci.Ocvp.EsxiHost resource. Deprecated. Please use cluster_id instead.

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    Deprecated: The 'sddc_id' field has been deprecated. Please use 'cluster_id' instead.

    state String
    The current state of the ESXi host.
    swapBillingHostId String
    The OCID of the active ESXi Host to swap billing with current host.
    timeCreated String
    The date and time the ESXi host was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    timeUpdated String
    The date and time the ESXi host was updated, in the format defined by RFC3339.
    upgradedReplacementEsxiHostId String
    The OCID of the ESXi host that is newly created to upgrade the original host.
    vmwareSoftwareVersion String
    The version of VMware software that Oracle Cloud VMware Solution installed on the ESXi hosts.

    Package Details

    Repository
    oci pulumi/pulumi-oci
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the oci Terraform Provider.
    oci logo
    Oracle Cloud Infrastructure v2.33.0 published on Thursday, May 1, 2025 by Pulumi
    pulumi/pulumi-oci