oci.Ocvp.EsxiHost
Explore with Pulumi AI
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)
.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:
- Billing
Donor stringHost Id - (Optional) (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.
- Capacity
Reservation stringId - The OCID of the Capacity Reservation.
- Cluster
Id string - The OCID of the Cluster to add the ESXi host to.
- Compute
Availability stringDomain - 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 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. - 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"}
- Display
Name 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, andinstanceDisplayNamePrefix
isMyCluster
, the host's display name isMyCluster-4
.Avoid entering confidential information.
- Esxi
Software stringVersion - (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 stringHost Id - (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. - 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"}
- Host
Ocpu doubleCount - The OCPU count of the ESXi host.
- Host
Shape stringName - The compute shape name of the ESXi host. ListSupportedHostShapes.
- Next
Sku string - Non
Upgraded stringEsxi Host Id - (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. - Sddc
Id string (Optional) The OCID of the SDDC to add the ESXi host to. This field has been deprecated. Please use
cluster_id
instead. Eithersddc_id
orcluster_id
must be configured foroci.Ocvp.EsxiHost
resource. Deprecated. Please usecluster_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
- Billing
Donor stringHost Id - (Optional) (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.
- Capacity
Reservation stringId - The OCID of the Capacity Reservation.
- Cluster
Id string - The OCID of the Cluster to add the ESXi host to.
- Compute
Availability stringDomain - 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 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. - 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"}
- Display
Name 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, andinstanceDisplayNamePrefix
isMyCluster
, the host's display name isMyCluster-4
.Avoid entering confidential information.
- Esxi
Software stringVersion - (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 stringHost Id - (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. - 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"}
- Host
Ocpu float64Count - The OCPU count of the ESXi host.
- Host
Shape stringName - The compute shape name of the ESXi host. ListSupportedHostShapes.
- Next
Sku string - Non
Upgraded stringEsxi Host Id - (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. - Sddc
Id string (Optional) The OCID of the SDDC to add the ESXi host to. This field has been deprecated. Please use
cluster_id
instead. Eithersddc_id
orcluster_id
must be configured foroci.Ocvp.EsxiHost
resource. Deprecated. Please usecluster_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
- billing
Donor StringHost Id - (Optional) (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.
- capacity
Reservation StringId - The OCID of the Capacity Reservation.
- cluster
Id String - The OCID of the Cluster to add the ESXi host to.
- compute
Availability StringDomain - 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 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. - 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"}
- display
Name 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, andinstanceDisplayNamePrefix
isMyCluster
, the host's display name isMyCluster-4
.Avoid entering confidential information.
- esxi
Software StringVersion - (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 StringHost Id - (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. - 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"}
- host
Ocpu DoubleCount - The OCPU count of the ESXi host.
- host
Shape StringName - The compute shape name of the ESXi host. ListSupportedHostShapes.
- next
Sku String - non
Upgraded StringEsxi Host Id - (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. - sddc
Id String (Optional) The OCID of the SDDC to add the ESXi host to. This field has been deprecated. Please use
cluster_id
instead. Eithersddc_id
orcluster_id
must be configured foroci.Ocvp.EsxiHost
resource. Deprecated. Please usecluster_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
- billing
Donor stringHost Id - (Optional) (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.
- capacity
Reservation stringId - The OCID of the Capacity Reservation.
- cluster
Id string - The OCID of the Cluster to add the ESXi host to.
- compute
Availability stringDomain - 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 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. - {[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"}
- display
Name 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, andinstanceDisplayNamePrefix
isMyCluster
, the host's display name isMyCluster-4
.Avoid entering confidential information.
- esxi
Software stringVersion - (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 stringHost Id - (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. - {[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"}
- host
Ocpu numberCount - The OCPU count of the ESXi host.
- host
Shape stringName - The compute shape name of the ESXi host. ListSupportedHostShapes.
- next
Sku string - non
Upgraded stringEsxi Host Id - (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. - sddc
Id string (Optional) The OCID of the SDDC to add the ESXi host to. This field has been deprecated. Please use
cluster_id
instead. Eithersddc_id
orcluster_id
must be configured foroci.Ocvp.EsxiHost
resource. Deprecated. Please usecluster_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
- billing_
donor_ strhost_ id - (Optional) (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.
- capacity_
reservation_ strid - The OCID of the Capacity Reservation.
- cluster_
id str - The OCID of the Cluster to add the ESXi host to.
- compute_
availability_ strdomain - 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. - 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, andinstanceDisplayNamePrefix
isMyCluster
, the host's display name isMyCluster-4
.Avoid entering confidential information.
- esxi_
software_ strversion - (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_ strhost_ id - (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. - 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_ floatcount - The OCPU count of the ESXi host.
- host_
shape_ strname - The compute shape name of the ESXi host. ListSupportedHostShapes.
- next_
sku str - non_
upgraded_ stresxi_ host_ id - (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. - 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. Eithersddc_id
orcluster_id
must be configured foroci.Ocvp.EsxiHost
resource. Deprecated. Please usecluster_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
- billing
Donor StringHost Id - (Optional) (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.
- capacity
Reservation StringId - The OCID of the Capacity Reservation.
- cluster
Id String - The OCID of the Cluster to add the ESXi host to.
- compute
Availability StringDomain - 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 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. - 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"}
- display
Name 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, andinstanceDisplayNamePrefix
isMyCluster
, the host's display name isMyCluster-4
.Avoid entering confidential information.
- esxi
Software StringVersion - (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 StringHost Id - (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. - 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"}
- host
Ocpu NumberCount - The OCPU count of the ESXi host.
- host
Shape StringName - The compute shape name of the ESXi host. ListSupportedHostShapes.
- next
Sku String - non
Upgraded StringEsxi Host Id - (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. - sddc
Id String (Optional) The OCID of the SDDC to add the ESXi host to. This field has been deprecated. Please use
cluster_id
instead. Eithersddc_id
orcluster_id
must be configured foroci.Ocvp.EsxiHost
resource. Deprecated. Please usecluster_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
Outputs
All input properties are implicitly available as output properties. Additionally, the EsxiHost resource produces the following output properties:
- Billing
Contract stringEnd Date - Current billing cycle end date. If the value in
currentCommitment
andnextCommitment
are different, the value specified innextCommitment
becomes the newcurrentCommitment
when thecontractEndDate
is reached. Example:2016-08-25T21:10:29.600Z
- Compartment
Id string - The OCID of the compartment that contains the Cluster.
- Compute
Instance stringId - 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 string - The billing option currently used by the ESXi host. ListSupportedCommitments.
- Grace
Period stringEnd Date - 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.
- Is
Billing boolContinuation In Progress - Indicates whether this host is in the progress of billing continuation.
- Is
Billing boolSwapping In Progress - Indicates whether this host is in the progress of swapping billing.
- Next
Commitment 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. - Replacement
Esxi stringHost Id - The OCID of the esxi host that is newly created to replace the failed node.
- State string
- The current state of the ESXi host.
- Swap
Billing stringHost Id - The OCID of the active ESXi Host to swap billing with current host.
- Time
Created string - The date and time the ESXi host was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- Time
Updated string - The date and time the ESXi host was updated, in the format defined by RFC3339.
- Upgraded
Replacement stringEsxi Host Id - The OCID of the ESXi host that is newly created to upgrade the original host.
- Vmware
Software stringVersion - The version of VMware software that Oracle Cloud VMware Solution installed on the ESXi hosts.
- Billing
Contract stringEnd Date - Current billing cycle end date. If the value in
currentCommitment
andnextCommitment
are different, the value specified innextCommitment
becomes the newcurrentCommitment
when thecontractEndDate
is reached. Example:2016-08-25T21:10:29.600Z
- Compartment
Id string - The OCID of the compartment that contains the Cluster.
- Compute
Instance stringId - 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 string - The billing option currently used by the ESXi host. ListSupportedCommitments.
- Grace
Period stringEnd Date - 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.
- Is
Billing boolContinuation In Progress - Indicates whether this host is in the progress of billing continuation.
- Is
Billing boolSwapping In Progress - Indicates whether this host is in the progress of swapping billing.
- Next
Commitment 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. - Replacement
Esxi stringHost Id - The OCID of the esxi host that is newly created to replace the failed node.
- State string
- The current state of the ESXi host.
- Swap
Billing stringHost Id - The OCID of the active ESXi Host to swap billing with current host.
- Time
Created string - The date and time the ESXi host was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- Time
Updated string - The date and time the ESXi host was updated, in the format defined by RFC3339.
- Upgraded
Replacement stringEsxi Host Id - The OCID of the ESXi host that is newly created to upgrade the original host.
- Vmware
Software stringVersion - The version of VMware software that Oracle Cloud VMware Solution installed on the ESXi hosts.
- billing
Contract StringEnd Date - Current billing cycle end date. If the value in
currentCommitment
andnextCommitment
are different, the value specified innextCommitment
becomes the newcurrentCommitment
when thecontractEndDate
is reached. Example:2016-08-25T21:10:29.600Z
- compartment
Id String - The OCID of the compartment that contains the Cluster.
- compute
Instance StringId - 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 String - The billing option currently used by the ESXi host. ListSupportedCommitments.
- grace
Period StringEnd Date - 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.
- is
Billing BooleanContinuation In Progress - Indicates whether this host is in the progress of billing continuation.
- is
Billing BooleanSwapping In Progress - Indicates whether this host is in the progress of swapping billing.
- next
Commitment 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. - replacement
Esxi StringHost Id - The OCID of the esxi host that is newly created to replace the failed node.
- state String
- The current state of the ESXi host.
- swap
Billing StringHost Id - The OCID of the active ESXi Host to swap billing with current host.
- time
Created String - The date and time the ESXi host was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- time
Updated String - The date and time the ESXi host was updated, in the format defined by RFC3339.
- upgraded
Replacement StringEsxi Host Id - The OCID of the ESXi host that is newly created to upgrade the original host.
- vmware
Software StringVersion - The version of VMware software that Oracle Cloud VMware Solution installed on the ESXi hosts.
- billing
Contract stringEnd Date - Current billing cycle end date. If the value in
currentCommitment
andnextCommitment
are different, the value specified innextCommitment
becomes the newcurrentCommitment
when thecontractEndDate
is reached. Example:2016-08-25T21:10:29.600Z
- compartment
Id string - The OCID of the compartment that contains the Cluster.
- compute
Instance stringId - 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 string - The billing option currently used by the ESXi host. ListSupportedCommitments.
- grace
Period stringEnd Date - 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.
- is
Billing booleanContinuation In Progress - Indicates whether this host is in the progress of billing continuation.
- is
Billing booleanSwapping In Progress - Indicates whether this host is in the progress of swapping billing.
- next
Commitment 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. - replacement
Esxi stringHost Id - The OCID of the esxi host that is newly created to replace the failed node.
- state string
- The current state of the ESXi host.
- swap
Billing stringHost Id - The OCID of the active ESXi Host to swap billing with current host.
- time
Created string - The date and time the ESXi host was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- time
Updated string - The date and time the ESXi host was updated, in the format defined by RFC3339.
- upgraded
Replacement stringEsxi Host Id - The OCID of the ESXi host that is newly created to upgrade the original host.
- vmware
Software stringVersion - The version of VMware software that Oracle Cloud VMware Solution installed on the ESXi hosts.
- billing_
contract_ strend_ date - Current billing cycle end date. If the value in
currentCommitment
andnextCommitment
are different, the value specified innextCommitment
becomes the newcurrentCommitment
when thecontractEndDate
is reached. Example:2016-08-25T21:10:29.600Z
- compartment_
id str - The OCID of the compartment that contains the Cluster.
- compute_
instance_ strid - 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_ strend_ date - 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_ boolcontinuation_ in_ progress - Indicates whether this host is in the progress of billing continuation.
- is_
billing_ boolswapping_ in_ progress - 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_ strhost_ id - 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_ strhost_ id - 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_ stresxi_ host_ id - The OCID of the ESXi host that is newly created to upgrade the original host.
- vmware_
software_ strversion - The version of VMware software that Oracle Cloud VMware Solution installed on the ESXi hosts.
- billing
Contract StringEnd Date - Current billing cycle end date. If the value in
currentCommitment
andnextCommitment
are different, the value specified innextCommitment
becomes the newcurrentCommitment
when thecontractEndDate
is reached. Example:2016-08-25T21:10:29.600Z
- compartment
Id String - The OCID of the compartment that contains the Cluster.
- compute
Instance StringId - 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 String - The billing option currently used by the ESXi host. ListSupportedCommitments.
- grace
Period StringEnd Date - 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.
- is
Billing BooleanContinuation In Progress - Indicates whether this host is in the progress of billing continuation.
- is
Billing BooleanSwapping In Progress - Indicates whether this host is in the progress of swapping billing.
- next
Commitment 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. - replacement
Esxi StringHost Id - The OCID of the esxi host that is newly created to replace the failed node.
- state String
- The current state of the ESXi host.
- swap
Billing StringHost Id - The OCID of the active ESXi Host to swap billing with current host.
- time
Created String - The date and time the ESXi host was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- time
Updated String - The date and time the ESXi host was updated, in the format defined by RFC3339.
- upgraded
Replacement StringEsxi Host Id - The OCID of the ESXi host that is newly created to upgrade the original host.
- vmware
Software StringVersion - 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)
Resource lookup is not supported in YAML
- 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.
- Billing
Contract stringEnd Date - Current billing cycle end date. If the value in
currentCommitment
andnextCommitment
are different, the value specified innextCommitment
becomes the newcurrentCommitment
when thecontractEndDate
is reached. Example:2016-08-25T21:10:29.600Z
- Billing
Donor stringHost Id - (Optional) (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.
- Capacity
Reservation stringId - The OCID of the Capacity Reservation.
- Cluster
Id string - The OCID of the Cluster to add the ESXi host to.
- Compartment
Id string - The OCID of the compartment that contains the Cluster.
- Compute
Availability stringDomain - 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 stringId - 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 string - The billing option currently used by the ESXi host. ListSupportedCommitments.
- Current
Sku 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. - 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"}
- Display
Name 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, andinstanceDisplayNamePrefix
isMyCluster
, the host's display name isMyCluster-4
.Avoid entering confidential information.
- Esxi
Software stringVersion - (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 stringHost Id - (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. - 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"}
- Grace
Period stringEnd Date - The date and time when the new esxi host should start billing cycle. RFC3339. Example:
2021-07-25T21:10:29.600Z
- Host
Ocpu doubleCount - The OCPU count of the ESXi host.
- Host
Shape stringName - The compute shape name of the ESXi host. ListSupportedHostShapes.
- Is
Billing boolContinuation In Progress - Indicates whether this host is in the progress of billing continuation.
- Is
Billing boolSwapping In Progress - Indicates whether this host is in the progress of swapping billing.
- Next
Commitment 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. - Next
Sku string - Non
Upgraded stringEsxi Host Id - (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. - Replacement
Esxi stringHost Id - The OCID of the esxi host that is newly created to replace the failed node.
- Sddc
Id string (Optional) The OCID of the SDDC to add the ESXi host to. This field has been deprecated. Please use
cluster_id
instead. Eithersddc_id
orcluster_id
must be configured foroci.Ocvp.EsxiHost
resource. Deprecated. Please usecluster_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
- State string
- The current state of the ESXi host.
- Swap
Billing stringHost Id - The OCID of the active ESXi Host to swap billing with current host.
- Time
Created string - The date and time the ESXi host was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- Time
Updated string - The date and time the ESXi host was updated, in the format defined by RFC3339.
- Upgraded
Replacement stringEsxi Host Id - The OCID of the ESXi host that is newly created to upgrade the original host.
- Vmware
Software stringVersion - The version of VMware software that Oracle Cloud VMware Solution installed on the ESXi hosts.
- Billing
Contract stringEnd Date - Current billing cycle end date. If the value in
currentCommitment
andnextCommitment
are different, the value specified innextCommitment
becomes the newcurrentCommitment
when thecontractEndDate
is reached. Example:2016-08-25T21:10:29.600Z
- Billing
Donor stringHost Id - (Optional) (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.
- Capacity
Reservation stringId - The OCID of the Capacity Reservation.
- Cluster
Id string - The OCID of the Cluster to add the ESXi host to.
- Compartment
Id string - The OCID of the compartment that contains the Cluster.
- Compute
Availability stringDomain - 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 stringId - 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 string - The billing option currently used by the ESXi host. ListSupportedCommitments.
- Current
Sku 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. - 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"}
- Display
Name 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, andinstanceDisplayNamePrefix
isMyCluster
, the host's display name isMyCluster-4
.Avoid entering confidential information.
- Esxi
Software stringVersion - (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 stringHost Id - (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. - 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"}
- Grace
Period stringEnd Date - The date and time when the new esxi host should start billing cycle. RFC3339. Example:
2021-07-25T21:10:29.600Z
- Host
Ocpu float64Count - The OCPU count of the ESXi host.
- Host
Shape stringName - The compute shape name of the ESXi host. ListSupportedHostShapes.
- Is
Billing boolContinuation In Progress - Indicates whether this host is in the progress of billing continuation.
- Is
Billing boolSwapping In Progress - Indicates whether this host is in the progress of swapping billing.
- Next
Commitment 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. - Next
Sku string - Non
Upgraded stringEsxi Host Id - (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. - Replacement
Esxi stringHost Id - The OCID of the esxi host that is newly created to replace the failed node.
- Sddc
Id string (Optional) The OCID of the SDDC to add the ESXi host to. This field has been deprecated. Please use
cluster_id
instead. Eithersddc_id
orcluster_id
must be configured foroci.Ocvp.EsxiHost
resource. Deprecated. Please usecluster_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
- State string
- The current state of the ESXi host.
- Swap
Billing stringHost Id - The OCID of the active ESXi Host to swap billing with current host.
- Time
Created string - The date and time the ESXi host was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- Time
Updated string - The date and time the ESXi host was updated, in the format defined by RFC3339.
- Upgraded
Replacement stringEsxi Host Id - The OCID of the ESXi host that is newly created to upgrade the original host.
- Vmware
Software stringVersion - The version of VMware software that Oracle Cloud VMware Solution installed on the ESXi hosts.
- billing
Contract StringEnd Date - Current billing cycle end date. If the value in
currentCommitment
andnextCommitment
are different, the value specified innextCommitment
becomes the newcurrentCommitment
when thecontractEndDate
is reached. Example:2016-08-25T21:10:29.600Z
- billing
Donor StringHost Id - (Optional) (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.
- capacity
Reservation StringId - The OCID of the Capacity Reservation.
- cluster
Id String - The OCID of the Cluster to add the ESXi host to.
- compartment
Id String - The OCID of the compartment that contains the Cluster.
- compute
Availability StringDomain - 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 StringId - 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 String - The billing option currently used by the ESXi host. ListSupportedCommitments.
- current
Sku 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. - 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"}
- display
Name 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, andinstanceDisplayNamePrefix
isMyCluster
, the host's display name isMyCluster-4
.Avoid entering confidential information.
- esxi
Software StringVersion - (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 StringHost Id - (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. - 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"}
- grace
Period StringEnd Date - The date and time when the new esxi host should start billing cycle. RFC3339. Example:
2021-07-25T21:10:29.600Z
- host
Ocpu DoubleCount - The OCPU count of the ESXi host.
- host
Shape StringName - The compute shape name of the ESXi host. ListSupportedHostShapes.
- is
Billing BooleanContinuation In Progress - Indicates whether this host is in the progress of billing continuation.
- is
Billing BooleanSwapping In Progress - Indicates whether this host is in the progress of swapping billing.
- next
Commitment 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. - next
Sku String - non
Upgraded StringEsxi Host Id - (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. - replacement
Esxi StringHost Id - The OCID of the esxi host that is newly created to replace the failed node.
- sddc
Id String (Optional) The OCID of the SDDC to add the ESXi host to. This field has been deprecated. Please use
cluster_id
instead. Eithersddc_id
orcluster_id
must be configured foroci.Ocvp.EsxiHost
resource. Deprecated. Please usecluster_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
- state String
- The current state of the ESXi host.
- swap
Billing StringHost Id - The OCID of the active ESXi Host to swap billing with current host.
- time
Created String - The date and time the ESXi host was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- time
Updated String - The date and time the ESXi host was updated, in the format defined by RFC3339.
- upgraded
Replacement StringEsxi Host Id - The OCID of the ESXi host that is newly created to upgrade the original host.
- vmware
Software StringVersion - The version of VMware software that Oracle Cloud VMware Solution installed on the ESXi hosts.
- billing
Contract stringEnd Date - Current billing cycle end date. If the value in
currentCommitment
andnextCommitment
are different, the value specified innextCommitment
becomes the newcurrentCommitment
when thecontractEndDate
is reached. Example:2016-08-25T21:10:29.600Z
- billing
Donor stringHost Id - (Optional) (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.
- capacity
Reservation stringId - The OCID of the Capacity Reservation.
- cluster
Id string - The OCID of the Cluster to add the ESXi host to.
- compartment
Id string - The OCID of the compartment that contains the Cluster.
- compute
Availability stringDomain - 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 stringId - 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 string - The billing option currently used by the ESXi host. ListSupportedCommitments.
- current
Sku 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. - {[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"}
- display
Name 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, andinstanceDisplayNamePrefix
isMyCluster
, the host's display name isMyCluster-4
.Avoid entering confidential information.
- esxi
Software stringVersion - (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 stringHost Id - (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. - {[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"}
- grace
Period stringEnd Date - The date and time when the new esxi host should start billing cycle. RFC3339. Example:
2021-07-25T21:10:29.600Z
- host
Ocpu numberCount - The OCPU count of the ESXi host.
- host
Shape stringName - The compute shape name of the ESXi host. ListSupportedHostShapes.
- is
Billing booleanContinuation In Progress - Indicates whether this host is in the progress of billing continuation.
- is
Billing booleanSwapping In Progress - Indicates whether this host is in the progress of swapping billing.
- next
Commitment 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. - next
Sku string - non
Upgraded stringEsxi Host Id - (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. - replacement
Esxi stringHost Id - The OCID of the esxi host that is newly created to replace the failed node.
- sddc
Id string (Optional) The OCID of the SDDC to add the ESXi host to. This field has been deprecated. Please use
cluster_id
instead. Eithersddc_id
orcluster_id
must be configured foroci.Ocvp.EsxiHost
resource. Deprecated. Please usecluster_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
- state string
- The current state of the ESXi host.
- swap
Billing stringHost Id - The OCID of the active ESXi Host to swap billing with current host.
- time
Created string - The date and time the ESXi host was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- time
Updated string - The date and time the ESXi host was updated, in the format defined by RFC3339.
- upgraded
Replacement stringEsxi Host Id - The OCID of the ESXi host that is newly created to upgrade the original host.
- vmware
Software stringVersion - The version of VMware software that Oracle Cloud VMware Solution installed on the ESXi hosts.
- billing_
contract_ strend_ date - Current billing cycle end date. If the value in
currentCommitment
andnextCommitment
are different, the value specified innextCommitment
becomes the newcurrentCommitment
when thecontractEndDate
is reached. Example:2016-08-25T21:10:29.600Z
- billing_
donor_ strhost_ id - (Optional) (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.
- capacity_
reservation_ strid - 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_ strdomain - 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_ strid - 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. - 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, andinstanceDisplayNamePrefix
isMyCluster
, the host's display name isMyCluster-4
.Avoid entering confidential information.
- esxi_
software_ strversion - (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_ strhost_ id - (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. - 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_ strend_ date - The date and time when the new esxi host should start billing cycle. RFC3339. Example:
2021-07-25T21:10:29.600Z
- host_
ocpu_ floatcount - The OCPU count of the ESXi host.
- host_
shape_ strname - The compute shape name of the ESXi host. ListSupportedHostShapes.
- is_
billing_ boolcontinuation_ in_ progress - Indicates whether this host is in the progress of billing continuation.
- is_
billing_ boolswapping_ in_ progress - 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 - non_
upgraded_ stresxi_ host_ id - (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. - replacement_
esxi_ strhost_ id - 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. Eithersddc_id
orcluster_id
must be configured foroci.Ocvp.EsxiHost
resource. Deprecated. Please usecluster_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
- state str
- The current state of the ESXi host.
- swap_
billing_ strhost_ id - 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_ stresxi_ host_ id - The OCID of the ESXi host that is newly created to upgrade the original host.
- vmware_
software_ strversion - The version of VMware software that Oracle Cloud VMware Solution installed on the ESXi hosts.
- billing
Contract StringEnd Date - Current billing cycle end date. If the value in
currentCommitment
andnextCommitment
are different, the value specified innextCommitment
becomes the newcurrentCommitment
when thecontractEndDate
is reached. Example:2016-08-25T21:10:29.600Z
- billing
Donor StringHost Id - (Optional) (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.
- capacity
Reservation StringId - The OCID of the Capacity Reservation.
- cluster
Id String - The OCID of the Cluster to add the ESXi host to.
- compartment
Id String - The OCID of the compartment that contains the Cluster.
- compute
Availability StringDomain - 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 StringId - 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 String - The billing option currently used by the ESXi host. ListSupportedCommitments.
- current
Sku 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. - 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"}
- display
Name 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, andinstanceDisplayNamePrefix
isMyCluster
, the host's display name isMyCluster-4
.Avoid entering confidential information.
- esxi
Software StringVersion - (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 StringHost Id - (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. - 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"}
- grace
Period StringEnd Date - The date and time when the new esxi host should start billing cycle. RFC3339. Example:
2021-07-25T21:10:29.600Z
- host
Ocpu NumberCount - The OCPU count of the ESXi host.
- host
Shape StringName - The compute shape name of the ESXi host. ListSupportedHostShapes.
- is
Billing BooleanContinuation In Progress - Indicates whether this host is in the progress of billing continuation.
- is
Billing BooleanSwapping In Progress - Indicates whether this host is in the progress of swapping billing.
- next
Commitment 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. - next
Sku String - non
Upgraded StringEsxi Host Id - (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. - replacement
Esxi StringHost Id - The OCID of the esxi host that is newly created to replace the failed node.
- sddc
Id String (Optional) The OCID of the SDDC to add the ESXi host to. This field has been deprecated. Please use
cluster_id
instead. Eithersddc_id
orcluster_id
must be configured foroci.Ocvp.EsxiHost
resource. Deprecated. Please usecluster_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
- state String
- The current state of the ESXi host.
- swap
Billing StringHost Id - The OCID of the active ESXi Host to swap billing with current host.
- time
Created String - The date and time the ESXi host was created, in the format defined by RFC3339. Example:
2016-08-25T21:10:29.600Z
- time
Updated String - The date and time the ESXi host was updated, in the format defined by RFC3339.
- upgraded
Replacement StringEsxi Host Id - The OCID of the ESXi host that is newly created to upgrade the original host.
- vmware
Software StringVersion - 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.