pulumi-vsphere 4.11.0a1__py3-none-any.whl → 4.11.0a1711033215__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.

Files changed (58) hide show
  1. pulumi_vsphere/__init__.py +0 -28
  2. pulumi_vsphere/_inputs.py +230 -554
  3. pulumi_vsphere/compute_cluster.py +1477 -747
  4. pulumi_vsphere/compute_cluster_vm_affinity_rule.py +16 -28
  5. pulumi_vsphere/datacenter.py +12 -26
  6. pulumi_vsphere/datastore_cluster.py +350 -154
  7. pulumi_vsphere/distributed_port_group.py +175 -70
  8. pulumi_vsphere/distributed_virtual_switch.py +805 -308
  9. pulumi_vsphere/file.py +24 -16
  10. pulumi_vsphere/folder.py +7 -7
  11. pulumi_vsphere/get_compute_cluster.py +4 -0
  12. pulumi_vsphere/get_compute_cluster_host_group.py +10 -8
  13. pulumi_vsphere/get_content_library.py +4 -0
  14. pulumi_vsphere/get_custom_attribute.py +4 -0
  15. pulumi_vsphere/get_datacenter.py +4 -0
  16. pulumi_vsphere/get_datastore.py +4 -0
  17. pulumi_vsphere/get_datastore_cluster.py +4 -0
  18. pulumi_vsphere/get_datastore_stats.py +12 -4
  19. pulumi_vsphere/get_distributed_virtual_switch.py +4 -2
  20. pulumi_vsphere/get_dynamic.py +8 -4
  21. pulumi_vsphere/get_folder.py +6 -10
  22. pulumi_vsphere/get_guest_os_customization.py +4 -0
  23. pulumi_vsphere/get_host.py +4 -0
  24. pulumi_vsphere/get_host_pci_device.py +12 -4
  25. pulumi_vsphere/get_host_thumbprint.py +4 -0
  26. pulumi_vsphere/get_host_vgpu_profile.py +8 -0
  27. pulumi_vsphere/get_license.py +4 -0
  28. pulumi_vsphere/get_network.py +4 -0
  29. pulumi_vsphere/get_policy.py +4 -0
  30. pulumi_vsphere/get_resource_pool.py +10 -2
  31. pulumi_vsphere/get_role.py +4 -0
  32. pulumi_vsphere/get_tag.py +4 -0
  33. pulumi_vsphere/get_tag_category.py +4 -0
  34. pulumi_vsphere/get_vapp_container.py +4 -0
  35. pulumi_vsphere/get_virtual_machine.py +8 -0
  36. pulumi_vsphere/get_vmfs_disks.py +4 -0
  37. pulumi_vsphere/guest_os_customization.py +0 -50
  38. pulumi_vsphere/ha_vm_override.py +378 -189
  39. pulumi_vsphere/host.py +20 -0
  40. pulumi_vsphere/host_port_group.py +24 -12
  41. pulumi_vsphere/host_virtual_switch.py +287 -140
  42. pulumi_vsphere/license.py +32 -0
  43. pulumi_vsphere/outputs.py +230 -543
  44. pulumi_vsphere/pulumi-plugin.json +1 -2
  45. pulumi_vsphere/resource_pool.py +22 -48
  46. pulumi_vsphere/virtual_machine.py +807 -578
  47. pulumi_vsphere/virtual_machine_snapshot.py +10 -6
  48. pulumi_vsphere/vm_storage_policy.py +84 -72
  49. pulumi_vsphere/vnic.py +20 -8
  50. {pulumi_vsphere-4.11.0a1.dist-info → pulumi_vsphere-4.11.0a1711033215.dist-info}/METADATA +1 -1
  51. pulumi_vsphere-4.11.0a1711033215.dist-info/RECORD +82 -0
  52. pulumi_vsphere/get_host_base_images.py +0 -97
  53. pulumi_vsphere/offline_software_depot.py +0 -180
  54. pulumi_vsphere/supervisor.py +0 -858
  55. pulumi_vsphere/virtual_machine_class.py +0 -440
  56. pulumi_vsphere-4.11.0a1.dist-info/RECORD +0 -86
  57. {pulumi_vsphere-4.11.0a1.dist-info → pulumi_vsphere-4.11.0a1711033215.dist-info}/WHEEL +0 -0
  58. {pulumi_vsphere-4.11.0a1.dist-info → pulumi_vsphere-4.11.0a1711033215.dist-info}/top_level.txt +0 -0
@@ -61,32 +61,60 @@ class DatastoreClusterArgs:
61
61
  `/dc1/datastore/foo/bar`, with the final inventory path being
62
62
  `/dc1/datastore/foo/bar/datastore-cluster-test`.
63
63
  :param pulumi.Input[str] name: The name of the datastore cluster.
64
- :param pulumi.Input[Mapping[str, pulumi.Input[str]]] sdrs_advanced_options: Advanced configuration options for storage DRS.
65
- :param pulumi.Input[str] sdrs_automation_level: The default automation level for all virtual machines in this storage cluster.
66
- :param pulumi.Input[bool] sdrs_default_intra_vm_affinity: When true, storage DRS keeps VMDKs for individual VMs on the same datastore by default.
64
+ :param pulumi.Input[Mapping[str, pulumi.Input[str]]] sdrs_advanced_options: A key/value map of advanced Storage DRS
65
+ settings that are not exposed via the provider or the vSphere client.
66
+ :param pulumi.Input[str] sdrs_automation_level: The global automation level for all
67
+ virtual machines in this datastore cluster. Default: `manual`.
68
+ :param pulumi.Input[bool] sdrs_default_intra_vm_affinity: When `true`, all disks in a
69
+ single virtual machine will be kept on the same datastore. Default: `true`.
67
70
  :param pulumi.Input[bool] sdrs_enabled: Enable Storage DRS for this datastore cluster.
68
71
  Default: `false`.
69
- :param pulumi.Input[int] sdrs_free_space_threshold: The threshold, in GB, that storage DRS uses to make decisions to migrate VMs out of a datastore.
72
+ :param pulumi.Input[int] sdrs_free_space_threshold: The free space threshold to use.
73
+ When set to `utilization`, `drs_space_utilization_threshold` is used, and
74
+ when set to `freeSpace`, `drs_free_space_threshold` is used. Default:
75
+ `utilization`.
70
76
  :param pulumi.Input[str] sdrs_free_space_threshold_mode: The free space threshold to use. When set to utilization, drs_space_utilization_threshold is used, and when set to
71
77
  freeSpace, drs_free_space_threshold is used.
