oci.Ocvp.EsxiHost
Explore with Pulumi AI
This resource provides the Esxi Host resource in Oracle Cloud Infrastructure Oracle Cloud VMware Solution service.
Adds another ESXi host to an existing SDDC. The attributes of the specified
Sddc
determine the VMware software and other configuration settings used
by the ESXi host.
Use the WorkRequest operations to track the creation of the ESXi host.
Create EsxiHost Resource
new EsxiHost(name: string, args: EsxiHostArgs, opts?: CustomResourceOptions);
@overload
def EsxiHost(resource_name: str,
opts: Optional[ResourceOptions] = None,
billing_donor_host_id: Optional[str] = None,
capacity_reservation_id: Optional[str] = None,
compute_availability_domain: Optional[str] = None,
current_sku: Optional[str] = None,
defined_tags: Optional[Mapping[str, Any]] = None,
display_name: Optional[str] = None,
failed_esxi_host_id: Optional[str] = None,
freeform_tags: Optional[Mapping[str, Any]] = 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,
swap_billing_host_id: Optional[str] = None)
@overload
def EsxiHost(resource_name: str,
args: EsxiHostArgs,
opts: Optional[ResourceOptions] = None)
func NewEsxiHost(ctx *Context, name string, args EsxiHostArgs, opts ...ResourceOption) (*EsxiHost, error)
public EsxiHost(string name, EsxiHostArgs args, 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.
- 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.
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
The EsxiHost resource accepts the following input properties:
- Sddc
Id string The OCID of the SDDC to add the ESXi host to.
** 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 (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.
- Capacity
Reservation stringId The OCID of the Capacity Reservation.
- Compute
Availability stringDomain The availability domain to create the ESXi host in. If keep empty, for AD-specific SDDC, new ESXi host will be created in the same availability domain; for multi-AD SDDC, new ESXi host will be auto assigned to the next availability domain following evenly distribution strategy.
- Current
Sku string 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.
- Dictionary<string, object>
(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 SDDC.
If this attribute is not specified, the SDDC'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 SDDC, andinstanceDisplayNamePrefix
isMySDDC
, the host's display name isMySDDC-4
.Avoid entering confidential information.
- Failed
Esxi stringHost Id 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, object>
(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 The billing option to switch to after the current billing cycle ends. If
nextSku
is null or empty,currentSku
continues to the next billing cycle. ListSupportedSkus.- Non
Upgraded stringEsxi Host Id 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.- Swap
Billing stringHost Id The OCID of the active ESXi Host to swap billing with current host.
- Sddc
Id string The OCID of the SDDC to add the ESXi host to.
** 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 (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.
- Capacity
Reservation stringId The OCID of the Capacity Reservation.
- Compute
Availability stringDomain The availability domain to create the ESXi host in. If keep empty, for AD-specific SDDC, new ESXi host will be created in the same availability domain; for multi-AD SDDC, new ESXi host will be auto assigned to the next availability domain following evenly distribution strategy.
- Current
Sku string 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.
- map[string]interface{}
(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 SDDC.
If this attribute is not specified, the SDDC'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 SDDC, andinstanceDisplayNamePrefix
isMySDDC
, the host's display name isMySDDC-4
.Avoid entering confidential information.
- Failed
Esxi stringHost Id 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]interface{}
(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 The billing option to switch to after the current billing cycle ends. If
nextSku
is null or empty,currentSku
continues to the next billing cycle. ListSupportedSkus.- Non
Upgraded stringEsxi Host Id 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.- Swap
Billing stringHost Id The OCID of the active ESXi Host to swap billing with current host.
- sddc
Id String The OCID of the SDDC to add the ESXi host to.
** 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 (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.
- capacity
Reservation StringId The OCID of the Capacity Reservation.
- compute
Availability StringDomain The availability domain to create the ESXi host in. If keep empty, for AD-specific SDDC, new ESXi host will be created in the same availability domain; for multi-AD SDDC, new ESXi host will be auto assigned to the next availability domain following evenly distribution strategy.
- current
Sku String 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.
- Map<String,Object>
(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 SDDC.
If this attribute is not specified, the SDDC'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 SDDC, andinstanceDisplayNamePrefix
isMySDDC
, the host's display name isMySDDC-4
.Avoid entering confidential information.
- failed
Esxi StringHost Id 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,Object>
(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 The billing option to switch to after the current billing cycle ends. If
nextSku
is null or empty,currentSku
continues to the next billing cycle. ListSupportedSkus.- non
Upgraded StringEsxi Host Id 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.- swap
Billing StringHost Id The OCID of the active ESXi Host to swap billing with current host.
- sddc
Id string The OCID of the SDDC to add the ESXi host to.
** 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 (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.
- capacity
Reservation stringId The OCID of the Capacity Reservation.
- compute
Availability stringDomain The availability domain to create the ESXi host in. If keep empty, for AD-specific SDDC, new ESXi host will be created in the same availability domain; for multi-AD SDDC, new ESXi host will be auto assigned to the next availability domain following evenly distribution strategy.
- current
Sku string 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.
- {[key: string]: any}
(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 SDDC.
If this attribute is not specified, the SDDC'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 SDDC, andinstanceDisplayNamePrefix
isMySDDC
, the host's display name isMySDDC-4
.Avoid entering confidential information.
- failed
Esxi stringHost Id 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]: any}
(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 The billing option to switch to after the current billing cycle ends. If
nextSku
is null or empty,currentSku
continues to the next billing cycle. ListSupportedSkus.- non
Upgraded stringEsxi Host Id 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.- swap
Billing stringHost Id The OCID of the active ESXi Host to swap billing with current host.
- sddc_
id str The OCID of the SDDC to add the ESXi host to.
** 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 (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.
- capacity_
reservation_ strid The OCID of the Capacity Reservation.
- compute_
availability_ strdomain The availability domain to create the ESXi host in. If keep empty, for AD-specific SDDC, new ESXi host will be created in the same availability domain; for multi-AD SDDC, new ESXi host will be auto assigned to the next availability domain following evenly distribution strategy.
- current_
sku str 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.
- Mapping[str, Any]
(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 SDDC.
If this attribute is not specified, the SDDC'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 SDDC, andinstanceDisplayNamePrefix
isMySDDC
, the host's display name isMySDDC-4
.Avoid entering confidential information.
- failed_
esxi_ strhost_ id 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, Any]
(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 The billing option to switch to after the current billing cycle ends. If
nextSku
is null or empty,currentSku
continues to the next billing cycle. ListSupportedSkus.- non_
upgraded_ stresxi_ host_ id 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.- swap_
billing_ strhost_ id The OCID of the active ESXi Host to swap billing with current host.
- sddc
Id String The OCID of the SDDC to add the ESXi host to.
** 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 (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.
- capacity
Reservation StringId The OCID of the Capacity Reservation.
- compute
Availability StringDomain The availability domain to create the ESXi host in. If keep empty, for AD-specific SDDC, new ESXi host will be created in the same availability domain; for multi-AD SDDC, new ESXi host will be auto assigned to the next availability domain following evenly distribution strategy.
- current
Sku String 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.
- Map<Any>
(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 SDDC.
If this attribute is not specified, the SDDC'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 SDDC, andinstanceDisplayNamePrefix
isMySDDC
, the host's display name isMySDDC-4
.Avoid entering confidential information.
- failed
Esxi StringHost Id 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<Any>
(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 The billing option to switch to after the current billing cycle ends. If
nextSku
is null or empty,currentSku
continues to the next billing cycle. ListSupportedSkus.- non
Upgraded StringEsxi Host Id 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.- swap
Billing StringHost Id The OCID of the active ESXi Host to swap billing with current host.
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
currentSku
andnextSku
are different, the value specified innextSku
becomes the newcurrentSKU
when thecontractEndDate
is reached. Example:2016-08-25T21:10:29.600Z
- Compartment
Id string The OCID of the compartment that contains the SDDC.
- 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.- 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.
- 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.
- 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
currentSku
andnextSku
are different, the value specified innextSku
becomes the newcurrentSKU
when thecontractEndDate
is reached. Example:2016-08-25T21:10:29.600Z
- Compartment
Id string The OCID of the compartment that contains the SDDC.
- 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.- 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.
- 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.
- 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
currentSku
andnextSku
are different, the value specified innextSku
becomes the newcurrentSKU
when thecontractEndDate
is reached. Example:2016-08-25T21:10:29.600Z
- compartment
Id String The OCID of the compartment that contains the SDDC.
- 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.- 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.
- 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.
- 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
currentSku
andnextSku
are different, the value specified innextSku
becomes the newcurrentSKU
when thecontractEndDate
is reached. Example:2016-08-25T21:10:29.600Z
- compartment
Id string The OCID of the compartment that contains the SDDC.
- 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.- 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.
- 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.
- 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
currentSku
andnextSku
are different, the value specified innextSku
becomes the newcurrentSKU
when thecontractEndDate
is reached. Example:2016-08-25T21:10:29.600Z
- compartment_
id str The OCID of the compartment that contains the SDDC.
- 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.- 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.
- 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.
- 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
currentSku
andnextSku
are different, the value specified innextSku
becomes the newcurrentSKU
when thecontractEndDate
is reached. Example:2016-08-25T21:10:29.600Z
- compartment
Id String The OCID of the compartment that contains the SDDC.
- 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.- 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.
- 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.
- 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,
compartment_id: Optional[str] = None,
compute_availability_domain: Optional[str] = None,
compute_instance_id: Optional[str] = None,
current_sku: Optional[str] = None,
defined_tags: Optional[Mapping[str, Any]] = None,
display_name: Optional[str] = None,
failed_esxi_host_id: Optional[str] = None,
freeform_tags: Optional[Mapping[str, Any]] = 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_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
currentSku
andnextSku
are different, the value specified innextSku
becomes the newcurrentSKU
when thecontractEndDate
is reached. Example:2016-08-25T21:10:29.600Z
- Billing
Donor stringHost Id (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.
- Capacity
Reservation stringId The OCID of the Capacity Reservation.
- Compartment
Id string The OCID of the compartment that contains the SDDC.
- Compute
Availability stringDomain The availability domain to create the ESXi host in. If keep empty, for AD-specific SDDC, new ESXi host will be created in the same availability domain; for multi-AD SDDC, 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
Sku string 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.
- Dictionary<string, object>
(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 SDDC.
If this attribute is not specified, the SDDC'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 SDDC, andinstanceDisplayNamePrefix
isMySDDC
, the host's display name isMySDDC-4
.Avoid entering confidential information.
- Failed
Esxi stringHost Id 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, object>
(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
Sku string The billing option to switch to after the current billing cycle ends. If
nextSku
is null or empty,currentSku
continues to the next billing cycle. ListSupportedSkus.- Non
Upgraded stringEsxi Host Id 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 The OCID of the SDDC to add the ESXi host to.
** 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
currentSku
andnextSku
are different, the value specified innextSku
becomes the newcurrentSKU
when thecontractEndDate
is reached. Example:2016-08-25T21:10:29.600Z
- Billing
Donor stringHost Id (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.
- Capacity
Reservation stringId The OCID of the Capacity Reservation.
- Compartment
Id string The OCID of the compartment that contains the SDDC.
- Compute
Availability stringDomain The availability domain to create the ESXi host in. If keep empty, for AD-specific SDDC, new ESXi host will be created in the same availability domain; for multi-AD SDDC, 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
Sku string 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.
- map[string]interface{}
(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 SDDC.
If this attribute is not specified, the SDDC'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 SDDC, andinstanceDisplayNamePrefix
isMySDDC
, the host's display name isMySDDC-4
.Avoid entering confidential information.
- Failed
Esxi stringHost Id 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]interface{}
(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
Sku string The billing option to switch to after the current billing cycle ends. If
nextSku
is null or empty,currentSku
continues to the next billing cycle. ListSupportedSkus.- Non
Upgraded stringEsxi Host Id 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 The OCID of the SDDC to add the ESXi host to.
** 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
currentSku
andnextSku
are different, the value specified innextSku
becomes the newcurrentSKU
when thecontractEndDate
is reached. Example:2016-08-25T21:10:29.600Z
- billing
Donor StringHost Id (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.
- capacity
Reservation StringId The OCID of the Capacity Reservation.
- compartment
Id String The OCID of the compartment that contains the SDDC.
- compute
Availability StringDomain The availability domain to create the ESXi host in. If keep empty, for AD-specific SDDC, new ESXi host will be created in the same availability domain; for multi-AD SDDC, 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
Sku String 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.
- Map<String,Object>
(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 SDDC.
If this attribute is not specified, the SDDC'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 SDDC, andinstanceDisplayNamePrefix
isMySDDC
, the host's display name isMySDDC-4
.Avoid entering confidential information.
- failed
Esxi StringHost Id 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,Object>
(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
Sku String The billing option to switch to after the current billing cycle ends. If
nextSku
is null or empty,currentSku
continues to the next billing cycle. ListSupportedSkus.- non
Upgraded StringEsxi Host Id 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 The OCID of the SDDC to add the ESXi host to.
** 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
currentSku
andnextSku
are different, the value specified innextSku
becomes the newcurrentSKU
when thecontractEndDate
is reached. Example:2016-08-25T21:10:29.600Z
- billing
Donor stringHost Id (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.
- capacity
Reservation stringId The OCID of the Capacity Reservation.
- compartment
Id string The OCID of the compartment that contains the SDDC.
- compute
Availability stringDomain The availability domain to create the ESXi host in. If keep empty, for AD-specific SDDC, new ESXi host will be created in the same availability domain; for multi-AD SDDC, 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
Sku string 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.
- {[key: string]: any}
(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 SDDC.
If this attribute is not specified, the SDDC'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 SDDC, andinstanceDisplayNamePrefix
isMySDDC
, the host's display name isMySDDC-4
.Avoid entering confidential information.
- failed
Esxi stringHost Id 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]: any}
(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
Sku string The billing option to switch to after the current billing cycle ends. If
nextSku
is null or empty,currentSku
continues to the next billing cycle. ListSupportedSkus.- non
Upgraded stringEsxi Host Id 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 The OCID of the SDDC to add the ESXi host to.
** 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
currentSku
andnextSku
are different, the value specified innextSku
becomes the newcurrentSKU
when thecontractEndDate
is reached. Example:2016-08-25T21:10:29.600Z
- billing_
donor_ strhost_ id (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.
- capacity_
reservation_ strid The OCID of the Capacity Reservation.
- compartment_
id str The OCID of the compartment that contains the SDDC.
- compute_
availability_ strdomain The availability domain to create the ESXi host in. If keep empty, for AD-specific SDDC, new ESXi host will be created in the same availability domain; for multi-AD SDDC, 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_
sku str 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.
- Mapping[str, Any]
(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 SDDC.
If this attribute is not specified, the SDDC'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 SDDC, andinstanceDisplayNamePrefix
isMySDDC
, the host's display name isMySDDC-4
.Avoid entering confidential information.
- failed_
esxi_ strhost_ id 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, Any]
(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_
sku str The billing option to switch to after the current billing cycle ends. If
nextSku
is null or empty,currentSku
continues to the next billing cycle. ListSupportedSkus.- non_
upgraded_ stresxi_ host_ id 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 The OCID of the SDDC to add the ESXi host to.
** 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
currentSku
andnextSku
are different, the value specified innextSku
becomes the newcurrentSKU
when thecontractEndDate
is reached. Example:2016-08-25T21:10:29.600Z
- billing
Donor StringHost Id (Updatable) The OCID of the deleted ESXi Host with LeftOver billing cycle.
- capacity
Reservation StringId The OCID of the Capacity Reservation.
- compartment
Id String The OCID of the compartment that contains the SDDC.
- compute
Availability StringDomain The availability domain to create the ESXi host in. If keep empty, for AD-specific SDDC, new ESXi host will be created in the same availability domain; for multi-AD SDDC, 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
Sku String 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.
- Map<Any>
(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 SDDC.
If this attribute is not specified, the SDDC'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 SDDC, andinstanceDisplayNamePrefix
isMySDDC
, the host's display name isMySDDC-4
.Avoid entering confidential information.
- failed
Esxi StringHost Id 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<Any>
(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
Sku String The billing option to switch to after the current billing cycle ends. If
nextSku
is null or empty,currentSku
continues to the next billing cycle. ListSupportedSkus.- non
Upgraded StringEsxi Host Id 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 The OCID of the SDDC to add the ESXi host to.
** 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.
Import
EsxiHosts can be imported using the id
, e.g.
$ pulumi import oci:Ocvp/esxiHost:EsxiHost test_esxi_host "id"
Package Details
- Repository
- oci pulumi/pulumi-oci
- License
- Apache-2.0
- Notes
This Pulumi package is based on the
oci
Terraform Provider.