pulumi-vsphere 4.10.0a1710245029__py3-none-any.whl → 4.13.0a1736836157__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Potentially problematic release.
This version of pulumi-vsphere might be problematic. Click here for more details.
- pulumi_vsphere/__init__.py +28 -0
- pulumi_vsphere/_inputs.py +1816 -277
- pulumi_vsphere/_utilities.py +41 -5
- pulumi_vsphere/compute_cluster.py +937 -1488
- pulumi_vsphere/compute_cluster_host_group.py +67 -2
- pulumi_vsphere/compute_cluster_vm_affinity_rule.py +69 -34
- pulumi_vsphere/compute_cluster_vm_anti_affinity_rule.py +41 -2
- pulumi_vsphere/compute_cluster_vm_dependency_rule.py +205 -2
- pulumi_vsphere/compute_cluster_vm_group.py +198 -2
- pulumi_vsphere/compute_cluster_vm_host_rule.py +73 -2
- pulumi_vsphere/config/__init__.pyi +5 -0
- pulumi_vsphere/config/vars.py +5 -0
- pulumi_vsphere/content_library.py +113 -12
- pulumi_vsphere/content_library_item.py +143 -2
- pulumi_vsphere/custom_attribute.py +77 -2
- pulumi_vsphere/datacenter.py +48 -40
- pulumi_vsphere/datastore_cluster.py +217 -366
- pulumi_vsphere/datastore_cluster_vm_anti_affinity_rule.py +159 -2
- pulumi_vsphere/distributed_port_group.py +416 -189
- pulumi_vsphere/distributed_virtual_switch.py +571 -830
- pulumi_vsphere/dpm_host_override.py +63 -2
- pulumi_vsphere/drs_vm_override.py +67 -2
- pulumi_vsphere/entity_permissions.py +64 -38
- pulumi_vsphere/file.py +21 -24
- pulumi_vsphere/folder.py +148 -30
- pulumi_vsphere/get_compute_cluster.py +16 -9
- pulumi_vsphere/get_compute_cluster_host_group.py +36 -25
- pulumi_vsphere/get_content_library.py +23 -15
- pulumi_vsphere/get_content_library_item.py +29 -13
- pulumi_vsphere/get_custom_attribute.py +14 -9
- pulumi_vsphere/get_datacenter.py +30 -12
- pulumi_vsphere/get_datastore.py +29 -21
- pulumi_vsphere/get_datastore_cluster.py +31 -10
- pulumi_vsphere/get_datastore_stats.py +63 -57
- pulumi_vsphere/get_distributed_virtual_switch.py +18 -9
- pulumi_vsphere/get_dynamic.py +35 -25
- pulumi_vsphere/get_folder.py +23 -11
- pulumi_vsphere/get_guest_os_customization.py +26 -52
- pulumi_vsphere/get_host.py +16 -9
- pulumi_vsphere/get_host_base_images.py +104 -0
- pulumi_vsphere/get_host_pci_device.py +28 -19
- pulumi_vsphere/get_host_thumbprint.py +41 -25
- pulumi_vsphere/get_host_vgpu_profile.py +20 -15
- pulumi_vsphere/get_license.py +20 -10
- pulumi_vsphere/get_network.py +80 -24
- pulumi_vsphere/get_ovf_vm_template.py +56 -5
- pulumi_vsphere/get_policy.py +13 -9
- pulumi_vsphere/get_resource_pool.py +29 -23
- pulumi_vsphere/get_role.py +23 -13
- pulumi_vsphere/get_tag.py +16 -9
- pulumi_vsphere/get_tag_category.py +16 -9
- pulumi_vsphere/get_vapp_container.py +15 -9
- pulumi_vsphere/get_virtual_machine.py +205 -48
- pulumi_vsphere/get_vmfs_disks.py +18 -9
- pulumi_vsphere/guest_os_customization.py +60 -5
- pulumi_vsphere/ha_vm_override.py +352 -380
- pulumi_vsphere/host.py +244 -64
- pulumi_vsphere/host_port_group.py +27 -24
- pulumi_vsphere/host_virtual_switch.py +209 -289
- pulumi_vsphere/license.py +5 -32
- pulumi_vsphere/nas_datastore.py +74 -9
- pulumi_vsphere/offline_software_depot.py +185 -0
- pulumi_vsphere/outputs.py +717 -270
- pulumi_vsphere/provider.py +7 -6
- pulumi_vsphere/pulumi-plugin.json +2 -1
- pulumi_vsphere/resource_pool.py +168 -411
- pulumi_vsphere/role.py +33 -2
- pulumi_vsphere/storage_drs_vm_override.py +133 -2
- pulumi_vsphere/supervisor.py +967 -0
- pulumi_vsphere/tag.py +159 -2
- pulumi_vsphere/tag_category.py +83 -2
- pulumi_vsphere/vapp_container.py +163 -2
- pulumi_vsphere/vapp_entity.py +147 -2
- pulumi_vsphere/virtual_disk.py +123 -36
- pulumi_vsphere/virtual_machine.py +698 -829
- pulumi_vsphere/virtual_machine_class.py +447 -0
- pulumi_vsphere/virtual_machine_snapshot.py +13 -12
- pulumi_vsphere/vm_storage_policy.py +120 -127
- pulumi_vsphere/vmfs_datastore.py +271 -2
- pulumi_vsphere/vnic.py +104 -105
- {pulumi_vsphere-4.10.0a1710245029.dist-info → pulumi_vsphere-4.13.0a1736836157.dist-info}/METADATA +7 -6
- pulumi_vsphere-4.13.0a1736836157.dist-info/RECORD +86 -0
- {pulumi_vsphere-4.10.0a1710245029.dist-info → pulumi_vsphere-4.13.0a1736836157.dist-info}/WHEEL +1 -1
- pulumi_vsphere-4.10.0a1710245029.dist-info/RECORD +0 -82
- {pulumi_vsphere-4.10.0a1710245029.dist-info → pulumi_vsphere-4.13.0a1736836157.dist-info}/top_level.txt +0 -0
pulumi_vsphere/ha_vm_override.py
CHANGED
|
@@ -4,9 +4,14 @@
|
|
|
4
4
|
|
|
5
5
|
import copy
|
|
6
6
|
import warnings
|
|
7
|
+
import sys
|
|
7
8
|
import pulumi
|
|
8
9
|
import pulumi.runtime
|
|
9
10
|
from typing import Any, Mapping, Optional, Sequence, Union, overload
|
|
11
|
+
if sys.version_info >= (3, 11):
|
|
12
|
+
from typing import NotRequired, TypedDict, TypeAlias
|
|
13
|
+
else:
|
|
14
|
+
from typing_extensions import NotRequired, TypedDict, TypeAlias
|
|
10
15
|
from . import _utilities
|
|
11
16
|
|
|
12
17
|
__all__ = ['HaVmOverrideArgs', 'HaVmOverride']
|
|
@@ -31,60 +36,33 @@ class HaVmOverrideArgs:
|
|
|
31
36
|
ha_vm_restart_timeout: Optional[pulumi.Input[int]] = None):
|
|
32
37
|
"""
|
|
33
38
|
The set of arguments for constructing a HaVmOverride resource.
|
|
34
|
-
:param pulumi.Input[str] compute_cluster_id: The managed object
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
:param pulumi.Input[
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
:param pulumi.Input[
|
|
56
|
-
machine
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
:param pulumi.Input[int]
|
|
60
|
-
|
|
61
|
-
is marked as failed. The value is in seconds. Default: `30`.
|
|
62
|
-
:param pulumi.Input[int] ha_vm_maximum_failure_window: The length of the reset window in
|
|
63
|
-
which `ha_vm_maximum_resets` can operate. When this
|
|
64
|
-
window expires, no more resets are attempted regardless of the setting
|
|
65
|
-
configured in `ha_vm_maximum_resets`. `-1` means no window, meaning an
|
|
66
|
-
unlimited reset time is allotted. The value is specified in seconds. Default:
|
|
67
|
-
`-1` (no window).
|
|
68
|
-
:param pulumi.Input[int] ha_vm_maximum_resets: The maximum number of resets that HA will
|
|
69
|
-
perform to this virtual machine when responding to a failure event. Default:
|
|
70
|
-
`3`
|
|
71
|
-
:param pulumi.Input[int] ha_vm_minimum_uptime: The time, in seconds, that HA waits after
|
|
72
|
-
powering on this virtual machine before monitoring for heartbeats. Default:
|
|
73
|
-
`120` (2 minutes).
|
|
74
|
-
:param pulumi.Input[str] ha_vm_monitoring: The type of virtual machine monitoring to use
|
|
75
|
-
when HA is enabled in the cluster. Can be one of `vmMonitoringDisabled`,
|
|
76
|
-
`vmMonitoringOnly`, or `vmAndAppMonitoring`. Default: `vmMonitoringDisabled`.
|
|
77
|
-
:param pulumi.Input[bool] ha_vm_monitoring_use_cluster_defaults: Determines whether or
|
|
78
|
-
not the cluster's default settings or the VM override settings specified in
|
|
79
|
-
this resource are used for virtual machine monitoring. The default is `true`
|
|
80
|
-
(use cluster defaults) - set to `false` to have overrides take effect.
|
|
81
|
-
:param pulumi.Input[str] ha_vm_restart_priority: The restart priority for the virtual
|
|
82
|
-
machine when vSphere detects a host failure. Can be one of
|
|
83
|
-
`clusterRestartPriority`, `lowest`, `low`, `medium`, `high`, `highest`, or `disabled`.
|
|
84
|
-
Default: `clusterRestartPriority`.
|
|
85
|
-
:param pulumi.Input[int] ha_vm_restart_timeout: The maximum time, in seconds, that
|
|
86
|
-
vSphere HA will wait for this virtual machine to be ready. Use `-1` to
|
|
87
|
-
specify the cluster default. Default: `-1`.
|
|
39
|
+
:param pulumi.Input[str] compute_cluster_id: The managed object ID of the cluster.
|
|
40
|
+
:param pulumi.Input[str] virtual_machine_id: The managed object ID of the virtual machine.
|
|
41
|
+
:param pulumi.Input[str] ha_datastore_apd_recovery_action: Controls the action to take on this virtual machine if an APD status on an affected datastore clears in the middle of an
|
|
42
|
+
APD event. Can be one of useClusterDefault, none or reset.
|
|
43
|
+
:param pulumi.Input[str] ha_datastore_apd_response: Controls the action to take on this virtual machine when the cluster has detected loss to all paths to a relevant
|
|
44
|
+
datastore. Can be one of clusterDefault, disabled, warning, restartConservative, or restartAggressive.
|
|
45
|
+
:param pulumi.Input[int] ha_datastore_apd_response_delay: Controls the delay in seconds to wait after an APD timeout event to execute the response action defined in
|
|
46
|
+
ha_datastore_apd_response. Specify -1 to use the cluster setting.
|
|
47
|
+
:param pulumi.Input[str] ha_datastore_pdl_response: Controls the action to take on this virtual machine when the cluster has detected a permanent device loss to a relevant
|
|
48
|
+
datastore. Can be one of clusterDefault, disabled, warning, or restartAggressive.
|
|
49
|
+
:param pulumi.Input[str] ha_host_isolation_response: The action to take on this virtual machine when a host is isolated from the rest of the cluster. Can be one of
|
|
50
|
+
clusterIsolationResponse, none, powerOff, or shutdown.
|
|
51
|
+
:param pulumi.Input[int] ha_vm_failure_interval: If a heartbeat from this virtual machine is not received within this configured interval, the virtual machine is marked
|
|
52
|
+
as failed. The value is in seconds.
|
|
53
|
+
:param pulumi.Input[int] ha_vm_maximum_failure_window: The length of the reset window in which ha_vm_maximum_resets can operate. When this window expires, no more resets are
|
|
54
|
+
attempted regardless of the setting configured in ha_vm_maximum_resets. -1 means no window, meaning an unlimited reset
|
|
55
|
+
time is allotted.
|
|
56
|
+
:param pulumi.Input[int] ha_vm_maximum_resets: The maximum number of resets that HA will perform to this virtual machine when responding to a failure event.
|
|
57
|
+
:param pulumi.Input[int] ha_vm_minimum_uptime: The time, in seconds, that HA waits after powering on this virtual machine before monitoring for heartbeats.
|
|
58
|
+
:param pulumi.Input[str] ha_vm_monitoring: The type of virtual machine monitoring to use for this virtual machine. Can be one of vmMonitoringDisabled,
|
|
59
|
+
vmMonitoringOnly, or vmAndAppMonitoring.
|
|
60
|
+
:param pulumi.Input[bool] ha_vm_monitoring_use_cluster_defaults: Determines whether or not the cluster's default settings or the VM override settings specified in this resource are used
|
|
61
|
+
for virtual machine monitoring. The default is true (use cluster defaults) - set to false to have overrides take effect.
|
|
62
|
+
:param pulumi.Input[str] ha_vm_restart_priority: The restart priority for this virtual machine when vSphere detects a host failure. Can be one of clusterRestartPriority,
|
|
63
|
+
lowest, low, medium, high, or highest.
|
|
64
|
+
:param pulumi.Input[int] ha_vm_restart_timeout: The maximum time, in seconds, that vSphere HA will wait for the virtual machine to be ready. Use -1 to use the cluster
|
|
65
|
+
default.
|
|
88
66
|
"""
|
|
89
67
|
pulumi.set(__self__, "compute_cluster_id", compute_cluster_id)
|
|
90
68
|
pulumi.set(__self__, "virtual_machine_id", virtual_machine_id)
|
|
@@ -119,9 +97,7 @@ class HaVmOverrideArgs:
|
|
|
119
97
|
@pulumi.getter(name="computeClusterId")
|
|
120
98
|
def compute_cluster_id(self) -> pulumi.Input[str]:
|
|
121
99
|
"""
|
|
122
|
-
The managed object
|
|
123
|
-
ID of the cluster to put the override in. Forces a new
|
|
124
|
-
resource if changed.
|
|
100
|
+
The managed object ID of the cluster.
|
|
125
101
|
"""
|
|
126
102
|
return pulumi.get(self, "compute_cluster_id")
|
|
127
103
|
|
|
@@ -133,8 +109,7 @@ class HaVmOverrideArgs:
|
|
|
133
109
|
@pulumi.getter(name="virtualMachineId")
|
|
134
110
|
def virtual_machine_id(self) -> pulumi.Input[str]:
|
|
135
111
|
"""
|
|
136
|
-
The
|
|
137
|
-
the override for. Forces a new resource if changed.
|
|
112
|
+
The managed object ID of the virtual machine.
|
|
138
113
|
"""
|
|
139
114
|
return pulumi.get(self, "virtual_machine_id")
|
|
140
115
|
|
|
@@ -146,10 +121,8 @@ class HaVmOverrideArgs:
|
|
|
146
121
|
@pulumi.getter(name="haDatastoreApdRecoveryAction")
|
|
147
122
|
def ha_datastore_apd_recovery_action(self) -> Optional[pulumi.Input[str]]:
|
|
148
123
|
"""
|
|
149
|
-
Controls the action to take
|
|
150
|
-
|
|
151
|
-
the middle of an APD event. Can be one of `useClusterDefault`, `none` or
|
|
152
|
-
`reset`. Default: `useClusterDefault`.
|
|
124
|
+
Controls the action to take on this virtual machine if an APD status on an affected datastore clears in the middle of an
|
|
125
|
+
APD event. Can be one of useClusterDefault, none or reset.
|
|
153
126
|
"""
|
|
154
127
|
return pulumi.get(self, "ha_datastore_apd_recovery_action")
|
|
155
128
|
|
|
@@ -161,10 +134,8 @@ class HaVmOverrideArgs:
|
|
|
161
134
|
@pulumi.getter(name="haDatastoreApdResponse")
|
|
162
135
|
def ha_datastore_apd_response(self) -> Optional[pulumi.Input[str]]:
|
|
163
136
|
"""
|
|
164
|
-
Controls the action to take on this
|
|
165
|
-
|
|
166
|
-
datastore. Can be one of `clusterDefault`, `disabled`, `warning`,
|
|
167
|
-
`restartConservative`, or `restartAggressive`. Default: `clusterDefault`.
|
|
137
|
+
Controls the action to take on this virtual machine when the cluster has detected loss to all paths to a relevant
|
|
138
|
+
datastore. Can be one of clusterDefault, disabled, warning, restartConservative, or restartAggressive.
|
|
168
139
|
"""
|
|
169
140
|
return pulumi.get(self, "ha_datastore_apd_response")
|
|
170
141
|
|
|
@@ -176,10 +147,8 @@ class HaVmOverrideArgs:
|
|
|
176
147
|
@pulumi.getter(name="haDatastoreApdResponseDelay")
|
|
177
148
|
def ha_datastore_apd_response_delay(self) -> Optional[pulumi.Input[int]]:
|
|
178
149
|
"""
|
|
179
|
-
Controls the delay in seconds
|
|
180
|
-
|
|
181
|
-
`ha_datastore_apd_response`. Use `-1` to use
|
|
182
|
-
the cluster default. Default: `-1`.
|
|
150
|
+
Controls the delay in seconds to wait after an APD timeout event to execute the response action defined in
|
|
151
|
+
ha_datastore_apd_response. Specify -1 to use the cluster setting.
|
|
183
152
|
"""
|
|
184
153
|
return pulumi.get(self, "ha_datastore_apd_response_delay")
|
|
185
154
|
|
|
@@ -191,10 +160,8 @@ class HaVmOverrideArgs:
|
|
|
191
160
|
@pulumi.getter(name="haDatastorePdlResponse")
|
|
192
161
|
def ha_datastore_pdl_response(self) -> Optional[pulumi.Input[str]]:
|
|
193
162
|
"""
|
|
194
|
-
Controls the action to take on this
|
|
195
|
-
|
|
196
|
-
relevant datastore. Can be one of `clusterDefault`, `disabled`, `warning`, or
|
|
197
|
-
`restartAggressive`. Default: `clusterDefault`.
|
|
163
|
+
Controls the action to take on this virtual machine when the cluster has detected a permanent device loss to a relevant
|
|
164
|
+
datastore. Can be one of clusterDefault, disabled, warning, or restartAggressive.
|
|
198
165
|
"""
|
|
199
166
|
return pulumi.get(self, "ha_datastore_pdl_response")
|
|
200
167
|
|
|
@@ -206,10 +173,8 @@ class HaVmOverrideArgs:
|
|
|
206
173
|
@pulumi.getter(name="haHostIsolationResponse")
|
|
207
174
|
def ha_host_isolation_response(self) -> Optional[pulumi.Input[str]]:
|
|
208
175
|
"""
|
|
209
|
-
The action to take on this virtual
|
|
210
|
-
|
|
211
|
-
the cluster. Can be one of `clusterIsolationResponse`, `none`, `powerOff`, or
|
|
212
|
-
`shutdown`. Default: `clusterIsolationResponse`.
|
|
176
|
+
The action to take on this virtual machine when a host is isolated from the rest of the cluster. Can be one of
|
|
177
|
+
clusterIsolationResponse, none, powerOff, or shutdown.
|
|
213
178
|
"""
|
|
214
179
|
return pulumi.get(self, "ha_host_isolation_response")
|
|
215
180
|
|
|
@@ -221,9 +186,8 @@ class HaVmOverrideArgs:
|
|
|
221
186
|
@pulumi.getter(name="haVmFailureInterval")
|
|
222
187
|
def ha_vm_failure_interval(self) -> Optional[pulumi.Input[int]]:
|
|
223
188
|
"""
|
|
224
|
-
If a heartbeat from this virtual
|
|
225
|
-
|
|
226
|
-
is marked as failed. The value is in seconds. Default: `30`.
|
|
189
|
+
If a heartbeat from this virtual machine is not received within this configured interval, the virtual machine is marked
|
|
190
|
+
as failed. The value is in seconds.
|
|
227
191
|
"""
|
|
228
192
|
return pulumi.get(self, "ha_vm_failure_interval")
|
|
229
193
|
|
|
@@ -235,12 +199,9 @@ class HaVmOverrideArgs:
|
|
|
235
199
|
@pulumi.getter(name="haVmMaximumFailureWindow")
|
|
236
200
|
def ha_vm_maximum_failure_window(self) -> Optional[pulumi.Input[int]]:
|
|
237
201
|
"""
|
|
238
|
-
The length of the reset window in
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
configured in `ha_vm_maximum_resets`. `-1` means no window, meaning an
|
|
242
|
-
unlimited reset time is allotted. The value is specified in seconds. Default:
|
|
243
|
-
`-1` (no window).
|
|
202
|
+
The length of the reset window in which ha_vm_maximum_resets can operate. When this window expires, no more resets are
|
|
203
|
+
attempted regardless of the setting configured in ha_vm_maximum_resets. -1 means no window, meaning an unlimited reset
|
|
204
|
+
time is allotted.
|
|
244
205
|
"""
|
|
245
206
|
return pulumi.get(self, "ha_vm_maximum_failure_window")
|
|
246
207
|
|
|
@@ -252,9 +213,7 @@ class HaVmOverrideArgs:
|
|
|
252
213
|
@pulumi.getter(name="haVmMaximumResets")
|
|
253
214
|
def ha_vm_maximum_resets(self) -> Optional[pulumi.Input[int]]:
|
|
254
215
|
"""
|
|
255
|
-
The maximum number of resets that HA will
|
|
256
|
-
perform to this virtual machine when responding to a failure event. Default:
|
|
257
|
-
`3`
|
|
216
|
+
The maximum number of resets that HA will perform to this virtual machine when responding to a failure event.
|
|
258
217
|
"""
|
|
259
218
|
return pulumi.get(self, "ha_vm_maximum_resets")
|
|
260
219
|
|
|
@@ -266,9 +225,7 @@ class HaVmOverrideArgs:
|
|
|
266
225
|
@pulumi.getter(name="haVmMinimumUptime")
|
|
267
226
|
def ha_vm_minimum_uptime(self) -> Optional[pulumi.Input[int]]:
|
|
268
227
|
"""
|
|
269
|
-
The time, in seconds, that HA waits after
|
|
270
|
-
powering on this virtual machine before monitoring for heartbeats. Default:
|
|
271
|
-
`120` (2 minutes).
|
|
228
|
+
The time, in seconds, that HA waits after powering on this virtual machine before monitoring for heartbeats.
|
|
272
229
|
"""
|
|
273
230
|
return pulumi.get(self, "ha_vm_minimum_uptime")
|
|
274
231
|
|
|
@@ -280,9 +237,8 @@ class HaVmOverrideArgs:
|
|
|
280
237
|
@pulumi.getter(name="haVmMonitoring")
|
|
281
238
|
def ha_vm_monitoring(self) -> Optional[pulumi.Input[str]]:
|
|
282
239
|
"""
|
|
283
|
-
The type of virtual machine monitoring to use
|
|
284
|
-
|
|
285
|
-
`vmMonitoringOnly`, or `vmAndAppMonitoring`. Default: `vmMonitoringDisabled`.
|
|
240
|
+
The type of virtual machine monitoring to use for this virtual machine. Can be one of vmMonitoringDisabled,
|
|
241
|
+
vmMonitoringOnly, or vmAndAppMonitoring.
|
|
286
242
|
"""
|
|
287
243
|
return pulumi.get(self, "ha_vm_monitoring")
|
|
288
244
|
|
|
@@ -294,10 +250,8 @@ class HaVmOverrideArgs:
|
|
|
294
250
|
@pulumi.getter(name="haVmMonitoringUseClusterDefaults")
|
|
295
251
|
def ha_vm_monitoring_use_cluster_defaults(self) -> Optional[pulumi.Input[bool]]:
|
|
296
252
|
"""
|
|
297
|
-
Determines whether or
|
|
298
|
-
|
|
299
|
-
this resource are used for virtual machine monitoring. The default is `true`
|
|
300
|
-
(use cluster defaults) - set to `false` to have overrides take effect.
|
|
253
|
+
Determines whether or not the cluster's default settings or the VM override settings specified in this resource are used
|
|
254
|
+
for virtual machine monitoring. The default is true (use cluster defaults) - set to false to have overrides take effect.
|
|
301
255
|
"""
|
|
302
256
|
return pulumi.get(self, "ha_vm_monitoring_use_cluster_defaults")
|
|
303
257
|
|
|
@@ -309,10 +263,8 @@ class HaVmOverrideArgs:
|
|
|
309
263
|
@pulumi.getter(name="haVmRestartPriority")
|
|
310
264
|
def ha_vm_restart_priority(self) -> Optional[pulumi.Input[str]]:
|
|
311
265
|
"""
|
|
312
|
-
The restart priority for
|
|
313
|
-
|
|
314
|
-
`clusterRestartPriority`, `lowest`, `low`, `medium`, `high`, `highest`, or `disabled`.
|
|
315
|
-
Default: `clusterRestartPriority`.
|
|
266
|
+
The restart priority for this virtual machine when vSphere detects a host failure. Can be one of clusterRestartPriority,
|
|
267
|
+
lowest, low, medium, high, or highest.
|
|
316
268
|
"""
|
|
317
269
|
return pulumi.get(self, "ha_vm_restart_priority")
|
|
318
270
|
|
|
@@ -324,9 +276,8 @@ class HaVmOverrideArgs:
|
|
|
324
276
|
@pulumi.getter(name="haVmRestartTimeout")
|
|
325
277
|
def ha_vm_restart_timeout(self) -> Optional[pulumi.Input[int]]:
|
|
326
278
|
"""
|
|
327
|
-
The maximum time, in seconds, that
|
|
328
|
-
|
|
329
|
-
specify the cluster default. Default: `-1`.
|
|
279
|
+
The maximum time, in seconds, that vSphere HA will wait for the virtual machine to be ready. Use -1 to use the cluster
|
|
280
|
+
default.
|
|
330
281
|
"""
|
|
331
282
|
return pulumi.get(self, "ha_vm_restart_timeout")
|
|
332
283
|
|
|
@@ -355,60 +306,33 @@ class _HaVmOverrideState:
|
|
|
355
306
|
virtual_machine_id: Optional[pulumi.Input[str]] = None):
|
|
356
307
|
"""
|
|
357
308
|
Input properties used for looking up and filtering HaVmOverride resources.
|
|
358
|
-
:param pulumi.Input[str] compute_cluster_id: The managed object
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
:param pulumi.Input[str]
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
:param pulumi.Input[str]
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
:param pulumi.Input[int]
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
the
|
|
373
|
-
|
|
374
|
-
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
:param pulumi.Input[
|
|
385
|
-
which `ha_vm_maximum_resets` can operate. When this
|
|
386
|
-
window expires, no more resets are attempted regardless of the setting
|
|
387
|
-
configured in `ha_vm_maximum_resets`. `-1` means no window, meaning an
|
|
388
|
-
unlimited reset time is allotted. The value is specified in seconds. Default:
|
|
389
|
-
`-1` (no window).
|
|
390
|
-
:param pulumi.Input[int] ha_vm_maximum_resets: The maximum number of resets that HA will
|
|
391
|
-
perform to this virtual machine when responding to a failure event. Default:
|
|
392
|
-
`3`
|
|
393
|
-
:param pulumi.Input[int] ha_vm_minimum_uptime: The time, in seconds, that HA waits after
|
|
394
|
-
powering on this virtual machine before monitoring for heartbeats. Default:
|
|
395
|
-
`120` (2 minutes).
|
|
396
|
-
:param pulumi.Input[str] ha_vm_monitoring: The type of virtual machine monitoring to use
|
|
397
|
-
when HA is enabled in the cluster. Can be one of `vmMonitoringDisabled`,
|
|
398
|
-
`vmMonitoringOnly`, or `vmAndAppMonitoring`. Default: `vmMonitoringDisabled`.
|
|
399
|
-
:param pulumi.Input[bool] ha_vm_monitoring_use_cluster_defaults: Determines whether or
|
|
400
|
-
not the cluster's default settings or the VM override settings specified in
|
|
401
|
-
this resource are used for virtual machine monitoring. The default is `true`
|
|
402
|
-
(use cluster defaults) - set to `false` to have overrides take effect.
|
|
403
|
-
:param pulumi.Input[str] ha_vm_restart_priority: The restart priority for the virtual
|
|
404
|
-
machine when vSphere detects a host failure. Can be one of
|
|
405
|
-
`clusterRestartPriority`, `lowest`, `low`, `medium`, `high`, `highest`, or `disabled`.
|
|
406
|
-
Default: `clusterRestartPriority`.
|
|
407
|
-
:param pulumi.Input[int] ha_vm_restart_timeout: The maximum time, in seconds, that
|
|
408
|
-
vSphere HA will wait for this virtual machine to be ready. Use `-1` to
|
|
409
|
-
specify the cluster default. Default: `-1`.
|
|
410
|
-
:param pulumi.Input[str] virtual_machine_id: The UUID of the virtual machine to create
|
|
411
|
-
the override for. Forces a new resource if changed.
|
|
309
|
+
:param pulumi.Input[str] compute_cluster_id: The managed object ID of the cluster.
|
|
310
|
+
:param pulumi.Input[str] ha_datastore_apd_recovery_action: Controls the action to take on this virtual machine if an APD status on an affected datastore clears in the middle of an
|
|
311
|
+
APD event. Can be one of useClusterDefault, none or reset.
|
|
312
|
+
:param pulumi.Input[str] ha_datastore_apd_response: Controls the action to take on this virtual machine when the cluster has detected loss to all paths to a relevant
|
|
313
|
+
datastore. Can be one of clusterDefault, disabled, warning, restartConservative, or restartAggressive.
|
|
314
|
+
:param pulumi.Input[int] ha_datastore_apd_response_delay: Controls the delay in seconds to wait after an APD timeout event to execute the response action defined in
|
|
315
|
+
ha_datastore_apd_response. Specify -1 to use the cluster setting.
|
|
316
|
+
:param pulumi.Input[str] ha_datastore_pdl_response: Controls the action to take on this virtual machine when the cluster has detected a permanent device loss to a relevant
|
|
317
|
+
datastore. Can be one of clusterDefault, disabled, warning, or restartAggressive.
|
|
318
|
+
:param pulumi.Input[str] ha_host_isolation_response: The action to take on this virtual machine when a host is isolated from the rest of the cluster. Can be one of
|
|
319
|
+
clusterIsolationResponse, none, powerOff, or shutdown.
|
|
320
|
+
:param pulumi.Input[int] ha_vm_failure_interval: If a heartbeat from this virtual machine is not received within this configured interval, the virtual machine is marked
|
|
321
|
+
as failed. The value is in seconds.
|
|
322
|
+
:param pulumi.Input[int] ha_vm_maximum_failure_window: The length of the reset window in which ha_vm_maximum_resets can operate. When this window expires, no more resets are
|
|
323
|
+
attempted regardless of the setting configured in ha_vm_maximum_resets. -1 means no window, meaning an unlimited reset
|
|
324
|
+
time is allotted.
|
|
325
|
+
:param pulumi.Input[int] ha_vm_maximum_resets: The maximum number of resets that HA will perform to this virtual machine when responding to a failure event.
|
|
326
|
+
:param pulumi.Input[int] ha_vm_minimum_uptime: The time, in seconds, that HA waits after powering on this virtual machine before monitoring for heartbeats.
|
|
327
|
+
:param pulumi.Input[str] ha_vm_monitoring: The type of virtual machine monitoring to use for this virtual machine. Can be one of vmMonitoringDisabled,
|
|
328
|
+
vmMonitoringOnly, or vmAndAppMonitoring.
|
|
329
|
+
:param pulumi.Input[bool] ha_vm_monitoring_use_cluster_defaults: Determines whether or not the cluster's default settings or the VM override settings specified in this resource are used
|
|
330
|
+
for virtual machine monitoring. The default is true (use cluster defaults) - set to false to have overrides take effect.
|
|
331
|
+
:param pulumi.Input[str] ha_vm_restart_priority: The restart priority for this virtual machine when vSphere detects a host failure. Can be one of clusterRestartPriority,
|
|
332
|
+
lowest, low, medium, high, or highest.
|
|
333
|
+
:param pulumi.Input[int] ha_vm_restart_timeout: The maximum time, in seconds, that vSphere HA will wait for the virtual machine to be ready. Use -1 to use the cluster
|
|
334
|
+
default.
|
|
335
|
+
:param pulumi.Input[str] virtual_machine_id: The managed object ID of the virtual machine.
|
|
412
336
|
"""
|
|
413
337
|
if compute_cluster_id is not None:
|
|
414
338
|
pulumi.set(__self__, "compute_cluster_id", compute_cluster_id)
|
|
@@ -445,9 +369,7 @@ class _HaVmOverrideState:
|
|
|
445
369
|
@pulumi.getter(name="computeClusterId")
|
|
446
370
|
def compute_cluster_id(self) -> Optional[pulumi.Input[str]]:
|
|
447
371
|
"""
|
|
448
|
-
The managed object
|
|
449
|
-
ID of the cluster to put the override in. Forces a new
|
|
450
|
-
resource if changed.
|
|
372
|
+
The managed object ID of the cluster.
|
|
451
373
|
"""
|
|
452
374
|
return pulumi.get(self, "compute_cluster_id")
|
|
453
375
|
|
|
@@ -459,10 +381,8 @@ class _HaVmOverrideState:
|
|
|
459
381
|
@pulumi.getter(name="haDatastoreApdRecoveryAction")
|
|
460
382
|
def ha_datastore_apd_recovery_action(self) -> Optional[pulumi.Input[str]]:
|
|
461
383
|
"""
|
|
462
|
-
Controls the action to take
|
|
463
|
-
|
|
464
|
-
the middle of an APD event. Can be one of `useClusterDefault`, `none` or
|
|
465
|
-
`reset`. Default: `useClusterDefault`.
|
|
384
|
+
Controls the action to take on this virtual machine if an APD status on an affected datastore clears in the middle of an
|
|
385
|
+
APD event. Can be one of useClusterDefault, none or reset.
|
|
466
386
|
"""
|
|
467
387
|
return pulumi.get(self, "ha_datastore_apd_recovery_action")
|
|
468
388
|
|
|
@@ -474,10 +394,8 @@ class _HaVmOverrideState:
|
|
|
474
394
|
@pulumi.getter(name="haDatastoreApdResponse")
|
|
475
395
|
def ha_datastore_apd_response(self) -> Optional[pulumi.Input[str]]:
|
|
476
396
|
"""
|
|
477
|
-
Controls the action to take on this
|
|
478
|
-
|
|
479
|
-
datastore. Can be one of `clusterDefault`, `disabled`, `warning`,
|
|
480
|
-
`restartConservative`, or `restartAggressive`. Default: `clusterDefault`.
|
|
397
|
+
Controls the action to take on this virtual machine when the cluster has detected loss to all paths to a relevant
|
|
398
|
+
datastore. Can be one of clusterDefault, disabled, warning, restartConservative, or restartAggressive.
|
|
481
399
|
"""
|
|
482
400
|
return pulumi.get(self, "ha_datastore_apd_response")
|
|
483
401
|
|
|
@@ -489,10 +407,8 @@ class _HaVmOverrideState:
|
|
|
489
407
|
@pulumi.getter(name="haDatastoreApdResponseDelay")
|
|
490
408
|
def ha_datastore_apd_response_delay(self) -> Optional[pulumi.Input[int]]:
|
|
491
409
|
"""
|
|
492
|
-
Controls the delay in seconds
|
|
493
|
-
|
|
494
|
-
`ha_datastore_apd_response`. Use `-1` to use
|
|
495
|
-
the cluster default. Default: `-1`.
|
|
410
|
+
Controls the delay in seconds to wait after an APD timeout event to execute the response action defined in
|
|
411
|
+
ha_datastore_apd_response. Specify -1 to use the cluster setting.
|
|
496
412
|
"""
|
|
497
413
|
return pulumi.get(self, "ha_datastore_apd_response_delay")
|
|
498
414
|
|
|
@@ -504,10 +420,8 @@ class _HaVmOverrideState:
|
|
|
504
420
|
@pulumi.getter(name="haDatastorePdlResponse")
|
|
505
421
|
def ha_datastore_pdl_response(self) -> Optional[pulumi.Input[str]]:
|
|
506
422
|
"""
|
|
507
|
-
Controls the action to take on this
|
|
508
|
-
|
|
509
|
-
relevant datastore. Can be one of `clusterDefault`, `disabled`, `warning`, or
|
|
510
|
-
`restartAggressive`. Default: `clusterDefault`.
|
|
423
|
+
Controls the action to take on this virtual machine when the cluster has detected a permanent device loss to a relevant
|
|
424
|
+
datastore. Can be one of clusterDefault, disabled, warning, or restartAggressive.
|
|
511
425
|
"""
|
|
512
426
|
return pulumi.get(self, "ha_datastore_pdl_response")
|
|
513
427
|
|
|
@@ -519,10 +433,8 @@ class _HaVmOverrideState:
|
|
|
519
433
|
@pulumi.getter(name="haHostIsolationResponse")
|
|
520
434
|
def ha_host_isolation_response(self) -> Optional[pulumi.Input[str]]:
|
|
521
435
|
"""
|
|
522
|
-
The action to take on this virtual
|
|
523
|
-
|
|
524
|
-
the cluster. Can be one of `clusterIsolationResponse`, `none`, `powerOff`, or
|
|
525
|
-
`shutdown`. Default: `clusterIsolationResponse`.
|
|
436
|
+
The action to take on this virtual machine when a host is isolated from the rest of the cluster. Can be one of
|
|
437
|
+
clusterIsolationResponse, none, powerOff, or shutdown.
|
|
526
438
|
"""
|
|
527
439
|
return pulumi.get(self, "ha_host_isolation_response")
|
|
528
440
|
|
|
@@ -534,9 +446,8 @@ class _HaVmOverrideState:
|
|
|
534
446
|
@pulumi.getter(name="haVmFailureInterval")
|
|
535
447
|
def ha_vm_failure_interval(self) -> Optional[pulumi.Input[int]]:
|
|
536
448
|
"""
|
|
537
|
-
If a heartbeat from this virtual
|
|
538
|
-
|
|
539
|
-
is marked as failed. The value is in seconds. Default: `30`.
|
|
449
|
+
If a heartbeat from this virtual machine is not received within this configured interval, the virtual machine is marked
|
|
450
|
+
as failed. The value is in seconds.
|
|
540
451
|
"""
|
|
541
452
|
return pulumi.get(self, "ha_vm_failure_interval")
|
|
542
453
|
|
|
@@ -548,12 +459,9 @@ class _HaVmOverrideState:
|
|
|
548
459
|
@pulumi.getter(name="haVmMaximumFailureWindow")
|
|
549
460
|
def ha_vm_maximum_failure_window(self) -> Optional[pulumi.Input[int]]:
|
|
550
461
|
"""
|
|
551
|
-
The length of the reset window in
|
|
552
|
-
|
|
553
|
-
|
|
554
|
-
configured in `ha_vm_maximum_resets`. `-1` means no window, meaning an
|
|
555
|
-
unlimited reset time is allotted. The value is specified in seconds. Default:
|
|
556
|
-
`-1` (no window).
|
|
462
|
+
The length of the reset window in which ha_vm_maximum_resets can operate. When this window expires, no more resets are
|
|
463
|
+
attempted regardless of the setting configured in ha_vm_maximum_resets. -1 means no window, meaning an unlimited reset
|
|
464
|
+
time is allotted.
|
|
557
465
|
"""
|
|
558
466
|
return pulumi.get(self, "ha_vm_maximum_failure_window")
|
|
559
467
|
|
|
@@ -565,9 +473,7 @@ class _HaVmOverrideState:
|
|
|
565
473
|
@pulumi.getter(name="haVmMaximumResets")
|
|
566
474
|
def ha_vm_maximum_resets(self) -> Optional[pulumi.Input[int]]:
|
|
567
475
|
"""
|
|
568
|
-
The maximum number of resets that HA will
|
|
569
|
-
perform to this virtual machine when responding to a failure event. Default:
|
|
570
|
-
`3`
|
|
476
|
+
The maximum number of resets that HA will perform to this virtual machine when responding to a failure event.
|
|
571
477
|
"""
|
|
572
478
|
return pulumi.get(self, "ha_vm_maximum_resets")
|
|
573
479
|
|
|
@@ -579,9 +485,7 @@ class _HaVmOverrideState:
|
|
|
579
485
|
@pulumi.getter(name="haVmMinimumUptime")
|
|
580
486
|
def ha_vm_minimum_uptime(self) -> Optional[pulumi.Input[int]]:
|
|
581
487
|
"""
|
|
582
|
-
The time, in seconds, that HA waits after
|
|
583
|
-
powering on this virtual machine before monitoring for heartbeats. Default:
|
|
584
|
-
`120` (2 minutes).
|
|
488
|
+
The time, in seconds, that HA waits after powering on this virtual machine before monitoring for heartbeats.
|
|
585
489
|
"""
|
|
586
490
|
return pulumi.get(self, "ha_vm_minimum_uptime")
|
|
587
491
|
|
|
@@ -593,9 +497,8 @@ class _HaVmOverrideState:
|
|
|
593
497
|
@pulumi.getter(name="haVmMonitoring")
|
|
594
498
|
def ha_vm_monitoring(self) -> Optional[pulumi.Input[str]]:
|
|
595
499
|
"""
|
|
596
|
-
The type of virtual machine monitoring to use
|
|
597
|
-
|
|
598
|
-
`vmMonitoringOnly`, or `vmAndAppMonitoring`. Default: `vmMonitoringDisabled`.
|
|
500
|
+
The type of virtual machine monitoring to use for this virtual machine. Can be one of vmMonitoringDisabled,
|
|
501
|
+
vmMonitoringOnly, or vmAndAppMonitoring.
|
|
599
502
|
"""
|
|
600
503
|
return pulumi.get(self, "ha_vm_monitoring")
|
|
601
504
|
|
|
@@ -607,10 +510,8 @@ class _HaVmOverrideState:
|
|
|
607
510
|
@pulumi.getter(name="haVmMonitoringUseClusterDefaults")
|
|
608
511
|
def ha_vm_monitoring_use_cluster_defaults(self) -> Optional[pulumi.Input[bool]]:
|
|
609
512
|
"""
|
|
610
|
-
Determines whether or
|
|
611
|
-
|
|
612
|
-
this resource are used for virtual machine monitoring. The default is `true`
|
|
613
|
-
(use cluster defaults) - set to `false` to have overrides take effect.
|
|
513
|
+
Determines whether or not the cluster's default settings or the VM override settings specified in this resource are used
|
|
514
|
+
for virtual machine monitoring. The default is true (use cluster defaults) - set to false to have overrides take effect.
|
|
614
515
|
"""
|
|
615
516
|
return pulumi.get(self, "ha_vm_monitoring_use_cluster_defaults")
|
|
616
517
|
|
|
@@ -622,10 +523,8 @@ class _HaVmOverrideState:
|
|
|
622
523
|
@pulumi.getter(name="haVmRestartPriority")
|
|
623
524
|
def ha_vm_restart_priority(self) -> Optional[pulumi.Input[str]]:
|
|
624
525
|
"""
|
|
625
|
-
The restart priority for
|
|
626
|
-
|
|
627
|
-
`clusterRestartPriority`, `lowest`, `low`, `medium`, `high`, `highest`, or `disabled`.
|
|
628
|
-
Default: `clusterRestartPriority`.
|
|
526
|
+
The restart priority for this virtual machine when vSphere detects a host failure. Can be one of clusterRestartPriority,
|
|
527
|
+
lowest, low, medium, high, or highest.
|
|
629
528
|
"""
|
|
630
529
|
return pulumi.get(self, "ha_vm_restart_priority")
|
|
631
530
|
|
|
@@ -637,9 +536,8 @@ class _HaVmOverrideState:
|
|
|
637
536
|
@pulumi.getter(name="haVmRestartTimeout")
|
|
638
537
|
def ha_vm_restart_timeout(self) -> Optional[pulumi.Input[int]]:
|
|
639
538
|
"""
|
|
640
|
-
The maximum time, in seconds, that
|
|
641
|
-
|
|
642
|
-
specify the cluster default. Default: `-1`.
|
|
539
|
+
The maximum time, in seconds, that vSphere HA will wait for the virtual machine to be ready. Use -1 to use the cluster
|
|
540
|
+
default.
|
|
643
541
|
"""
|
|
644
542
|
return pulumi.get(self, "ha_vm_restart_timeout")
|
|
645
543
|
|
|
@@ -651,8 +549,7 @@ class _HaVmOverrideState:
|
|
|
651
549
|
@pulumi.getter(name="virtualMachineId")
|
|
652
550
|
def virtual_machine_id(self) -> Optional[pulumi.Input[str]]:
|
|
653
551
|
"""
|
|
654
|
-
The
|
|
655
|
-
the override for. Forces a new resource if changed.
|
|
552
|
+
The managed object ID of the virtual machine.
|
|
656
553
|
"""
|
|
657
554
|
return pulumi.get(self, "virtual_machine_id")
|
|
658
555
|
|
|
@@ -683,63 +580,114 @@ class HaVmOverride(pulumi.CustomResource):
|
|
|
683
580
|
virtual_machine_id: Optional[pulumi.Input[str]] = None,
|
|
684
581
|
__props__=None):
|
|
685
582
|
"""
|
|
686
|
-
|
|
583
|
+
The `HaVmOverride` resource can be used to add an override for
|
|
584
|
+
vSphere HA settings on a cluster for a specific virtual machine. With this
|
|
585
|
+
resource, one can control specific HA settings so that they are different than
|
|
586
|
+
the cluster default, accommodating the needs of that specific virtual machine,
|
|
587
|
+
while not affecting the rest of the cluster.
|
|
588
|
+
|
|
589
|
+
For more information on vSphere HA, see [this page][ref-vsphere-ha-clusters].
|
|
590
|
+
|
|
591
|
+
[ref-vsphere-ha-clusters]: https://docs.vmware.com/en/VMware-vSphere/8.0/vsphere-availability/GUID-5432CA24-14F1-44E3-87FB-61D937831CF6.html
|
|
592
|
+
|
|
593
|
+
> **NOTE:** This resource requires vCenter and is not available on direct ESXi
|
|
594
|
+
connections.
|
|
595
|
+
|
|
596
|
+
## Example Usage
|
|
597
|
+
|
|
598
|
+
The example below creates a virtual machine in a cluster using the
|
|
599
|
+
`VirtualMachine` resource, creating the
|
|
600
|
+
virtual machine in the cluster looked up by the
|
|
601
|
+
`ComputeCluster` data source.
|
|
602
|
+
|
|
603
|
+
Considering a scenario where this virtual machine is of high value to the
|
|
604
|
+
application or organization for which it does its work, it's been determined in
|
|
605
|
+
the event of a host failure, that this should be one of the first virtual
|
|
606
|
+
machines to be started by vSphere HA during recovery. Hence, it
|
|
607
|
+
`ha_vm_restart_priority` has been set to `highest`,
|
|
608
|
+
which, assuming that the default restart priority is `medium` and no other
|
|
609
|
+
virtual machine has been assigned the `highest` priority, will mean that this
|
|
610
|
+
VM will be started before any other virtual machine in the event of host
|
|
611
|
+
failure.
|
|
612
|
+
|
|
613
|
+
```python
|
|
614
|
+
import pulumi
|
|
615
|
+
import pulumi_vsphere as vsphere
|
|
616
|
+
|
|
617
|
+
datacenter = vsphere.get_datacenter(name="dc-01")
|
|
618
|
+
datastore = vsphere.get_datastore(name="datastore1",
|
|
619
|
+
datacenter_id=datacenter.id)
|
|
620
|
+
cluster = vsphere.get_compute_cluster(name="cluster-01",
|
|
621
|
+
datacenter_id=datacenter.id)
|
|
622
|
+
network = vsphere.get_network(name="network1",
|
|
623
|
+
datacenter_id=datacenter.id)
|
|
624
|
+
vm = vsphere.VirtualMachine("vm",
|
|
625
|
+
name="test",
|
|
626
|
+
resource_pool_id=cluster.resource_pool_id,
|
|
627
|
+
datastore_id=datastore.id,
|
|
628
|
+
num_cpus=2,
|
|
629
|
+
memory=2048,
|
|
630
|
+
guest_id="otherLinux64Guest",
|
|
631
|
+
network_interfaces=[{
|
|
632
|
+
"network_id": network.id,
|
|
633
|
+
}],
|
|
634
|
+
disks=[{
|
|
635
|
+
"label": "disk0",
|
|
636
|
+
"size": 20,
|
|
637
|
+
}])
|
|
638
|
+
ha_vm_override = vsphere.HaVmOverride("ha_vm_override",
|
|
639
|
+
compute_cluster_id=cluster.id,
|
|
640
|
+
virtual_machine_id=vm.id,
|
|
641
|
+
ha_vm_restart_priority="highest")
|
|
642
|
+
```
|
|
643
|
+
|
|
644
|
+
## Import
|
|
645
|
+
|
|
646
|
+
An existing override can be imported into this resource by
|
|
647
|
+
|
|
648
|
+
supplying both the path to the cluster, and the path to the virtual machine, to
|
|
649
|
+
|
|
650
|
+
`pulumi import`. If no override exists, an error will be given. An example
|
|
651
|
+
|
|
652
|
+
is below:
|
|
653
|
+
|
|
654
|
+
```sh
|
|
655
|
+
$ pulumi import vsphere:index/haVmOverride:HaVmOverride ha_vm_override \\
|
|
656
|
+
```
|
|
657
|
+
|
|
658
|
+
'{"compute_cluster_path": "/dc1/host/cluster1", \\
|
|
659
|
+
|
|
660
|
+
"virtual_machine_path": "/dc1/vm/srv1"}'
|
|
661
|
+
|
|
687
662
|
:param str resource_name: The name of the resource.
|
|
688
663
|
:param pulumi.ResourceOptions opts: Options for the resource.
|
|
689
|
-
:param pulumi.Input[str] compute_cluster_id: The managed object
|
|
690
|
-
|
|
691
|
-
|
|
692
|
-
:param pulumi.Input[str]
|
|
693
|
-
|
|
694
|
-
|
|
695
|
-
|
|
696
|
-
:param pulumi.Input[str]
|
|
697
|
-
|
|
698
|
-
|
|
699
|
-
|
|
700
|
-
:param pulumi.Input[int]
|
|
701
|
-
|
|
702
|
-
|
|
703
|
-
the
|
|
704
|
-
|
|
705
|
-
|
|
706
|
-
|
|
707
|
-
|
|
708
|
-
|
|
709
|
-
|
|
710
|
-
|
|
711
|
-
|
|
712
|
-
|
|
713
|
-
|
|
714
|
-
|
|
715
|
-
:param pulumi.Input[
|
|
716
|
-
which `ha_vm_maximum_resets` can operate. When this
|
|
717
|
-
window expires, no more resets are attempted regardless of the setting
|
|
718
|
-
configured in `ha_vm_maximum_resets`. `-1` means no window, meaning an
|
|
719
|
-
unlimited reset time is allotted. The value is specified in seconds. Default:
|
|
720
|
-
`-1` (no window).
|
|
721
|
-
:param pulumi.Input[int] ha_vm_maximum_resets: The maximum number of resets that HA will
|
|
722
|
-
perform to this virtual machine when responding to a failure event. Default:
|
|
723
|
-
`3`
|
|
724
|
-
:param pulumi.Input[int] ha_vm_minimum_uptime: The time, in seconds, that HA waits after
|
|
725
|
-
powering on this virtual machine before monitoring for heartbeats. Default:
|
|
726
|
-
`120` (2 minutes).
|
|
727
|
-
:param pulumi.Input[str] ha_vm_monitoring: The type of virtual machine monitoring to use
|
|
728
|
-
when HA is enabled in the cluster. Can be one of `vmMonitoringDisabled`,
|
|
729
|
-
`vmMonitoringOnly`, or `vmAndAppMonitoring`. Default: `vmMonitoringDisabled`.
|
|
730
|
-
:param pulumi.Input[bool] ha_vm_monitoring_use_cluster_defaults: Determines whether or
|
|
731
|
-
not the cluster's default settings or the VM override settings specified in
|
|
732
|
-
this resource are used for virtual machine monitoring. The default is `true`
|
|
733
|
-
(use cluster defaults) - set to `false` to have overrides take effect.
|
|
734
|
-
:param pulumi.Input[str] ha_vm_restart_priority: The restart priority for the virtual
|
|
735
|
-
machine when vSphere detects a host failure. Can be one of
|
|
736
|
-
`clusterRestartPriority`, `lowest`, `low`, `medium`, `high`, `highest`, or `disabled`.
|
|
737
|
-
Default: `clusterRestartPriority`.
|
|
738
|
-
:param pulumi.Input[int] ha_vm_restart_timeout: The maximum time, in seconds, that
|
|
739
|
-
vSphere HA will wait for this virtual machine to be ready. Use `-1` to
|
|
740
|
-
specify the cluster default. Default: `-1`.
|
|
741
|
-
:param pulumi.Input[str] virtual_machine_id: The UUID of the virtual machine to create
|
|
742
|
-
the override for. Forces a new resource if changed.
|
|
664
|
+
:param pulumi.Input[str] compute_cluster_id: The managed object ID of the cluster.
|
|
665
|
+
:param pulumi.Input[str] ha_datastore_apd_recovery_action: Controls the action to take on this virtual machine if an APD status on an affected datastore clears in the middle of an
|
|
666
|
+
APD event. Can be one of useClusterDefault, none or reset.
|
|
667
|
+
:param pulumi.Input[str] ha_datastore_apd_response: Controls the action to take on this virtual machine when the cluster has detected loss to all paths to a relevant
|
|
668
|
+
datastore. Can be one of clusterDefault, disabled, warning, restartConservative, or restartAggressive.
|
|
669
|
+
:param pulumi.Input[int] ha_datastore_apd_response_delay: Controls the delay in seconds to wait after an APD timeout event to execute the response action defined in
|
|
670
|
+
ha_datastore_apd_response. Specify -1 to use the cluster setting.
|
|
671
|
+
:param pulumi.Input[str] ha_datastore_pdl_response: Controls the action to take on this virtual machine when the cluster has detected a permanent device loss to a relevant
|
|
672
|
+
datastore. Can be one of clusterDefault, disabled, warning, or restartAggressive.
|
|
673
|
+
:param pulumi.Input[str] ha_host_isolation_response: The action to take on this virtual machine when a host is isolated from the rest of the cluster. Can be one of
|
|
674
|
+
clusterIsolationResponse, none, powerOff, or shutdown.
|
|
675
|
+
:param pulumi.Input[int] ha_vm_failure_interval: If a heartbeat from this virtual machine is not received within this configured interval, the virtual machine is marked
|
|
676
|
+
as failed. The value is in seconds.
|
|
677
|
+
:param pulumi.Input[int] ha_vm_maximum_failure_window: The length of the reset window in which ha_vm_maximum_resets can operate. When this window expires, no more resets are
|
|
678
|
+
attempted regardless of the setting configured in ha_vm_maximum_resets. -1 means no window, meaning an unlimited reset
|
|
679
|
+
time is allotted.
|
|
680
|
+
:param pulumi.Input[int] ha_vm_maximum_resets: The maximum number of resets that HA will perform to this virtual machine when responding to a failure event.
|
|
681
|
+
:param pulumi.Input[int] ha_vm_minimum_uptime: The time, in seconds, that HA waits after powering on this virtual machine before monitoring for heartbeats.
|
|
682
|
+
:param pulumi.Input[str] ha_vm_monitoring: The type of virtual machine monitoring to use for this virtual machine. Can be one of vmMonitoringDisabled,
|
|
683
|
+
vmMonitoringOnly, or vmAndAppMonitoring.
|
|
684
|
+
:param pulumi.Input[bool] ha_vm_monitoring_use_cluster_defaults: Determines whether or not the cluster's default settings or the VM override settings specified in this resource are used
|
|
685
|
+
for virtual machine monitoring. The default is true (use cluster defaults) - set to false to have overrides take effect.
|
|
686
|
+
:param pulumi.Input[str] ha_vm_restart_priority: The restart priority for this virtual machine when vSphere detects a host failure. Can be one of clusterRestartPriority,
|
|
687
|
+
lowest, low, medium, high, or highest.
|
|
688
|
+
:param pulumi.Input[int] ha_vm_restart_timeout: The maximum time, in seconds, that vSphere HA will wait for the virtual machine to be ready. Use -1 to use the cluster
|
|
689
|
+
default.
|
|
690
|
+
:param pulumi.Input[str] virtual_machine_id: The managed object ID of the virtual machine.
|
|
743
691
|
"""
|
|
744
692
|
...
|
|
745
693
|
@overload
|
|
@@ -748,7 +696,85 @@ class HaVmOverride(pulumi.CustomResource):
|
|
|
748
696
|
args: HaVmOverrideArgs,
|
|
749
697
|
opts: Optional[pulumi.ResourceOptions] = None):
|
|
750
698
|
"""
|
|
751
|
-
|
|
699
|
+
The `HaVmOverride` resource can be used to add an override for
|
|
700
|
+
vSphere HA settings on a cluster for a specific virtual machine. With this
|
|
701
|
+
resource, one can control specific HA settings so that they are different than
|
|
702
|
+
the cluster default, accommodating the needs of that specific virtual machine,
|
|
703
|
+
while not affecting the rest of the cluster.
|
|
704
|
+
|
|
705
|
+
For more information on vSphere HA, see [this page][ref-vsphere-ha-clusters].
|
|
706
|
+
|
|
707
|
+
[ref-vsphere-ha-clusters]: https://docs.vmware.com/en/VMware-vSphere/8.0/vsphere-availability/GUID-5432CA24-14F1-44E3-87FB-61D937831CF6.html
|
|
708
|
+
|
|
709
|
+
> **NOTE:** This resource requires vCenter and is not available on direct ESXi
|
|
710
|
+
connections.
|
|
711
|
+
|
|
712
|
+
## Example Usage
|
|
713
|
+
|
|
714
|
+
The example below creates a virtual machine in a cluster using the
|
|
715
|
+
`VirtualMachine` resource, creating the
|
|
716
|
+
virtual machine in the cluster looked up by the
|
|
717
|
+
`ComputeCluster` data source.
|
|
718
|
+
|
|
719
|
+
Considering a scenario where this virtual machine is of high value to the
|
|
720
|
+
application or organization for which it does its work, it's been determined in
|
|
721
|
+
the event of a host failure, that this should be one of the first virtual
|
|
722
|
+
machines to be started by vSphere HA during recovery. Hence, it
|
|
723
|
+
`ha_vm_restart_priority` has been set to `highest`,
|
|
724
|
+
which, assuming that the default restart priority is `medium` and no other
|
|
725
|
+
virtual machine has been assigned the `highest` priority, will mean that this
|
|
726
|
+
VM will be started before any other virtual machine in the event of host
|
|
727
|
+
failure.
|
|
728
|
+
|
|
729
|
+
```python
|
|
730
|
+
import pulumi
|
|
731
|
+
import pulumi_vsphere as vsphere
|
|
732
|
+
|
|
733
|
+
datacenter = vsphere.get_datacenter(name="dc-01")
|
|
734
|
+
datastore = vsphere.get_datastore(name="datastore1",
|
|
735
|
+
datacenter_id=datacenter.id)
|
|
736
|
+
cluster = vsphere.get_compute_cluster(name="cluster-01",
|
|
737
|
+
datacenter_id=datacenter.id)
|
|
738
|
+
network = vsphere.get_network(name="network1",
|
|
739
|
+
datacenter_id=datacenter.id)
|
|
740
|
+
vm = vsphere.VirtualMachine("vm",
|
|
741
|
+
name="test",
|
|
742
|
+
resource_pool_id=cluster.resource_pool_id,
|
|
743
|
+
datastore_id=datastore.id,
|
|
744
|
+
num_cpus=2,
|
|
745
|
+
memory=2048,
|
|
746
|
+
guest_id="otherLinux64Guest",
|
|
747
|
+
network_interfaces=[{
|
|
748
|
+
"network_id": network.id,
|
|
749
|
+
}],
|
|
750
|
+
disks=[{
|
|
751
|
+
"label": "disk0",
|
|
752
|
+
"size": 20,
|
|
753
|
+
}])
|
|
754
|
+
ha_vm_override = vsphere.HaVmOverride("ha_vm_override",
|
|
755
|
+
compute_cluster_id=cluster.id,
|
|
756
|
+
virtual_machine_id=vm.id,
|
|
757
|
+
ha_vm_restart_priority="highest")
|
|
758
|
+
```
|
|
759
|
+
|
|
760
|
+
## Import
|
|
761
|
+
|
|
762
|
+
An existing override can be imported into this resource by
|
|
763
|
+
|
|
764
|
+
supplying both the path to the cluster, and the path to the virtual machine, to
|
|
765
|
+
|
|
766
|
+
`pulumi import`. If no override exists, an error will be given. An example
|
|
767
|
+
|
|
768
|
+
is below:
|
|
769
|
+
|
|
770
|
+
```sh
|
|
771
|
+
$ pulumi import vsphere:index/haVmOverride:HaVmOverride ha_vm_override \\
|
|
772
|
+
```
|
|
773
|
+
|
|
774
|
+
'{"compute_cluster_path": "/dc1/host/cluster1", \\
|
|
775
|
+
|
|
776
|
+
"virtual_machine_path": "/dc1/vm/srv1"}'
|
|
777
|
+
|
|
752
778
|
:param str resource_name: The name of the resource.
|
|
753
779
|
:param HaVmOverrideArgs args: The arguments to use to populate this resource's properties.
|
|
754
780
|
:param pulumi.ResourceOptions opts: Options for the resource.
|
|
@@ -839,60 +865,33 @@ class HaVmOverride(pulumi.CustomResource):
|
|
|
839
865
|
:param str resource_name: The unique name of the resulting resource.
|
|
840
866
|
:param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
|
|
841
867
|
:param pulumi.ResourceOptions opts: Options for the resource.
|
|
842
|
-
:param pulumi.Input[str] compute_cluster_id: The managed object
|
|
843
|
-
|
|
844
|
-
|
|
845
|
-
:param pulumi.Input[str]
|
|
846
|
-
|
|
847
|
-
|
|
848
|
-
|
|
849
|
-
:param pulumi.Input[str]
|
|
850
|
-
|
|
851
|
-
|
|
852
|
-
|
|
853
|
-
:param pulumi.Input[int]
|
|
854
|
-
|
|
855
|
-
|
|
856
|
-
the
|
|
857
|
-
|
|
858
|
-
|
|
859
|
-
|
|
860
|
-
|
|
861
|
-
|
|
862
|
-
|
|
863
|
-
|
|
864
|
-
|
|
865
|
-
|
|
866
|
-
|
|
867
|
-
|
|
868
|
-
:param pulumi.Input[
|
|
869
|
-
which `ha_vm_maximum_resets` can operate. When this
|
|
870
|
-
window expires, no more resets are attempted regardless of the setting
|
|
871
|
-
configured in `ha_vm_maximum_resets`. `-1` means no window, meaning an
|
|
872
|
-
unlimited reset time is allotted. The value is specified in seconds. Default:
|
|
873
|
-
`-1` (no window).
|
|
874
|
-
:param pulumi.Input[int] ha_vm_maximum_resets: The maximum number of resets that HA will
|
|
875
|
-
perform to this virtual machine when responding to a failure event. Default:
|
|
876
|
-
`3`
|
|
877
|
-
:param pulumi.Input[int] ha_vm_minimum_uptime: The time, in seconds, that HA waits after
|
|
878
|
-
powering on this virtual machine before monitoring for heartbeats. Default:
|
|
879
|
-
`120` (2 minutes).
|
|
880
|
-
:param pulumi.Input[str] ha_vm_monitoring: The type of virtual machine monitoring to use
|
|
881
|
-
when HA is enabled in the cluster. Can be one of `vmMonitoringDisabled`,
|
|
882
|
-
`vmMonitoringOnly`, or `vmAndAppMonitoring`. Default: `vmMonitoringDisabled`.
|
|
883
|
-
:param pulumi.Input[bool] ha_vm_monitoring_use_cluster_defaults: Determines whether or
|
|
884
|
-
not the cluster's default settings or the VM override settings specified in
|
|
885
|
-
this resource are used for virtual machine monitoring. The default is `true`
|
|
886
|
-
(use cluster defaults) - set to `false` to have overrides take effect.
|
|
887
|
-
:param pulumi.Input[str] ha_vm_restart_priority: The restart priority for the virtual
|
|
888
|
-
machine when vSphere detects a host failure. Can be one of
|
|
889
|
-
`clusterRestartPriority`, `lowest`, `low`, `medium`, `high`, `highest`, or `disabled`.
|
|
890
|
-
Default: `clusterRestartPriority`.
|
|
891
|
-
:param pulumi.Input[int] ha_vm_restart_timeout: The maximum time, in seconds, that
|
|
892
|
-
vSphere HA will wait for this virtual machine to be ready. Use `-1` to
|
|
893
|
-
specify the cluster default. Default: `-1`.
|
|
894
|
-
:param pulumi.Input[str] virtual_machine_id: The UUID of the virtual machine to create
|
|
895
|
-
the override for. Forces a new resource if changed.
|
|
868
|
+
:param pulumi.Input[str] compute_cluster_id: The managed object ID of the cluster.
|
|
869
|
+
:param pulumi.Input[str] ha_datastore_apd_recovery_action: Controls the action to take on this virtual machine if an APD status on an affected datastore clears in the middle of an
|
|
870
|
+
APD event. Can be one of useClusterDefault, none or reset.
|
|
871
|
+
:param pulumi.Input[str] ha_datastore_apd_response: Controls the action to take on this virtual machine when the cluster has detected loss to all paths to a relevant
|
|
872
|
+
datastore. Can be one of clusterDefault, disabled, warning, restartConservative, or restartAggressive.
|
|
873
|
+
:param pulumi.Input[int] ha_datastore_apd_response_delay: Controls the delay in seconds to wait after an APD timeout event to execute the response action defined in
|
|
874
|
+
ha_datastore_apd_response. Specify -1 to use the cluster setting.
|
|
875
|
+
:param pulumi.Input[str] ha_datastore_pdl_response: Controls the action to take on this virtual machine when the cluster has detected a permanent device loss to a relevant
|
|
876
|
+
datastore. Can be one of clusterDefault, disabled, warning, or restartAggressive.
|
|
877
|
+
:param pulumi.Input[str] ha_host_isolation_response: The action to take on this virtual machine when a host is isolated from the rest of the cluster. Can be one of
|
|
878
|
+
clusterIsolationResponse, none, powerOff, or shutdown.
|
|
879
|
+
:param pulumi.Input[int] ha_vm_failure_interval: If a heartbeat from this virtual machine is not received within this configured interval, the virtual machine is marked
|
|
880
|
+
as failed. The value is in seconds.
|
|
881
|
+
:param pulumi.Input[int] ha_vm_maximum_failure_window: The length of the reset window in which ha_vm_maximum_resets can operate. When this window expires, no more resets are
|
|
882
|
+
attempted regardless of the setting configured in ha_vm_maximum_resets. -1 means no window, meaning an unlimited reset
|
|
883
|
+
time is allotted.
|
|
884
|
+
:param pulumi.Input[int] ha_vm_maximum_resets: The maximum number of resets that HA will perform to this virtual machine when responding to a failure event.
|
|
885
|
+
:param pulumi.Input[int] ha_vm_minimum_uptime: The time, in seconds, that HA waits after powering on this virtual machine before monitoring for heartbeats.
|
|
886
|
+
:param pulumi.Input[str] ha_vm_monitoring: The type of virtual machine monitoring to use for this virtual machine. Can be one of vmMonitoringDisabled,
|
|
887
|
+
vmMonitoringOnly, or vmAndAppMonitoring.
|
|
888
|
+
:param pulumi.Input[bool] ha_vm_monitoring_use_cluster_defaults: Determines whether or not the cluster's default settings or the VM override settings specified in this resource are used
|
|
889
|
+
for virtual machine monitoring. The default is true (use cluster defaults) - set to false to have overrides take effect.
|
|
890
|
+
:param pulumi.Input[str] ha_vm_restart_priority: The restart priority for this virtual machine when vSphere detects a host failure. Can be one of clusterRestartPriority,
|
|
891
|
+
lowest, low, medium, high, or highest.
|
|
892
|
+
:param pulumi.Input[int] ha_vm_restart_timeout: The maximum time, in seconds, that vSphere HA will wait for the virtual machine to be ready. Use -1 to use the cluster
|
|
893
|
+
default.
|
|
894
|
+
:param pulumi.Input[str] virtual_machine_id: The managed object ID of the virtual machine.
|
|
896
895
|
"""
|
|
897
896
|
opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
|
|
898
897
|
|
|
@@ -919,9 +918,7 @@ class HaVmOverride(pulumi.CustomResource):
|
|
|
919
918
|
@pulumi.getter(name="computeClusterId")
|
|
920
919
|
def compute_cluster_id(self) -> pulumi.Output[str]:
|
|
921
920
|
"""
|
|
922
|
-
The managed object
|
|
923
|
-
ID of the cluster to put the override in. Forces a new
|
|
924
|
-
resource if changed.
|
|
921
|
+
The managed object ID of the cluster.
|
|
925
922
|
"""
|
|
926
923
|
return pulumi.get(self, "compute_cluster_id")
|
|
927
924
|
|
|
@@ -929,10 +926,8 @@ class HaVmOverride(pulumi.CustomResource):
|
|
|
929
926
|
@pulumi.getter(name="haDatastoreApdRecoveryAction")
|
|
930
927
|
def ha_datastore_apd_recovery_action(self) -> pulumi.Output[Optional[str]]:
|
|
931
928
|
"""
|
|
932
|
-
Controls the action to take
|
|
933
|
-
|
|
934
|
-
the middle of an APD event. Can be one of `useClusterDefault`, `none` or
|
|
935
|
-
`reset`. Default: `useClusterDefault`.
|
|
929
|
+
Controls the action to take on this virtual machine if an APD status on an affected datastore clears in the middle of an
|
|
930
|
+
APD event. Can be one of useClusterDefault, none or reset.
|
|
936
931
|
"""
|
|
937
932
|
return pulumi.get(self, "ha_datastore_apd_recovery_action")
|
|
938
933
|
|
|
@@ -940,10 +935,8 @@ class HaVmOverride(pulumi.CustomResource):
|
|
|
940
935
|
@pulumi.getter(name="haDatastoreApdResponse")
|
|
941
936
|
def ha_datastore_apd_response(self) -> pulumi.Output[Optional[str]]:
|
|
942
937
|
"""
|
|
943
|
-
Controls the action to take on this
|
|
944
|
-
|
|
945
|
-
datastore. Can be one of `clusterDefault`, `disabled`, `warning`,
|
|
946
|
-
`restartConservative`, or `restartAggressive`. Default: `clusterDefault`.
|
|
938
|
+
Controls the action to take on this virtual machine when the cluster has detected loss to all paths to a relevant
|
|
939
|
+
datastore. Can be one of clusterDefault, disabled, warning, restartConservative, or restartAggressive.
|
|
947
940
|
"""
|
|
948
941
|
return pulumi.get(self, "ha_datastore_apd_response")
|
|
949
942
|
|
|
@@ -951,10 +944,8 @@ class HaVmOverride(pulumi.CustomResource):
|
|
|
951
944
|
@pulumi.getter(name="haDatastoreApdResponseDelay")
|
|
952
945
|
def ha_datastore_apd_response_delay(self) -> pulumi.Output[Optional[int]]:
|
|
953
946
|
"""
|
|
954
|
-
Controls the delay in seconds
|
|
955
|
-
|
|
956
|
-
`ha_datastore_apd_response`. Use `-1` to use
|
|
957
|
-
the cluster default. Default: `-1`.
|
|
947
|
+
Controls the delay in seconds to wait after an APD timeout event to execute the response action defined in
|
|
948
|
+
ha_datastore_apd_response. Specify -1 to use the cluster setting.
|
|
958
949
|
"""
|
|
959
950
|
return pulumi.get(self, "ha_datastore_apd_response_delay")
|
|
960
951
|
|
|
@@ -962,10 +953,8 @@ class HaVmOverride(pulumi.CustomResource):
|
|
|
962
953
|
@pulumi.getter(name="haDatastorePdlResponse")
|
|
963
954
|
def ha_datastore_pdl_response(self) -> pulumi.Output[Optional[str]]:
|
|
964
955
|
"""
|
|
965
|
-
Controls the action to take on this
|
|
966
|
-
|
|
967
|
-
relevant datastore. Can be one of `clusterDefault`, `disabled`, `warning`, or
|
|
968
|
-
`restartAggressive`. Default: `clusterDefault`.
|
|
956
|
+
Controls the action to take on this virtual machine when the cluster has detected a permanent device loss to a relevant
|
|
957
|
+
datastore. Can be one of clusterDefault, disabled, warning, or restartAggressive.
|
|
969
958
|
"""
|
|
970
959
|
return pulumi.get(self, "ha_datastore_pdl_response")
|
|
971
960
|
|
|
@@ -973,10 +962,8 @@ class HaVmOverride(pulumi.CustomResource):
|
|
|
973
962
|
@pulumi.getter(name="haHostIsolationResponse")
|
|
974
963
|
def ha_host_isolation_response(self) -> pulumi.Output[Optional[str]]:
|
|
975
964
|
"""
|
|
976
|
-
The action to take on this virtual
|
|
977
|
-
|
|
978
|
-
the cluster. Can be one of `clusterIsolationResponse`, `none`, `powerOff`, or
|
|
979
|
-
`shutdown`. Default: `clusterIsolationResponse`.
|
|
965
|
+
The action to take on this virtual machine when a host is isolated from the rest of the cluster. Can be one of
|
|
966
|
+
clusterIsolationResponse, none, powerOff, or shutdown.
|
|
980
967
|
"""
|
|
981
968
|
return pulumi.get(self, "ha_host_isolation_response")
|
|
982
969
|
|
|
@@ -984,9 +971,8 @@ class HaVmOverride(pulumi.CustomResource):
|
|
|
984
971
|
@pulumi.getter(name="haVmFailureInterval")
|
|
985
972
|
def ha_vm_failure_interval(self) -> pulumi.Output[Optional[int]]:
|
|
986
973
|
"""
|
|
987
|
-
If a heartbeat from this virtual
|
|
988
|
-
|
|
989
|
-
is marked as failed. The value is in seconds. Default: `30`.
|
|
974
|
+
If a heartbeat from this virtual machine is not received within this configured interval, the virtual machine is marked
|
|
975
|
+
as failed. The value is in seconds.
|
|
990
976
|
"""
|
|
991
977
|
return pulumi.get(self, "ha_vm_failure_interval")
|
|
992
978
|
|
|
@@ -994,12 +980,9 @@ class HaVmOverride(pulumi.CustomResource):
|
|
|
994
980
|
@pulumi.getter(name="haVmMaximumFailureWindow")
|
|
995
981
|
def ha_vm_maximum_failure_window(self) -> pulumi.Output[Optional[int]]:
|
|
996
982
|
"""
|
|
997
|
-
The length of the reset window in
|
|
998
|
-
|
|
999
|
-
|
|
1000
|
-
configured in `ha_vm_maximum_resets`. `-1` means no window, meaning an
|
|
1001
|
-
unlimited reset time is allotted. The value is specified in seconds. Default:
|
|
1002
|
-
`-1` (no window).
|
|
983
|
+
The length of the reset window in which ha_vm_maximum_resets can operate. When this window expires, no more resets are
|
|
984
|
+
attempted regardless of the setting configured in ha_vm_maximum_resets. -1 means no window, meaning an unlimited reset
|
|
985
|
+
time is allotted.
|
|
1003
986
|
"""
|
|
1004
987
|
return pulumi.get(self, "ha_vm_maximum_failure_window")
|
|
1005
988
|
|
|
@@ -1007,9 +990,7 @@ class HaVmOverride(pulumi.CustomResource):
|
|
|
1007
990
|
@pulumi.getter(name="haVmMaximumResets")
|
|
1008
991
|
def ha_vm_maximum_resets(self) -> pulumi.Output[Optional[int]]:
|
|
1009
992
|
"""
|
|
1010
|
-
The maximum number of resets that HA will
|
|
1011
|
-
perform to this virtual machine when responding to a failure event. Default:
|
|
1012
|
-
`3`
|
|
993
|
+
The maximum number of resets that HA will perform to this virtual machine when responding to a failure event.
|
|
1013
994
|
"""
|
|
1014
995
|
return pulumi.get(self, "ha_vm_maximum_resets")
|
|
1015
996
|
|
|
@@ -1017,9 +998,7 @@ class HaVmOverride(pulumi.CustomResource):
|
|
|
1017
998
|
@pulumi.getter(name="haVmMinimumUptime")
|
|
1018
999
|
def ha_vm_minimum_uptime(self) -> pulumi.Output[Optional[int]]:
|
|
1019
1000
|
"""
|
|
1020
|
-
The time, in seconds, that HA waits after
|
|
1021
|
-
powering on this virtual machine before monitoring for heartbeats. Default:
|
|
1022
|
-
`120` (2 minutes).
|
|
1001
|
+
The time, in seconds, that HA waits after powering on this virtual machine before monitoring for heartbeats.
|
|
1023
1002
|
"""
|
|
1024
1003
|
return pulumi.get(self, "ha_vm_minimum_uptime")
|
|
1025
1004
|
|
|
@@ -1027,9 +1006,8 @@ class HaVmOverride(pulumi.CustomResource):
|
|
|
1027
1006
|
@pulumi.getter(name="haVmMonitoring")
|
|
1028
1007
|
def ha_vm_monitoring(self) -> pulumi.Output[Optional[str]]:
|
|
1029
1008
|
"""
|
|
1030
|
-
The type of virtual machine monitoring to use
|
|
1031
|
-
|
|
1032
|
-
`vmMonitoringOnly`, or `vmAndAppMonitoring`. Default: `vmMonitoringDisabled`.
|
|
1009
|
+
The type of virtual machine monitoring to use for this virtual machine. Can be one of vmMonitoringDisabled,
|
|
1010
|
+
vmMonitoringOnly, or vmAndAppMonitoring.
|
|
1033
1011
|
"""
|
|
1034
1012
|
return pulumi.get(self, "ha_vm_monitoring")
|
|
1035
1013
|
|
|
@@ -1037,10 +1015,8 @@ class HaVmOverride(pulumi.CustomResource):
|
|
|
1037
1015
|
@pulumi.getter(name="haVmMonitoringUseClusterDefaults")
|
|
1038
1016
|
def ha_vm_monitoring_use_cluster_defaults(self) -> pulumi.Output[Optional[bool]]:
|
|
1039
1017
|
"""
|
|
1040
|
-
Determines whether or
|
|
1041
|
-
|
|
1042
|
-
this resource are used for virtual machine monitoring. The default is `true`
|
|
1043
|
-
(use cluster defaults) - set to `false` to have overrides take effect.
|
|
1018
|
+
Determines whether or not the cluster's default settings or the VM override settings specified in this resource are used
|
|
1019
|
+
for virtual machine monitoring. The default is true (use cluster defaults) - set to false to have overrides take effect.
|
|
1044
1020
|
"""
|
|
1045
1021
|
return pulumi.get(self, "ha_vm_monitoring_use_cluster_defaults")
|
|
1046
1022
|
|
|
@@ -1048,10 +1024,8 @@ class HaVmOverride(pulumi.CustomResource):
|
|
|
1048
1024
|
@pulumi.getter(name="haVmRestartPriority")
|
|
1049
1025
|
def ha_vm_restart_priority(self) -> pulumi.Output[Optional[str]]:
|
|
1050
1026
|
"""
|
|
1051
|
-
The restart priority for
|
|
1052
|
-
|
|
1053
|
-
`clusterRestartPriority`, `lowest`, `low`, `medium`, `high`, `highest`, or `disabled`.
|
|
1054
|
-
Default: `clusterRestartPriority`.
|
|
1027
|
+
The restart priority for this virtual machine when vSphere detects a host failure. Can be one of clusterRestartPriority,
|
|
1028
|
+
lowest, low, medium, high, or highest.
|
|
1055
1029
|
"""
|
|
1056
1030
|
return pulumi.get(self, "ha_vm_restart_priority")
|
|
1057
1031
|
|
|
@@ -1059,9 +1033,8 @@ class HaVmOverride(pulumi.CustomResource):
|
|
|
1059
1033
|
@pulumi.getter(name="haVmRestartTimeout")
|
|
1060
1034
|
def ha_vm_restart_timeout(self) -> pulumi.Output[Optional[int]]:
|
|
1061
1035
|
"""
|
|
1062
|
-
The maximum time, in seconds, that
|
|
1063
|
-
|
|
1064
|
-
specify the cluster default. Default: `-1`.
|
|
1036
|
+
The maximum time, in seconds, that vSphere HA will wait for the virtual machine to be ready. Use -1 to use the cluster
|
|
1037
|
+
default.
|
|
1065
1038
|
"""
|
|
1066
1039
|
return pulumi.get(self, "ha_vm_restart_timeout")
|
|
1067
1040
|
|
|
@@ -1069,8 +1042,7 @@ class HaVmOverride(pulumi.CustomResource):
|
|
|
1069
1042
|
@pulumi.getter(name="virtualMachineId")
|
|
1070
1043
|
def virtual_machine_id(self) -> pulumi.Output[str]:
|
|
1071
1044
|
"""
|
|
1072
|
-
The
|
|
1073
|
-
the override for. Forces a new resource if changed.
|
|
1045
|
+
The managed object ID of the virtual machine.
|
|
1074
1046
|
"""
|
|
1075
1047
|
return pulumi.get(self, "virtual_machine_id")
|
|
1076
1048
|
|