72
- :param pulumi.Input[int] sdrs_free_space_utilization_difference: The threshold, in percent, of difference between space utilization in datastores before storage DRS makes decisions to
73
- balance the space.
74
- :param pulumi.Input[str] sdrs_io_balance_automation_level: Overrides the default automation settings when correcting I/O load imbalances.
75
- :param pulumi.Input[int] sdrs_io_latency_threshold: The I/O latency threshold, in milliseconds, that storage DRS uses to make recommendations to move disks from this
76
- datastore.
77
- :param pulumi.Input[bool] sdrs_io_load_balance_enabled: Enable I/O load balancing for this datastore cluster.
78
- :param pulumi.Input[int] sdrs_io_load_imbalance_threshold: The difference between load in datastores in the cluster before storage DRS makes recommendations to balance the load.
79
- :param pulumi.Input[int] sdrs_io_reservable_iops_threshold: The threshold of reservable IOPS of all virtual machines on the datastore before storage DRS makes recommendations to
80
- move VMs off of a datastore.
81
- :param pulumi.Input[int] sdrs_io_reservable_percent_threshold: The threshold, in percent, of actual estimated performance of the datastore (in IOPS) that storage DRS uses to make
82
- recommendations to move VMs off of a datastore when the total reservable IOPS exceeds the threshold.
83
- :param pulumi.Input[str] sdrs_io_reservable_threshold_mode: The reservable IOPS threshold to use, percent in the event of automatic, or manual threshold in the event of manual.
84
- :param pulumi.Input[int] sdrs_load_balance_interval: The storage DRS poll interval, in minutes.
85
- :param pulumi.Input[str] sdrs_policy_enforcement_automation_level: Overrides the default automation settings when correcting storage and VM policy violations.
86
- :param pulumi.Input[str] sdrs_rule_enforcement_automation_level: Overrides the default automation settings when correcting affinity rule violations.
87
- :param pulumi.Input[str] sdrs_space_balance_automation_level: Overrides the default automation settings when correcting disk space imbalances.
88
- :param pulumi.Input[int] sdrs_space_utilization_threshold: The threshold, in percent of used space, that storage DRS uses to make decisions to migrate VMs out of a datastore.
89
- :param pulumi.Input[str] sdrs_vm_evacuation_automation_level: Overrides the default automation settings when generating recommendations for datastore evacuation.
78
+ :param pulumi.Input[int] sdrs_free_space_utilization_difference: The threshold, in
79
+ percent, of difference between space utilization in datastores before storage
80
+ DRS makes decisions to balance the space. Default: `5` percent.
81
+ :param pulumi.Input[str] sdrs_io_balance_automation_level: Overrides the default
82
+ automation settings when correcting I/O load imbalances.
83
+ :param pulumi.Input[int] sdrs_io_latency_threshold: The I/O latency threshold, in
84
+ milliseconds, that storage DRS uses to make recommendations to move disks
85
+ from this datastore. Default: `15` seconds.
86
+ :param pulumi.Input[bool] sdrs_io_load_balance_enabled: Enable I/O load balancing for
87
+ this datastore cluster. Default: `true`.
88
+ :param pulumi.Input[int] sdrs_io_load_imbalance_threshold: The difference between load
89
+ in datastores in the cluster before storage DRS makes recommendations to
90
+ balance the load. Default: `5` percent.
91
+ :param pulumi.Input[int] sdrs_io_reservable_iops_threshold: The threshold of reservable
92
+ IOPS of all virtual machines on the datastore before storage DRS makes
93
+ recommendations to move VMs off of a datastore. Note that this setting should
94
+ only be set if `sdrs_io_reservable_percent_threshold` cannot make an accurate
95
+ estimate of the capacity of the datastores in your cluster, and should be set
96
+ to roughly 50-60%!o(MISSING)f the worst case peak performance of the backing LUNs.
97
+ :param pulumi.Input[int] sdrs_io_reservable_percent_threshold: The threshold, in
98
+ percent, of actual estimated performance of the datastore (in IOPS) that
99
+ storage DRS uses to make recommendations to move VMs off of a datastore when
100
+ the total reservable IOPS exceeds the threshold. Default: `60` percent.
101
+ :param pulumi.Input[str] sdrs_io_reservable_threshold_mode: The reservable IOPS
102
+ threshold setting to use, `sdrs_io_reservable_percent_threshold` in the event
103
+ of `automatic`, or `sdrs_io_reservable_iops_threshold` in the event of
104
+ `manual`. Default: `automatic`.
105
+ :param pulumi.Input[int] sdrs_load_balance_interval: The storage DRS poll interval, in
106
+ minutes. Default: `480` minutes.
107
+ :param pulumi.Input[str] sdrs_policy_enforcement_automation_level: Overrides the default
108
+ automation settings when correcting storage and VM policy violations.
109
+ :param pulumi.Input[str] sdrs_rule_enforcement_automation_level: Overrides the default
110
+ automation settings when correcting affinity rule violations.
111
+ :param pulumi.Input[str] sdrs_space_balance_automation_level: Overrides the default
112
+ automation settings when correcting disk space imbalances.
113
+ :param pulumi.Input[int] sdrs_space_utilization_threshold: Runtime thresholds govern
114
+ when Storage DRS performs or recommends migrations
115
+ (based on the selected automation level). Default: `80` percent.
116
+ :param pulumi.Input[str] sdrs_vm_evacuation_automation_level: Overrides the default
117
+ automation settings when generating recommendations for datastore evacuation.
90
118
  :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource.
91
119
 
92
120
  > **NOTE:** Tagging support requires vCenter 6.0 or higher.
@@ -209,7 +237,8 @@ class DatastoreClusterArgs:
209
237
  @pulumi.getter(name="sdrsAdvancedOptions")
210
238
  def sdrs_advanced_options(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
211
239
  """
212
- Advanced configuration options for storage DRS.
240
+ A key/value map of advanced Storage DRS
241
+ settings that are not exposed via the provider or the vSphere client.
213
242
  """
214
243
  return pulumi.get(self, "sdrs_advanced_options")
215
244
 
@@ -221,7 +250,8 @@ class DatastoreClusterArgs:
221
250
  @pulumi.getter(name="sdrsAutomationLevel")
222
251
  def sdrs_automation_level(self) -> Optional[pulumi.Input[str]]:
223
252
  """
224
- The default automation level for all virtual machines in this storage cluster.
253
+ The global automation level for all
254
+ virtual machines in this datastore cluster. Default: `manual`.
225
255
  """
226
256
  return pulumi.get(self, "sdrs_automation_level")
227
257
 
@@ -233,7 +263,8 @@ class DatastoreClusterArgs:
233
263
  @pulumi.getter(name="sdrsDefaultIntraVmAffinity")
234
264
  def sdrs_default_intra_vm_affinity(self) -> Optional[pulumi.Input[bool]]:
235
265
  """
236
- When true, storage DRS keeps VMDKs for individual VMs on the same datastore by default.
266
+ When `true`, all disks in a
267
+ single virtual machine will be kept on the same datastore. Default: `true`.
237
268
  """
238
269
  return pulumi.get(self, "sdrs_default_intra_vm_affinity")
239
270
 
@@ -258,7 +289,10 @@ class DatastoreClusterArgs:
258
289
  @pulumi.getter(name="sdrsFreeSpaceThreshold")
259
290
  def sdrs_free_space_threshold(self) -> Optional[pulumi.Input[int]]:
260
291
  """
261
- The threshold, in GB, that storage DRS uses to make decisions to migrate VMs out of a datastore.
292
+ The free space threshold to use.
293
+ When set to `utilization`, `drs_space_utilization_threshold` is used, and
294
+ when set to `freeSpace`, `drs_free_space_threshold` is used. Default:
295
+ `utilization`.
262
296
  """
263
297
  return pulumi.get(self, "sdrs_free_space_threshold")
264
298
 
@@ -283,8 +317,9 @@ class DatastoreClusterArgs:
283
317
  @pulumi.getter(name="sdrsFreeSpaceUtilizationDifference")
284
318
  def sdrs_free_space_utilization_difference(self) -> Optional[pulumi.Input[int]]:
285
319
  """
286
- The threshold, in percent, of difference between space utilization in datastores before storage DRS makes decisions to
287
- balance the space.
320
+ The threshold, in
321
+ percent, of difference between space utilization in datastores before storage
322
+ DRS makes decisions to balance the space. Default: `5` percent.
288
323
  """
289
324
  return pulumi.get(self, "sdrs_free_space_utilization_difference")
290
325
 
@@ -296,7 +331,8 @@ class DatastoreClusterArgs:
296
331
  @pulumi.getter(name="sdrsIoBalanceAutomationLevel")
297
332
  def sdrs_io_balance_automation_level(self) -> Optional[pulumi.Input[str]]:
298
333
  """
299
- Overrides the default automation settings when correcting I/O load imbalances.
334
+ Overrides the default
335
+ automation settings when correcting I/O load imbalances.
300
336
  """
301
337
  return pulumi.get(self, "sdrs_io_balance_automation_level")
302
338
 
@@ -308,8 +344,9 @@ class DatastoreClusterArgs:
308
344
  @pulumi.getter(name="sdrsIoLatencyThreshold")
309
345
  def sdrs_io_latency_threshold(self) -> Optional[pulumi.Input[int]]:
310
346
  """
311
- The I/O latency threshold, in milliseconds, that storage DRS uses to make recommendations to move disks from this
312
- datastore.
347
+ The I/O latency threshold, in
348
+ milliseconds, that storage DRS uses to make recommendations to move disks
349
+ from this datastore. Default: `15` seconds.
313
350
  """
314
351
  return pulumi.get(self, "sdrs_io_latency_threshold")
315
352
 
@@ -321,7 +358,8 @@ class DatastoreClusterArgs:
321
358
  @pulumi.getter(name="sdrsIoLoadBalanceEnabled")
322
359
  def sdrs_io_load_balance_enabled(self) -> Optional[pulumi.Input[bool]]:
323
360
  """
324
- Enable I/O load balancing for this datastore cluster.
361
+ Enable I/O load balancing for
362
+ this datastore cluster. Default: `true`.
325
363
  """
326
364
  return pulumi.get(self, "sdrs_io_load_balance_enabled")
327
365
 
@@ -333,7 +371,9 @@ class DatastoreClusterArgs:
333
371
  @pulumi.getter(name="sdrsIoLoadImbalanceThreshold")
334
372
  def sdrs_io_load_imbalance_threshold(self) -> Optional[pulumi.Input[int]]:
335
373
  """
336
- The difference between load in datastores in the cluster before storage DRS makes recommendations to balance the load.
374
+ The difference between load
375
+ in datastores in the cluster before storage DRS makes recommendations to
376
+ balance the load. Default: `5` percent.
337
377
  """
338
378
  return pulumi.get(self, "sdrs_io_load_imbalance_threshold")
339
379
 
@@ -345,8 +385,12 @@ class DatastoreClusterArgs:
345
385
  @pulumi.getter(name="sdrsIoReservableIopsThreshold")
346
386
  def sdrs_io_reservable_iops_threshold(self) -> Optional[pulumi.Input[int]]:
347
387
  """
348
- The threshold of reservable IOPS of all virtual machines on the datastore before storage DRS makes recommendations to
349
- move VMs off of a datastore.
388
+ The threshold of reservable
389
+ IOPS of all virtual machines on the datastore before storage DRS makes
390
+ recommendations to move VMs off of a datastore. Note that this setting should
391
+ only be set if `sdrs_io_reservable_percent_threshold` cannot make an accurate
392
+ estimate of the capacity of the datastores in your cluster, and should be set
393
+ to roughly 50-60%!o(MISSING)f the worst case peak performance of the backing LUNs.
350
394
  """
351
395
  return pulumi.get(self, "sdrs_io_reservable_iops_threshold")
352
396
 
@@ -358,8 +402,10 @@ class DatastoreClusterArgs:
358
402
  @pulumi.getter(name="sdrsIoReservablePercentThreshold")
359
403
  def sdrs_io_reservable_percent_threshold(self) -> Optional[pulumi.Input[int]]:
360
404
  """
361
- The threshold, in percent, of actual estimated performance of the datastore (in IOPS) that storage DRS uses to make
362
- recommendations to move VMs off of a datastore when the total reservable IOPS exceeds the threshold.
405
+ The threshold, in
406
+ percent, of actual estimated performance of the datastore (in IOPS) that
407
+ storage DRS uses to make recommendations to move VMs off of a datastore when
408
+ the total reservable IOPS exceeds the threshold. Default: `60` percent.
363
409
  """
364
410
  return pulumi.get(self, "sdrs_io_reservable_percent_threshold")
365
411
 
@@ -371,7 +417,10 @@ class DatastoreClusterArgs:
371
417
  @pulumi.getter(name="sdrsIoReservableThresholdMode")
372
418
  def sdrs_io_reservable_threshold_mode(self) -> Optional[pulumi.Input[str]]:
373
419
  """
374
- The reservable IOPS threshold to use, percent in the event of automatic, or manual threshold in the event of manual.
420
+ The reservable IOPS
421
+ threshold setting to use, `sdrs_io_reservable_percent_threshold` in the event
422
+ of `automatic`, or `sdrs_io_reservable_iops_threshold` in the event of
423
+ `manual`. Default: `automatic`.
375
424
  """
376
425
  return pulumi.get(self, "sdrs_io_reservable_threshold_mode")
377
426
 
@@ -383,7 +432,8 @@ class DatastoreClusterArgs:
383
432
  @pulumi.getter(name="sdrsLoadBalanceInterval")
384
433
  def sdrs_load_balance_interval(self) -> Optional[pulumi.Input[int]]:
385
434
  """
386
- The storage DRS poll interval, in minutes.
435
+ The storage DRS poll interval, in
436
+ minutes. Default: `480` minutes.
387
437
  """
388
438
  return pulumi.get(self, "sdrs_load_balance_interval")
389
439
 
@@ -395,7 +445,8 @@ class DatastoreClusterArgs:
395
445
  @pulumi.getter(name="sdrsPolicyEnforcementAutomationLevel")
396
446
  def sdrs_policy_enforcement_automation_level(self) -> Optional[pulumi.Input[str]]:
397
447
  """
398
- Overrides the default automation settings when correcting storage and VM policy violations.
448
+ Overrides the default
449
+ automation settings when correcting storage and VM policy violations.
399
450
  """
400
451
  return pulumi.get(self, "sdrs_policy_enforcement_automation_level")
401
452
 
@@ -407,7 +458,8 @@ class DatastoreClusterArgs:
407
458
  @pulumi.getter(name="sdrsRuleEnforcementAutomationLevel")
408
459
  def sdrs_rule_enforcement_automation_level(self) -> Optional[pulumi.Input[str]]:
409
460
  """
410
- Overrides the default automation settings when correcting affinity rule violations.
461
+ Overrides the default
462
+ automation settings when correcting affinity rule violations.
411
463
  """
412
464
  return pulumi.get(self, "sdrs_rule_enforcement_automation_level")
413
465
 
@@ -419,7 +471,8 @@ class DatastoreClusterArgs:
419
471
  @pulumi.getter(name="sdrsSpaceBalanceAutomationLevel")
420
472
  def sdrs_space_balance_automation_level(self) -> Optional[pulumi.Input[str]]:
421
473
  """
422
- Overrides the default automation settings when correcting disk space imbalances.
474
+ Overrides the default
475
+ automation settings when correcting disk space imbalances.
423
476
  """
424
477
  return pulumi.get(self, "sdrs_space_balance_automation_level")
425
478
 
@@ -431,7 +484,9 @@ class DatastoreClusterArgs:
431
484
  @pulumi.getter(name="sdrsSpaceUtilizationThreshold")
432
485
  def sdrs_space_utilization_threshold(self) -> Optional[pulumi.Input[int]]:
433
486
  """
434
- The threshold, in percent of used space, that storage DRS uses to make decisions to migrate VMs out of a datastore.
487
+ Runtime thresholds govern
488
+ when Storage DRS performs or recommends migrations
489
+ (based on the selected automation level). Default: `80` percent.
435
490
  """
436
491
  return pulumi.get(self, "sdrs_space_utilization_threshold")
437
492
 
@@ -443,7 +498,8 @@ class DatastoreClusterArgs:
443
498
  @pulumi.getter(name="sdrsVmEvacuationAutomationLevel")
444
499
  def sdrs_vm_evacuation_automation_level(self) -> Optional[pulumi.Input[str]]:
445
500
  """
446
- Overrides the default automation settings when generating recommendations for datastore evacuation.
501
+ Overrides the default
502
+ automation settings when generating recommendations for datastore evacuation.
447
503
  """
448
504
  return pulumi.get(self, "sdrs_vm_evacuation_automation_level")
449
505
 
@@ -516,32 +572,60 @@ class _DatastoreClusterState:
516
572
  `/dc1/datastore/foo/bar`, with the final inventory path being
517
573
  `/dc1/datastore/foo/bar/datastore-cluster-test`.
518
574
  :param pulumi.Input[str] name: The name of the datastore cluster.
519
- :param pulumi.Input[Mapping[str, pulumi.Input[str]]] sdrs_advanced_options: Advanced configuration options for storage DRS.
520
- :param pulumi.Input[str] sdrs_automation_level: The default automation level for all virtual machines in this storage cluster.
521
- :param pulumi.Input[bool] sdrs_default_intra_vm_affinity: When true, storage DRS keeps VMDKs for individual VMs on the same datastore by default.
575
+ :param pulumi.Input[Mapping[str, pulumi.Input[str]]] sdrs_advanced_options: A key/value map of advanced Storage DRS
576
+ settings that are not exposed via the provider or the vSphere client.
577
+ :param pulumi.Input[str] sdrs_automation_level: The global automation level for all
578
+ virtual machines in this datastore cluster. Default: `manual`.
579
+ :param pulumi.Input[bool] sdrs_default_intra_vm_affinity: When `true`, all disks in a
580
+ single virtual machine will be kept on the same datastore. Default: `true`.
522
581
  :param pulumi.Input[bool] sdrs_enabled: Enable Storage DRS for this datastore cluster.
523
582
  Default: `false`.
524
- :param pulumi.Input[int] sdrs_free_space_threshold: The threshold, in GB, that storage DRS uses to make decisions to migrate VMs out of a datastore.
583
+ :param pulumi.Input[int] sdrs_free_space_threshold: The free space threshold to use.
584
+ When set to `utilization`, `drs_space_utilization_threshold` is used, and
585
+ when set to `freeSpace`, `drs_free_space_threshold` is used. Default:
586
+ `utilization`.
525
587
  :param pulumi.Input[str] sdrs_free_space_threshold_mode: The free space threshold to use. When set to utilization, drs_space_utilization_threshold is used, and when set to
526
588
  freeSpace, drs_free_space_threshold is used.
527
- :param pulumi.Input[int] sdrs_free_space_utilization_difference: The threshold, in percent, of difference between space utilization in datastores before storage DRS makes decisions to
528
- balance the space.
529
- :param pulumi.Input[str] sdrs_io_balance_automation_level: Overrides the default automation settings when correcting I/O load imbalances.
530
- :param pulumi.Input[int] sdrs_io_latency_threshold: The I/O latency threshold, in milliseconds, that storage DRS uses to make recommendations to move disks from this
531
- datastore.
532
- :param pulumi.Input[bool] sdrs_io_load_balance_enabled: Enable I/O load balancing for this datastore cluster.
533
- :param pulumi.Input[int] sdrs_io_load_imbalance_threshold: The difference between load in datastores in the cluster before storage DRS makes recommendations to balance the load.
534
- :param pulumi.Input[int] sdrs_io_reservable_iops_threshold: The threshold of reservable IOPS of all virtual machines on the datastore before storage DRS makes recommendations to
535
- move VMs off of a datastore.
536
- :param pulumi.Input[int] sdrs_io_reservable_percent_threshold: The threshold, in percent, of actual estimated performance of the datastore (in IOPS) that storage DRS uses to make
537
- recommendations to move VMs off of a datastore when the total reservable IOPS exceeds the threshold.
538
- :param pulumi.Input[str] sdrs_io_reservable_threshold_mode: The reservable IOPS threshold to use, percent in the event of automatic, or manual threshold in the event of manual.
539
- :param pulumi.Input[int] sdrs_load_balance_interval: The storage DRS poll interval, in minutes.
540
- :param pulumi.Input[str] sdrs_policy_enforcement_automation_level: Overrides the default automation settings when correcting storage and VM policy violations.
541
- :param pulumi.Input[str] sdrs_rule_enforcement_automation_level: Overrides the default automation settings when correcting affinity rule violations.
542
- :param pulumi.Input[str] sdrs_space_balance_automation_level: Overrides the default automation settings when correcting disk space imbalances.
543
- :param pulumi.Input[int] sdrs_space_utilization_threshold: The threshold, in percent of used space, that storage DRS uses to make decisions to migrate VMs out of a datastore.
544
- :param pulumi.Input[str] sdrs_vm_evacuation_automation_level: Overrides the default automation settings when generating recommendations for datastore evacuation.
589
+ :param pulumi.Input[int] sdrs_free_space_utilization_difference: The threshold, in
590
+ percent, of difference between space utilization in datastores before storage
591
+ DRS makes decisions to balance the space. Default: `5` percent.
592
+ :param pulumi.Input[str] sdrs_io_balance_automation_level: Overrides the default
593
+ automation settings when correcting I/O load imbalances.
594
+ :param pulumi.Input[int] sdrs_io_latency_threshold: The I/O latency threshold, in
595
+ milliseconds, that storage DRS uses to make recommendations to move disks
596
+ from this datastore. Default: `15` seconds.
597
+ :param pulumi.Input[bool] sdrs_io_load_balance_enabled: Enable I/O load balancing for
598
+ this datastore cluster. Default: `true`.
599
+ :param pulumi.Input[int] sdrs_io_load_imbalance_threshold: The difference between load
600
+ in datastores in the cluster before storage DRS makes recommendations to
601
+ balance the load. Default: `5` percent.
602
+ :param pulumi.Input[int] sdrs_io_reservable_iops_threshold: The threshold of reservable
603
+ IOPS of all virtual machines on the datastore before storage DRS makes
604
+ recommendations to move VMs off of a datastore. Note that this setting should
605
+ only be set if `sdrs_io_reservable_percent_threshold` cannot make an accurate
606
+ estimate of the capacity of the datastores in your cluster, and should be set
607
+ to roughly 50-60%!o(MISSING)f the worst case peak performance of the backing LUNs.
608
+ :param pulumi.Input[int] sdrs_io_reservable_percent_threshold: The threshold, in
609
+ percent, of actual estimated performance of the datastore (in IOPS) that
610
+ storage DRS uses to make recommendations to move VMs off of a datastore when
611
+ the total reservable IOPS exceeds the threshold. Default: `60` percent.
612
+ :param pulumi.Input[str] sdrs_io_reservable_threshold_mode: The reservable IOPS
613
+ threshold setting to use, `sdrs_io_reservable_percent_threshold` in the event
614
+ of `automatic`, or `sdrs_io_reservable_iops_threshold` in the event of
615
+ `manual`. Default: `automatic`.
616
+ :param pulumi.Input[int] sdrs_load_balance_interval: The storage DRS poll interval, in
617
+ minutes. Default: `480` minutes.
618
+ :param pulumi.Input[str] sdrs_policy_enforcement_automation_level: Overrides the default
619
+ automation settings when correcting storage and VM policy violations.
620
+ :param pulumi.Input[str] sdrs_rule_enforcement_automation_level: Overrides the default
621
+ automation settings when correcting affinity rule violations.
622
+ :param pulumi.Input[str] sdrs_space_balance_automation_level: Overrides the default
623
+ automation settings when correcting disk space imbalances.
624
+ :param pulumi.Input[int] sdrs_space_utilization_threshold: Runtime thresholds govern
625
+ when Storage DRS performs or recommends migrations
626
+ (based on the selected automation level). Default: `80` percent.
627
+ :param pulumi.Input[str] sdrs_vm_evacuation_automation_level: Overrides the default
628
+ automation settings when generating recommendations for datastore evacuation.
545
629
  :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource.
546
630
 
547
631
  > **NOTE:** Tagging support requires vCenter 6.0 or higher.
@@ -665,7 +749,8 @@ class _DatastoreClusterState:
665
749
  @pulumi.getter(name="sdrsAdvancedOptions")
666
750
  def sdrs_advanced_options(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
667
751
  """
668
- Advanced configuration options for storage DRS.
752
+ A key/value map of advanced Storage DRS
753
+ settings that are not exposed via the provider or the vSphere client.
669
754
  """
670
755
  return pulumi.get(self, "sdrs_advanced_options")
671
756
 
@@ -677,7 +762,8 @@ class _DatastoreClusterState:
677
762
  @pulumi.getter(name="sdrsAutomationLevel")
678
763
  def sdrs_automation_level(self) -> Optional[pulumi.Input[str]]:
679
764
  """
680
- The default automation level for all virtual machines in this storage cluster.
765
+ The global automation level for all
766
+ virtual machines in this datastore cluster. Default: `manual`.
681
767
  """
682
768
  return pulumi.get(self, "sdrs_automation_level")
683
769
 
@@ -689,7 +775,8 @@ class _DatastoreClusterState:
689
775
  @pulumi.getter(name="sdrsDefaultIntraVmAffinity")
690
776
  def sdrs_default_intra_vm_affinity(self) -> Optional[pulumi.Input[bool]]:
691
777
  """
692
- When true, storage DRS keeps VMDKs for individual VMs on the same datastore by default.
778
+ When `true`, all disks in a
779
+ single virtual machine will be kept on the same datastore. Default: `true`.
693
780
  """
694
781
  return pulumi.get(self, "sdrs_default_intra_vm_affinity")
695
782
 
@@ -714,7 +801,10 @@ class _DatastoreClusterState:
714
801
  @pulumi.getter(name="sdrsFreeSpaceThreshold")
715
802
  def sdrs_free_space_threshold(self) -> Optional[pulumi.Input[int]]:
716
803
  """
717
- The threshold, in GB, that storage DRS uses to make decisions to migrate VMs out of a datastore.
804
+ The free space threshold to use.
805
+ When set to `utilization`, `drs_space_utilization_threshold` is used, and
806
+ when set to `freeSpace`, `drs_free_space_threshold` is used. Default:
807
+ `utilization`.
718
808
  """
719
809
  return pulumi.get(self, "sdrs_free_space_threshold")
720
810
 
@@ -739,8 +829,9 @@ class _DatastoreClusterState:
739
829
  @pulumi.getter(name="sdrsFreeSpaceUtilizationDifference")
740
830
  def sdrs_free_space_utilization_difference(self) -> Optional[pulumi.Input[int]]:
741
831
  """
742
- The threshold, in percent, of difference between space utilization in datastores before storage DRS makes decisions to
743
- balance the space.
832
+ The threshold, in
833
+ percent, of difference between space utilization in datastores before storage
834
+ DRS makes decisions to balance the space. Default: `5` percent.
744
835
  """
745
836
  return pulumi.get(self, "sdrs_free_space_utilization_difference")
746
837
 
@@ -752,7 +843,8 @@ class _DatastoreClusterState:
752
843
  @pulumi.getter(name="sdrsIoBalanceAutomationLevel")
753
844
  def sdrs_io_balance_automation_level(self) -> Optional[pulumi.Input[str]]:
754
845
  """
755
- Overrides the default automation settings when correcting I/O load imbalances.
846
+ Overrides the default
847
+ automation settings when correcting I/O load imbalances.
756
848
  """
757
849
  return pulumi.get(self, "sdrs_io_balance_automation_level")
758
850
 
@@ -764,8 +856,9 @@ class _DatastoreClusterState:
764
856
  @pulumi.getter(name="sdrsIoLatencyThreshold")
765
857
  def sdrs_io_latency_threshold(self) -> Optional[pulumi.Input[int]]:
766
858
  """
767
- The I/O latency threshold, in milliseconds, that storage DRS uses to make recommendations to move disks from this
768
- datastore.
859
+ The I/O latency threshold, in
860
+ milliseconds, that storage DRS uses to make recommendations to move disks
861
+ from this datastore. Default: `15` seconds.
769
862
  """
770
863
  return pulumi.get(self, "sdrs_io_latency_threshold")
771
864
 
@@ -777,7 +870,8 @@ class _DatastoreClusterState:
777
870
  @pulumi.getter(name="sdrsIoLoadBalanceEnabled")
778
871
  def sdrs_io_load_balance_enabled(self) -> Optional[pulumi.Input[bool]]:
779
872
  """
780
- Enable I/O load balancing for this datastore cluster.
873
+ Enable I/O load balancing for
874
+ this datastore cluster. Default: `true`.
781
875
  """
782
876
  return pulumi.get(self, "sdrs_io_load_balance_enabled")
783
877
 
@@ -789,7 +883,9 @@ class _DatastoreClusterState:
789
883
  @pulumi.getter(name="sdrsIoLoadImbalanceThreshold")
790
884
  def sdrs_io_load_imbalance_threshold(self) -> Optional[pulumi.Input[int]]:
791
885
  """
792
- The difference between load in datastores in the cluster before storage DRS makes recommendations to balance the load.
886
+ The difference between load
887
+ in datastores in the cluster before storage DRS makes recommendations to
888
+ balance the load. Default: `5` percent.
793
889
  """
794
890
  return pulumi.get(self, "sdrs_io_load_imbalance_threshold")
795
891
 
@@ -801,8 +897,12 @@ class _DatastoreClusterState:
801
897
  @pulumi.getter(name="sdrsIoReservableIopsThreshold")
802
898
  def sdrs_io_reservable_iops_threshold(self) -> Optional[pulumi.Input[int]]:
803
899
  """
804
- The threshold of reservable IOPS of all virtual machines on the datastore before storage DRS makes recommendations to
805
- move VMs off of a datastore.
900
+ The threshold of reservable
901
+ IOPS of all virtual machines on the datastore before storage DRS makes
902
+ recommendations to move VMs off of a datastore. Note that this setting should
903
+ only be set if `sdrs_io_reservable_percent_threshold` cannot make an accurate
904
+ estimate of the capacity of the datastores in your cluster, and should be set
905
+ to roughly 50-60%!o(MISSING)f the worst case peak performance of the backing LUNs.
806
906
  """
807
907
  return pulumi.get(self, "sdrs_io_reservable_iops_threshold")
808
908
 
@@ -814,8 +914,10 @@ class _DatastoreClusterState:
814
914
  @pulumi.getter(name="sdrsIoReservablePercentThreshold")
815
915
  def sdrs_io_reservable_percent_threshold(self) -> Optional[pulumi.Input[int]]:
816
916
  """
817
- The threshold, in percent, of actual estimated performance of the datastore (in IOPS) that storage DRS uses to make
818
- recommendations to move VMs off of a datastore when the total reservable IOPS exceeds the threshold.
917
+ The threshold, in
918
+ percent, of actual estimated performance of the datastore (in IOPS) that
919
+ storage DRS uses to make recommendations to move VMs off of a datastore when
920
+ the total reservable IOPS exceeds the threshold. Default: `60` percent.
819
921
  """
820
922
  return pulumi.get(self, "sdrs_io_reservable_percent_threshold")
821
923
 
@@ -827,7 +929,10 @@ class _DatastoreClusterState:
827
929
  @pulumi.getter(name="sdrsIoReservableThresholdMode")
828
930
  def sdrs_io_reservable_threshold_mode(self) -> Optional[pulumi.Input[str]]:
829
931
  """
830
- The reservable IOPS threshold to use, percent in the event of automatic, or manual threshold in the event of manual.
932
+ The reservable IOPS
933
+ threshold setting to use, `sdrs_io_reservable_percent_threshold` in the event
934
+ of `automatic`, or `sdrs_io_reservable_iops_threshold` in the event of
935
+ `manual`. Default: `automatic`.
831
936
  """
832
937
  return pulumi.get(self, "sdrs_io_reservable_threshold_mode")
833
938
 
@@ -839,7 +944,8 @@ class _DatastoreClusterState:
839
944
  @pulumi.getter(name="sdrsLoadBalanceInterval")
840
945
  def sdrs_load_balance_interval(self) -> Optional[pulumi.Input[int]]:
841
946
  """
842
- The storage DRS poll interval, in minutes.
947
+ The storage DRS poll interval, in
948
+ minutes. Default: `480` minutes.
843
949
  """
844
950
  return pulumi.get(self, "sdrs_load_balance_interval")
845
951
 
@@ -851,7 +957,8 @@ class _DatastoreClusterState:
851
957
  @pulumi.getter(name="sdrsPolicyEnforcementAutomationLevel")
852
958
  def sdrs_policy_enforcement_automation_level(self) -> Optional[pulumi.Input[str]]:
853
959
  """
854
- Overrides the default automation settings when correcting storage and VM policy violations.
960
+ Overrides the default
961
+ automation settings when correcting storage and VM policy violations.
855
962
  """
856
963
  return pulumi.get(self, "sdrs_policy_enforcement_automation_level")
857
964
 
@@ -863,7 +970,8 @@ class _DatastoreClusterState:
863
970
  @pulumi.getter(name="sdrsRuleEnforcementAutomationLevel")
864
971
  def sdrs_rule_enforcement_automation_level(self) -> Optional[pulumi.Input[str]]:
865
972
  """
866
- Overrides the default automation settings when correcting affinity rule violations.
973
+ Overrides the default
974
+ automation settings when correcting affinity rule violations.
867
975
  """
868
976
  return pulumi.get(self, "sdrs_rule_enforcement_automation_level")
869
977
 
@@ -875,7 +983,8 @@ class _DatastoreClusterState:
875
983
  @pulumi.getter(name="sdrsSpaceBalanceAutomationLevel")
876
984
  def sdrs_space_balance_automation_level(self) -> Optional[pulumi.Input[str]]:
877
985
  """
878
- Overrides the default automation settings when correcting disk space imbalances.
986
+ Overrides the default
987
+ automation settings when correcting disk space imbalances.
879
988
  """
880
989
  return pulumi.get(self, "sdrs_space_balance_automation_level")
881
990
 
@@ -887,7 +996,9 @@ class _DatastoreClusterState:
887
996
  @pulumi.getter(name="sdrsSpaceUtilizationThreshold")
888
997
  def sdrs_space_utilization_threshold(self) -> Optional[pulumi.Input[int]]:
889
998
  """
890
- The threshold, in percent of used space, that storage DRS uses to make decisions to migrate VMs out of a datastore.
999
+ Runtime thresholds govern
1000
+ when Storage DRS performs or recommends migrations
1001
+ (based on the selected automation level). Default: `80` percent.
891
1002
  """
892
1003
  return pulumi.get(self, "sdrs_space_utilization_threshold")
893
1004
 
@@ -899,7 +1010,8 @@ class _DatastoreClusterState:
899
1010
  @pulumi.getter(name="sdrsVmEvacuationAutomationLevel")
900
1011
  def sdrs_vm_evacuation_automation_level(self) -> Optional[pulumi.Input[str]]:
901
1012
  """
902
- Overrides the default automation settings when generating recommendations for datastore evacuation.
1013
+ Overrides the default
1014
+ automation settings when generating recommendations for datastore evacuation.
903
1015
  """
904
1016
  return pulumi.get(self, "sdrs_vm_evacuation_automation_level")
905
1017
 
@@ -977,32 +1089,60 @@ class DatastoreCluster(pulumi.CustomResource):
977
1089
  `/dc1/datastore/foo/bar`, with the final inventory path being
978
1090
  `/dc1/datastore/foo/bar/datastore-cluster-test`.
979
1091
  :param pulumi.Input[str] name: The name of the datastore cluster.
980
- :param pulumi.Input[Mapping[str, pulumi.Input[str]]] sdrs_advanced_options: Advanced configuration options for storage DRS.
981
- :param pulumi.Input[str] sdrs_automation_level: The default automation level for all virtual machines in this storage cluster.
982
- :param pulumi.Input[bool] sdrs_default_intra_vm_affinity: When true, storage DRS keeps VMDKs for individual VMs on the same datastore by default.
1092
+ :param pulumi.Input[Mapping[str, pulumi.Input[str]]] sdrs_advanced_options: A key/value map of advanced Storage DRS
1093
+ settings that are not exposed via the provider or the vSphere client.
1094
+ :param pulumi.Input[str] sdrs_automation_level: The global automation level for all
1095
+ virtual machines in this datastore cluster. Default: `manual`.
1096
+ :param pulumi.Input[bool] sdrs_default_intra_vm_affinity: When `true`, all disks in a
1097
+ single virtual machine will be kept on the same datastore. Default: `true`.
983
1098
  :param pulumi.Input[bool] sdrs_enabled: Enable Storage DRS for this datastore cluster.
984
1099
  Default: `false`.
985
- :param pulumi.Input[int] sdrs_free_space_threshold: The threshold, in GB, that storage DRS uses to make decisions to migrate VMs out of a datastore.
1100
+ :param pulumi.Input[int] sdrs_free_space_threshold: The free space threshold to use.
1101
+ When set to `utilization`, `drs_space_utilization_threshold` is used, and
1102
+ when set to `freeSpace`, `drs_free_space_threshold` is used. Default:
1103
+ `utilization`.
986
1104
  :param pulumi.Input[str] sdrs_free_space_threshold_mode: The free space threshold to use. When set to utilization, drs_space_utilization_threshold is used, and when set to
987
1105
  freeSpace, drs_free_space_threshold is used.
988
- :param pulumi.Input[int] sdrs_free_space_utilization_difference: The threshold, in percent, of difference between space utilization in datastores before storage DRS makes decisions to
989
- balance the space.
990
- :param pulumi.Input[str] sdrs_io_balance_automation_level: Overrides the default automation settings when correcting I/O load imbalances.
991
- :param pulumi.Input[int] sdrs_io_latency_threshold: The I/O latency threshold, in milliseconds, that storage DRS uses to make recommendations to move disks from this
992
- datastore.
993
- :param pulumi.Input[bool] sdrs_io_load_balance_enabled: Enable I/O load balancing for this datastore cluster.
994
- :param pulumi.Input[int] sdrs_io_load_imbalance_threshold: The difference between load in datastores in the cluster before storage DRS makes recommendations to balance the load.
995
- :param pulumi.Input[int] sdrs_io_reservable_iops_threshold: The threshold of reservable IOPS of all virtual machines on the datastore before storage DRS makes recommendations to
996
- move VMs off of a datastore.
997
- :param pulumi.Input[int] sdrs_io_reservable_percent_threshold: The threshold, in percent, of actual estimated performance of the datastore (in IOPS) that storage DRS uses to make
998
- recommendations to move VMs off of a datastore when the total reservable IOPS exceeds the threshold.
999
- :param pulumi.Input[str] sdrs_io_reservable_threshold_mode: The reservable IOPS threshold to use, percent in the event of automatic, or manual threshold in the event of manual.
1000
- :param pulumi.Input[int] sdrs_load_balance_interval: The storage DRS poll interval, in minutes.
1001
- :param pulumi.Input[str] sdrs_policy_enforcement_automation_level: Overrides the default automation settings when correcting storage and VM policy violations.
1002
- :param pulumi.Input[str] sdrs_rule_enforcement_automation_level: Overrides the default automation settings when correcting affinity rule violations.
1003
- :param pulumi.Input[str] sdrs_space_balance_automation_level: Overrides the default automation settings when correcting disk space imbalances.
1004
- :param pulumi.Input[int] sdrs_space_utilization_threshold: The threshold, in percent of used space, that storage DRS uses to make decisions to migrate VMs out of a datastore.
1005
- :param pulumi.Input[str] sdrs_vm_evacuation_automation_level: Overrides the default automation settings when generating recommendations for datastore evacuation.
1106
+ :param pulumi.Input[int] sdrs_free_space_utilization_difference: The threshold, in
1107
+ percent, of difference between space utilization in datastores before storage
1108
+ DRS makes decisions to balance the space. Default: `5` percent.
1109
+ :param pulumi.Input[str] sdrs_io_balance_automation_level: Overrides the default
1110
+ automation settings when correcting I/O load imbalances.
1111
+ :param pulumi.Input[int] sdrs_io_latency_threshold: The I/O latency threshold, in
1112
+ milliseconds, that storage DRS uses to make recommendations to move disks
1113
+ from this datastore. Default: `15` seconds.
1114
+ :param pulumi.Input[bool] sdrs_io_load_balance_enabled: Enable I/O load balancing for
1115
+ this datastore cluster. Default: `true`.
1116
+ :param pulumi.Input[int] sdrs_io_load_imbalance_threshold: The difference between load
1117
+ in datastores in the cluster before storage DRS makes recommendations to
1118
+ balance the load. Default: `5` percent.
1119
+ :param pulumi.Input[int] sdrs_io_reservable_iops_threshold: The threshold of reservable
1120
+ IOPS of all virtual machines on the datastore before storage DRS makes
1121
+ recommendations to move VMs off of a datastore. Note that this setting should
1122
+ only be set if `sdrs_io_reservable_percent_threshold` cannot make an accurate
1123
+ estimate of the capacity of the datastores in your cluster, and should be set
1124
+ to roughly 50-60%!o(MISSING)f the worst case peak performance of the backing LUNs.
1125
+ :param pulumi.Input[int] sdrs_io_reservable_percent_threshold: The threshold, in
1126
+ percent, of actual estimated performance of the datastore (in IOPS) that
1127
+ storage DRS uses to make recommendations to move VMs off of a datastore when
1128
+ the total reservable IOPS exceeds the threshold. Default: `60` percent.
1129
+ :param pulumi.Input[str] sdrs_io_reservable_threshold_mode: The reservable IOPS
1130
+ threshold setting to use, `sdrs_io_reservable_percent_threshold` in the event
1131
+ of `automatic`, or `sdrs_io_reservable_iops_threshold` in the event of
1132
+ `manual`. Default: `automatic`.
1133
+ :param pulumi.Input[int] sdrs_load_balance_interval: The storage DRS poll interval, in
1134
+ minutes. Default: `480` minutes.
1135
+ :param pulumi.Input[str] sdrs_policy_enforcement_automation_level: Overrides the default
1136
+ automation settings when correcting storage and VM policy violations.
1137
+ :param pulumi.Input[str] sdrs_rule_enforcement_automation_level: Overrides the default
1138
+ automation settings when correcting affinity rule violations.
1139
+ :param pulumi.Input[str] sdrs_space_balance_automation_level: Overrides the default
1140
+ automation settings when correcting disk space imbalances.
1141
+ :param pulumi.Input[int] sdrs_space_utilization_threshold: Runtime thresholds govern
1142
+ when Storage DRS performs or recommends migrations
1143
+ (based on the selected automation level). Default: `80` percent.
1144
+ :param pulumi.Input[str] sdrs_vm_evacuation_automation_level: Overrides the default
1145
+ automation settings when generating recommendations for datastore evacuation.
1006
1146
  :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource.
1007
1147
 
1008
1148
  > **NOTE:** Tagging support requires vCenter 6.0 or higher.
@@ -1153,32 +1293,60 @@ class DatastoreCluster(pulumi.CustomResource):
1153
1293
  `/dc1/datastore/foo/bar`, with the final inventory path being
1154
1294
  `/dc1/datastore/foo/bar/datastore-cluster-test`.
1155
1295
  :param pulumi.Input[str] name: The name of the datastore cluster.
1156
- :param pulumi.Input[Mapping[str, pulumi.Input[str]]] sdrs_advanced_options: Advanced configuration options for storage DRS.
1157
- :param pulumi.Input[str] sdrs_automation_level: The default automation level for all virtual machines in this storage cluster.
1158
- :param pulumi.Input[bool] sdrs_default_intra_vm_affinity: When true, storage DRS keeps VMDKs for individual VMs on the same datastore by default.
1296
+ :param pulumi.Input[Mapping[str, pulumi.Input[str]]] sdrs_advanced_options: A key/value map of advanced Storage DRS
1297
+ settings that are not exposed via the provider or the vSphere client.
1298
+ :param pulumi.Input[str] sdrs_automation_level: The global automation level for all
1299
+ virtual machines in this datastore cluster. Default: `manual`.
1300
+ :param pulumi.Input[bool] sdrs_default_intra_vm_affinity: When `true`, all disks in a
1301
+ single virtual machine will be kept on the same datastore. Default: `true`.
1159
1302
  :param pulumi.Input[bool] sdrs_enabled: Enable Storage DRS for this datastore cluster.
1160
1303
  Default: `false`.
1161
- :param pulumi.Input[int] sdrs_free_space_threshold: The threshold, in GB, that storage DRS uses to make decisions to migrate VMs out of a datastore.
1304
+ :param pulumi.Input[int] sdrs_free_space_threshold: The free space threshold to use.
1305
+ When set to `utilization`, `drs_space_utilization_threshold` is used, and
1306
+ when set to `freeSpace`, `drs_free_space_threshold` is used. Default:
1307
+ `utilization`.
1162
1308
  :param pulumi.Input[str] sdrs_free_space_threshold_mode: The free space threshold to use. When set to utilization, drs_space_utilization_threshold is used, and when set to
1163
1309
  freeSpace, drs_free_space_threshold is used.
1164
- :param pulumi.Input[int] sdrs_free_space_utilization_difference: The threshold, in percent, of difference between space utilization in datastores before storage DRS makes decisions to
1165
- balance the space.
1166
- :param pulumi.Input[str] sdrs_io_balance_automation_level: Overrides the default automation settings when correcting I/O load imbalances.
1167
- :param pulumi.Input[int] sdrs_io_latency_threshold: The I/O latency threshold, in milliseconds, that storage DRS uses to make recommendations to move disks from this
1168
- datastore.
1169
- :param pulumi.Input[bool] sdrs_io_load_balance_enabled: Enable I/O load balancing for this datastore cluster.
1170
- :param pulumi.Input[int] sdrs_io_load_imbalance_threshold: The difference between load in datastores in the cluster before storage DRS makes recommendations to balance the load.
1171
- :param pulumi.Input[int] sdrs_io_reservable_iops_threshold: The threshold of reservable IOPS of all virtual machines on the datastore before storage DRS makes recommendations to
1172
- move VMs off of a datastore.
1173
- :param pulumi.Input[int] sdrs_io_reservable_percent_threshold: The threshold, in percent, of actual estimated performance of the datastore (in IOPS) that storage DRS uses to make
1174
- recommendations to move VMs off of a datastore when the total reservable IOPS exceeds the threshold.
1175
- :param pulumi.Input[str] sdrs_io_reservable_threshold_mode: The reservable IOPS threshold to use, percent in the event of automatic, or manual threshold in the event of manual.
1176
- :param pulumi.Input[int] sdrs_load_balance_interval: The storage DRS poll interval, in minutes.
1177
- :param pulumi.Input[str] sdrs_policy_enforcement_automation_level: Overrides the default automation settings when correcting storage and VM policy violations.
1178
- :param pulumi.Input[str] sdrs_rule_enforcement_automation_level: Overrides the default automation settings when correcting affinity rule violations.
1179
- :param pulumi.Input[str] sdrs_space_balance_automation_level: Overrides the default automation settings when correcting disk space imbalances.
1180
- :param pulumi.Input[int] sdrs_space_utilization_threshold: The threshold, in percent of used space, that storage DRS uses to make decisions to migrate VMs out of a datastore.
1181
- :param pulumi.Input[str] sdrs_vm_evacuation_automation_level: Overrides the default automation settings when generating recommendations for datastore evacuation.
1310
+ :param pulumi.Input[int] sdrs_free_space_utilization_difference: The threshold, in
1311
+ percent, of difference between space utilization in datastores before storage
1312
+ DRS makes decisions to balance the space. Default: `5` percent.
1313
+ :param pulumi.Input[str] sdrs_io_balance_automation_level: Overrides the default
1314
+ automation settings when correcting I/O load imbalances.
1315
+ :param pulumi.Input[int] sdrs_io_latency_threshold: The I/O latency threshold, in
1316
+ milliseconds, that storage DRS uses to make recommendations to move disks
1317
+ from this datastore. Default: `15` seconds.
1318
+ :param pulumi.Input[bool] sdrs_io_load_balance_enabled: Enable I/O load balancing for
1319
+ this datastore cluster. Default: `true`.
1320
+ :param pulumi.Input[int] sdrs_io_load_imbalance_threshold: The difference between load
1321
+ in datastores in the cluster before storage DRS makes recommendations to
1322
+ balance the load. Default: `5` percent.
1323
+ :param pulumi.Input[int] sdrs_io_reservable_iops_threshold: The threshold of reservable
1324
+ IOPS of all virtual machines on the datastore before storage DRS makes
1325
+ recommendations to move VMs off of a datastore. Note that this setting should
1326
+ only be set if `sdrs_io_reservable_percent_threshold` cannot make an accurate
1327
+ estimate of the capacity of the datastores in your cluster, and should be set
1328
+ to roughly 50-60%!o(MISSING)f the worst case peak performance of the backing LUNs.
1329
+ :param pulumi.Input[int] sdrs_io_reservable_percent_threshold: The threshold, in
1330
+ percent, of actual estimated performance of the datastore (in IOPS) that
1331
+ storage DRS uses to make recommendations to move VMs off of a datastore when
1332
+ the total reservable IOPS exceeds the threshold. Default: `60` percent.
1333
+ :param pulumi.Input[str] sdrs_io_reservable_threshold_mode: The reservable IOPS
1334
+ threshold setting to use, `sdrs_io_reservable_percent_threshold` in the event
1335
+ of `automatic`, or `sdrs_io_reservable_iops_threshold` in the event of
1336
+ `manual`. Default: `automatic`.
1337
+ :param pulumi.Input[int] sdrs_load_balance_interval: The storage DRS poll interval, in
1338
+ minutes. Default: `480` minutes.
1339
+ :param pulumi.Input[str] sdrs_policy_enforcement_automation_level: Overrides the default
1340
+ automation settings when correcting storage and VM policy violations.
1341
+ :param pulumi.Input[str] sdrs_rule_enforcement_automation_level: Overrides the default
1342
+ automation settings when correcting affinity rule violations.
1343
+ :param pulumi.Input[str] sdrs_space_balance_automation_level: Overrides the default
1344
+ automation settings when correcting disk space imbalances.
1345
+ :param pulumi.Input[int] sdrs_space_utilization_threshold: Runtime thresholds govern
1346
+ when Storage DRS performs or recommends migrations
1347
+ (based on the selected automation level). Default: `80` percent.
1348
+ :param pulumi.Input[str] sdrs_vm_evacuation_automation_level: Overrides the default
1349
+ automation settings when generating recommendations for datastore evacuation.
1182
1350
  :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource.
1183
1351
 
1184
1352
  > **NOTE:** Tagging support requires vCenter 6.0 or higher.
@@ -1266,7 +1434,8 @@ class DatastoreCluster(pulumi.CustomResource):
1266
1434
  @pulumi.getter(name="sdrsAdvancedOptions")
1267
1435
  def sdrs_advanced_options(self) -> pulumi.Output[Optional[Mapping[str, str]]]:
1268
1436
  """
1269
- Advanced configuration options for storage DRS.
1437
+ A key/value map of advanced Storage DRS
1438
+ settings that are not exposed via the provider or the vSphere client.
1270
1439
  """
1271
1440
  return pulumi.get(self, "sdrs_advanced_options")
1272
1441
 
@@ -1274,7 +1443,8 @@ class DatastoreCluster(pulumi.CustomResource):
1274
1443
  @pulumi.getter(name="sdrsAutomationLevel")
1275
1444
  def sdrs_automation_level(self) -> pulumi.Output[Optional[str]]:
1276
1445
  """
1277
- The default automation level for all virtual machines in this storage cluster.
1446
+ The global automation level for all
1447
+ virtual machines in this datastore cluster. Default: `manual`.
1278
1448
  """
1279
1449
  return pulumi.get(self, "sdrs_automation_level")
1280
1450
 
@@ -1282,7 +1452,8 @@ class DatastoreCluster(pulumi.CustomResource):
1282
1452
  @pulumi.getter(name="sdrsDefaultIntraVmAffinity")
1283
1453
  def sdrs_default_intra_vm_affinity(self) -> pulumi.Output[Optional[bool]]:
1284
1454
  """
1285
- When true, storage DRS keeps VMDKs for individual VMs on the same datastore by default.
1455
+ When `true`, all disks in a
1456
+ single virtual machine will be kept on the same datastore. Default: `true`.
1286
1457
  """
1287
1458
  return pulumi.get(self, "sdrs_default_intra_vm_affinity")
1288
1459
 
@@ -1299,7 +1470,10 @@ class DatastoreCluster(pulumi.CustomResource):
1299
1470
  @pulumi.getter(name="sdrsFreeSpaceThreshold")
1300
1471
  def sdrs_free_space_threshold(self) -> pulumi.Output[Optional[int]]:
1301
1472
  """
1302
- The threshold, in GB, that storage DRS uses to make decisions to migrate VMs out of a datastore.
1473
+ The free space threshold to use.
1474
+ When set to `utilization`, `drs_space_utilization_threshold` is used, and
1475
+ when set to `freeSpace`, `drs_free_space_threshold` is used. Default:
1476
+ `utilization`.
1303
1477
  """
1304
1478
  return pulumi.get(self, "sdrs_free_space_threshold")
1305
1479
 
@@ -1316,8 +1490,9 @@ class DatastoreCluster(pulumi.CustomResource):
1316
1490
  @pulumi.getter(name="sdrsFreeSpaceUtilizationDifference")
1317
1491
  def sdrs_free_space_utilization_difference(self) -> pulumi.Output[Optional[int]]:
1318
1492
  """
1319
- The threshold, in percent, of difference between space utilization in datastores before storage DRS makes decisions to
1320
- balance the space.
1493
+ The threshold, in
1494
+ percent, of difference between space utilization in datastores before storage
1495
+ DRS makes decisions to balance the space. Default: `5` percent.
1321
1496
  """
1322
1497
  return pulumi.get(self, "sdrs_free_space_utilization_difference")
1323
1498
 
@@ -1325,7 +1500,8 @@ class DatastoreCluster(pulumi.CustomResource):
1325
1500
  @pulumi.getter(name="sdrsIoBalanceAutomationLevel")
1326
1501
  def sdrs_io_balance_automation_level(self) -> pulumi.Output[Optional[str]]:
1327
1502
  """
1328
- Overrides the default automation settings when correcting I/O load imbalances.
1503
+ Overrides the default
1504
+ automation settings when correcting I/O load imbalances.
1329
1505
  """
1330
1506
  return pulumi.get(self, "sdrs_io_balance_automation_level")
1331
1507
 
@@ -1333,8 +1509,9 @@ class DatastoreCluster(pulumi.CustomResource):
1333
1509
  @pulumi.getter(name="sdrsIoLatencyThreshold")
1334
1510
  def sdrs_io_latency_threshold(self) -> pulumi.Output[Optional[int]]:
1335
1511
  """
1336
- The I/O latency threshold, in milliseconds, that storage DRS uses to make recommendations to move disks from this
1337
- datastore.
1512
+ The I/O latency threshold, in
1513
+ milliseconds, that storage DRS uses to make recommendations to move disks
1514
+ from this datastore. Default: `15` seconds.
1338
1515
  """
1339
1516
  return pulumi.get(self, "sdrs_io_latency_threshold")
1340
1517
 
@@ -1342,7 +1519,8 @@ class DatastoreCluster(pulumi.CustomResource):
1342
1519
  @pulumi.getter(name="sdrsIoLoadBalanceEnabled")
1343
1520
  def sdrs_io_load_balance_enabled(self) -> pulumi.Output[Optional[bool]]:
1344
1521
  """
1345
- Enable I/O load balancing for this datastore cluster.
1522
+ Enable I/O load balancing for
1523
+ this datastore cluster. Default: `true`.
1346
1524
  """
1347
1525
  return pulumi.get(self, "sdrs_io_load_balance_enabled")
1348
1526
 
@@ -1350,7 +1528,9 @@ class DatastoreCluster(pulumi.CustomResource):
1350
1528
  @pulumi.getter(name="sdrsIoLoadImbalanceThreshold")
1351
1529
  def sdrs_io_load_imbalance_threshold(self) -> pulumi.Output[Optional[int]]:
1352
1530
  """
1353
- The difference between load in datastores in the cluster before storage DRS makes recommendations to balance the load.
1531
+ The difference between load
1532
+ in datastores in the cluster before storage DRS makes recommendations to
1533
+ balance the load. Default: `5` percent.
1354
1534
  """
1355
1535
  return pulumi.get(self, "sdrs_io_load_imbalance_threshold")
1356
1536
 
@@ -1358,8 +1538,12 @@ class DatastoreCluster(pulumi.CustomResource):
1358
1538
  @pulumi.getter(name="sdrsIoReservableIopsThreshold")
1359
1539
  def sdrs_io_reservable_iops_threshold(self) -> pulumi.Output[Optional[int]]:
1360
1540
  """
1361
- The threshold of reservable IOPS of all virtual machines on the datastore before storage DRS makes recommendations to
1362
- move VMs off of a datastore.
1541
+ The threshold of reservable
1542
+ IOPS of all virtual machines on the datastore before storage DRS makes
1543
+ recommendations to move VMs off of a datastore. Note that this setting should
1544
+ only be set if `sdrs_io_reservable_percent_threshold` cannot make an accurate
1545
+ estimate of the capacity of the datastores in your cluster, and should be set
1546
+ to roughly 50-60%!o(MISSING)f the worst case peak performance of the backing LUNs.
1363
1547
  """
1364
1548
  return pulumi.get(self, "sdrs_io_reservable_iops_threshold")
1365
1549
 
@@ -1367,8 +1551,10 @@ class DatastoreCluster(pulumi.CustomResource):
1367
1551
  @pulumi.getter(name="sdrsIoReservablePercentThreshold")
1368
1552
  def sdrs_io_reservable_percent_threshold(self) -> pulumi.Output[Optional[int]]:
1369
1553
  """
1370
- The threshold, in percent, of actual estimated performance of the datastore (in IOPS) that storage DRS uses to make
1371
- recommendations to move VMs off of a datastore when the total reservable IOPS exceeds the threshold.
1554
+ The threshold, in
1555
+ percent, of actual estimated performance of the datastore (in IOPS) that
1556
+ storage DRS uses to make recommendations to move VMs off of a datastore when
1557
+ the total reservable IOPS exceeds the threshold. Default: `60` percent.
1372
1558
  """
1373
1559
  return pulumi.get(self, "sdrs_io_reservable_percent_threshold")
1374
1560
 
@@ -1376,7 +1562,10 @@ class DatastoreCluster(pulumi.CustomResource):
1376
1562
  @pulumi.getter(name="sdrsIoReservableThresholdMode")
1377
1563
  def sdrs_io_reservable_threshold_mode(self) -> pulumi.Output[Optional[str]]:
1378
1564
  """
1379
- The reservable IOPS threshold to use, percent in the event of automatic, or manual threshold in the event of manual.
1565
+ The reservable IOPS
1566
+ threshold setting to use, `sdrs_io_reservable_percent_threshold` in the event
1567
+ of `automatic`, or `sdrs_io_reservable_iops_threshold` in the event of
1568
+ `manual`. Default: `automatic`.
1380
1569
  """
1381
1570
  return pulumi.get(self, "sdrs_io_reservable_threshold_mode")
1382
1571
 
@@ -1384,7 +1573,8 @@ class DatastoreCluster(pulumi.CustomResource):
1384
1573
  @pulumi.getter(name="sdrsLoadBalanceInterval")
1385
1574
  def sdrs_load_balance_interval(self) -> pulumi.Output[Optional[int]]:
1386
1575
  """
1387
- The storage DRS poll interval, in minutes.
1576
+ The storage DRS poll interval, in
1577
+ minutes. Default: `480` minutes.
1388
1578
  """
1389
1579
  return pulumi.get(self, "sdrs_load_balance_interval")
1390
1580
 
@@ -1392,7 +1582,8 @@ class DatastoreCluster(pulumi.CustomResource):
1392
1582
  @pulumi.getter(name="sdrsPolicyEnforcementAutomationLevel")
1393
1583
  def sdrs_policy_enforcement_automation_level(self) -> pulumi.Output[Optional[str]]:
1394
1584
  """
1395
- Overrides the default automation settings when correcting storage and VM policy violations.
1585
+ Overrides the default
1586
+ automation settings when correcting storage and VM policy violations.
1396
1587
  """
1397
1588
  return pulumi.get(self, "sdrs_policy_enforcement_automation_level")
1398
1589
 
@@ -1400,7 +1591,8 @@ class DatastoreCluster(pulumi.CustomResource):
1400
1591
  @pulumi.getter(name="sdrsRuleEnforcementAutomationLevel")
1401
1592
  def sdrs_rule_enforcement_automation_level(self) -> pulumi.Output[Optional[str]]:
1402
1593
  """
1403
- Overrides the default automation settings when correcting affinity rule violations.
1594
+ Overrides the default
1595
+ automation settings when correcting affinity rule violations.
1404
1596
  """
1405
1597
  return pulumi.get(self, "sdrs_rule_enforcement_automation_level")
1406
1598
 
@@ -1408,7 +1600,8 @@ class DatastoreCluster(pulumi.CustomResource):
1408
1600
  @pulumi.getter(name="sdrsSpaceBalanceAutomationLevel")
1409
1601
  def sdrs_space_balance_automation_level(self) -> pulumi.Output[Optional[str]]:
1410
1602
  """
1411
- Overrides the default automation settings when correcting disk space imbalances.
1603
+ Overrides the default
1604
+ automation settings when correcting disk space imbalances.
1412
1605
  """
1413
1606
  return pulumi.get(self, "sdrs_space_balance_automation_level")
1414
1607
 
@@ -1416,7 +1609,9 @@ class DatastoreCluster(pulumi.CustomResource):
1416
1609
  @pulumi.getter(name="sdrsSpaceUtilizationThreshold")
1417
1610
  def sdrs_space_utilization_threshold(self) -> pulumi.Output[Optional[int]]:
1418
1611
  """
1419
- The threshold, in percent of used space, that storage DRS uses to make decisions to migrate VMs out of a datastore.
1612
+ Runtime thresholds govern
1613
+ when Storage DRS performs or recommends migrations
1614
+ (based on the selected automation level). Default: `80` percent.
1420
1615
  """
1421
1616
  return pulumi.get(self, "sdrs_space_utilization_threshold")
1422
1617
 
@@ -1424,7 +1619,8 @@ class DatastoreCluster(pulumi.CustomResource):
1424
1619
  @pulumi.getter(name="sdrsVmEvacuationAutomationLevel")
1425
1620
  def sdrs_vm_evacuation_automation_level(self) -> pulumi.Output[Optional[str]]:
1426
1621
  """
1427
- Overrides the default automation settings when generating recommendations for datastore evacuation.
1622
+ Overrides the default
1623
+ automation settings when generating recommendations for datastore evacuation.
1428
1624
  """
1429
1625
  return pulumi.get(self, "sdrs_vm_evacuation_automation_level")
1430
1626