pulumi-vsphere 4.11.0__py3-none-any.whl → 4.11.0a1710920591__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 (65) hide show
  1. pulumi_vsphere/__init__.py +0 -28
  2. pulumi_vsphere/_inputs.py +236 -646
  3. pulumi_vsphere/_utilities.py +4 -40
  4. pulumi_vsphere/compute_cluster.py +1486 -756
  5. pulumi_vsphere/compute_cluster_vm_affinity_rule.py +34 -42
  6. pulumi_vsphere/content_library.py +10 -10
  7. pulumi_vsphere/datacenter.py +40 -33
  8. pulumi_vsphere/datastore_cluster.py +364 -154
  9. pulumi_vsphere/distributed_port_group.py +187 -131
  10. pulumi_vsphere/distributed_virtual_switch.py +828 -310
  11. pulumi_vsphere/entity_permissions.py +38 -59
  12. pulumi_vsphere/file.py +24 -16
  13. pulumi_vsphere/folder.py +28 -7
  14. pulumi_vsphere/get_compute_cluster.py +4 -0
  15. pulumi_vsphere/get_compute_cluster_host_group.py +20 -20
  16. pulumi_vsphere/get_content_library.py +10 -10
  17. pulumi_vsphere/get_content_library_item.py +8 -12
  18. pulumi_vsphere/get_custom_attribute.py +4 -0
  19. pulumi_vsphere/get_datacenter.py +4 -0
  20. pulumi_vsphere/get_datastore.py +16 -12
  21. pulumi_vsphere/get_datastore_cluster.py +4 -0
  22. pulumi_vsphere/get_datastore_stats.py +52 -46
  23. pulumi_vsphere/get_distributed_virtual_switch.py +4 -2
  24. pulumi_vsphere/get_dynamic.py +20 -18
  25. pulumi_vsphere/get_folder.py +6 -10
  26. pulumi_vsphere/get_guest_os_customization.py +47 -8
  27. pulumi_vsphere/get_host.py +4 -0
  28. pulumi_vsphere/get_host_pci_device.py +14 -8
  29. pulumi_vsphere/get_host_thumbprint.py +16 -12
  30. pulumi_vsphere/get_host_vgpu_profile.py +10 -4
  31. pulumi_vsphere/get_license.py +5 -2
  32. pulumi_vsphere/get_network.py +18 -14
  33. pulumi_vsphere/get_policy.py +4 -0
  34. pulumi_vsphere/get_resource_pool.py +18 -14
  35. pulumi_vsphere/get_role.py +8 -4
  36. pulumi_vsphere/get_tag.py +4 -0
  37. pulumi_vsphere/get_tag_category.py +4 -0
  38. pulumi_vsphere/get_vapp_container.py +4 -0
  39. pulumi_vsphere/get_virtual_machine.py +43 -60
  40. pulumi_vsphere/get_vmfs_disks.py +4 -0
  41. pulumi_vsphere/guest_os_customization.py +5 -55
  42. pulumi_vsphere/ha_vm_override.py +378 -189
  43. pulumi_vsphere/host.py +60 -49
  44. pulumi_vsphere/host_port_group.py +26 -14
  45. pulumi_vsphere/host_virtual_switch.py +287 -140
  46. pulumi_vsphere/license.py +32 -0
  47. pulumi_vsphere/nas_datastore.py +7 -7
  48. pulumi_vsphere/outputs.py +270 -672
  49. pulumi_vsphere/provider.py +6 -2
  50. pulumi_vsphere/pulumi-plugin.json +1 -2
  51. pulumi_vsphere/resource_pool.py +24 -50
  52. pulumi_vsphere/virtual_disk.py +34 -42
  53. pulumi_vsphere/virtual_machine.py +827 -598
  54. pulumi_vsphere/virtual_machine_snapshot.py +12 -8
  55. pulumi_vsphere/vm_storage_policy.py +127 -115
  56. pulumi_vsphere/vnic.py +105 -89
  57. {pulumi_vsphere-4.11.0.dist-info → pulumi_vsphere-4.11.0a1710920591.dist-info}/METADATA +1 -1
  58. pulumi_vsphere-4.11.0a1710920591.dist-info/RECORD +82 -0
  59. {pulumi_vsphere-4.11.0.dist-info → pulumi_vsphere-4.11.0a1710920591.dist-info}/WHEEL +1 -1
  60. pulumi_vsphere/get_host_base_images.py +0 -97
  61. pulumi_vsphere/offline_software_depot.py +0 -180
  62. pulumi_vsphere/supervisor.py +0 -962
  63. pulumi_vsphere/virtual_machine_class.py +0 -442
  64. pulumi_vsphere-4.11.0.dist-info/RECORD +0 -86
  65. {pulumi_vsphere-4.11.0.dist-info → pulumi_vsphere-4.11.0a1710920591.dist-info}/top_level.txt +0 -0
pulumi_vsphere/datastore_cluster.py CHANGED
@@ -61,33 +61,63 @@ 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.
119
+
120
+ > **NOTE:** Tagging support requires vCenter 6.0 or higher.
91
121
  """
92
122
  pulumi.set(__self__, "datacenter_id", datacenter_id)
93
123
  if custom_attributes is not None:
@@ -207,7 +237,8 @@ class DatastoreClusterArgs:
207
237
  @pulumi.getter(name="sdrsAdvancedOptions")
208
238
  def sdrs_advanced_options(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
209
239
  """
210
- 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.
211
242
  """
212
243
  return pulumi.get(self, "sdrs_advanced_options")
213
244
 
@@ -219,7 +250,8 @@ class DatastoreClusterArgs:
219
250
  @pulumi.getter(name="sdrsAutomationLevel")
220
251
  def sdrs_automation_level(self) -> Optional[pulumi.Input[str]]:
221
252
  """
222
- 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`.
223
255
  """
224
256
  return pulumi.get(self, "sdrs_automation_level")
225
257
 
@@ -231,7 +263,8 @@ class DatastoreClusterArgs:
231
263
  @pulumi.getter(name="sdrsDefaultIntraVmAffinity")
232
264
  def sdrs_default_intra_vm_affinity(self) -> Optional[pulumi.Input[bool]]:
233
265
  """
234
- 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`.
235
268
  """
236
269
  return pulumi.get(self, "sdrs_default_intra_vm_affinity")
237
270
 
@@ -256,7 +289,10 @@ class DatastoreClusterArgs:
256
289
  @pulumi.getter(name="sdrsFreeSpaceThreshold")
257
290
  def sdrs_free_space_threshold(self) -> Optional[pulumi.Input[int]]:
258
291
  """
259
- 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`.
260
296
  """
261
297
  return pulumi.get(self, "sdrs_free_space_threshold")
262
298
 
@@ -281,8 +317,9 @@ class DatastoreClusterArgs:
281
317
  @pulumi.getter(name="sdrsFreeSpaceUtilizationDifference")
282
318
  def sdrs_free_space_utilization_difference(self) -> Optional[pulumi.Input[int]]:
283
319
  """
284
- The threshold, in percent, of difference between space utilization in datastores before storage DRS makes decisions to
285
- 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.
286
323
  """
287
324
  return pulumi.get(self, "sdrs_free_space_utilization_difference")
288
325
 
@@ -294,7 +331,8 @@ class DatastoreClusterArgs:
294
331
  @pulumi.getter(name="sdrsIoBalanceAutomationLevel")
295
332
  def sdrs_io_balance_automation_level(self) -> Optional[pulumi.Input[str]]:
296
333
  """
297
- Overrides the default automation settings when correcting I/O load imbalances.
334
+ Overrides the default
335
+ automation settings when correcting I/O load imbalances.
298
336
  """
299
337
  return pulumi.get(self, "sdrs_io_balance_automation_level")
300
338
 
@@ -306,8 +344,9 @@ class DatastoreClusterArgs:
306
344
  @pulumi.getter(name="sdrsIoLatencyThreshold")
307
345
  def sdrs_io_latency_threshold(self) -> Optional[pulumi.Input[int]]:
308
346
  """
309
- The I/O latency threshold, in milliseconds, that storage DRS uses to make recommendations to move disks from this
310
- 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.
311
350
  """
312
351
  return pulumi.get(self, "sdrs_io_latency_threshold")
313
352
 
@@ -319,7 +358,8 @@ class DatastoreClusterArgs:
319
358
  @pulumi.getter(name="sdrsIoLoadBalanceEnabled")
320
359
  def sdrs_io_load_balance_enabled(self) -> Optional[pulumi.Input[bool]]:
321
360
  """
322
- Enable I/O load balancing for this datastore cluster.
361
+ Enable I/O load balancing for
362
+ this datastore cluster. Default: `true`.
323
363
  """
324
364
  return pulumi.get(self, "sdrs_io_load_balance_enabled")
325
365
 
@@ -331,7 +371,9 @@ class DatastoreClusterArgs:
331
371
  @pulumi.getter(name="sdrsIoLoadImbalanceThreshold")
332
372
  def sdrs_io_load_imbalance_threshold(self) -> Optional[pulumi.Input[int]]:
333
373
  """
334
- 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.
335
377
  """
336
378
  return pulumi.get(self, "sdrs_io_load_imbalance_threshold")
337
379
 
@@ -343,8 +385,12 @@ class DatastoreClusterArgs:
343
385
  @pulumi.getter(name="sdrsIoReservableIopsThreshold")
344
386
  def sdrs_io_reservable_iops_threshold(self) -> Optional[pulumi.Input[int]]:
345
387
  """
346
- The threshold of reservable IOPS of all virtual machines on the datastore before storage DRS makes recommendations to
347
- 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.
348
394
  """
349
395
  return pulumi.get(self, "sdrs_io_reservable_iops_threshold")
350
396
 
@@ -356,8 +402,10 @@ class DatastoreClusterArgs:
356
402
  @pulumi.getter(name="sdrsIoReservablePercentThreshold")
357
403
  def sdrs_io_reservable_percent_threshold(self) -> Optional[pulumi.Input[int]]:
358
404
  """
359
- The threshold, in percent, of actual estimated performance of the datastore (in IOPS) that storage DRS uses to make
360
- 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.
361
409
  """
362
410
  return pulumi.get(self, "sdrs_io_reservable_percent_threshold")
363
411
 
@@ -369,7 +417,10 @@ class DatastoreClusterArgs:
369
417
  @pulumi.getter(name="sdrsIoReservableThresholdMode")
370
418
  def sdrs_io_reservable_threshold_mode(self) -> Optional[pulumi.Input[str]]:
371
419
  """
372
- 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`.
373
424
  """
374
425
  return pulumi.get(self, "sdrs_io_reservable_threshold_mode")
375
426
 
@@ -381,7 +432,8 @@ class DatastoreClusterArgs:
381
432
  @pulumi.getter(name="sdrsLoadBalanceInterval")
382
433
  def sdrs_load_balance_interval(self) -> Optional[pulumi.Input[int]]:
383
434
  """
384
- The storage DRS poll interval, in minutes.
435
+ The storage DRS poll interval, in
436
+ minutes. Default: `480` minutes.
385
437
  """
386
438
  return pulumi.get(self, "sdrs_load_balance_interval")
387
439
 
@@ -393,7 +445,8 @@ class DatastoreClusterArgs:
393
445
  @pulumi.getter(name="sdrsPolicyEnforcementAutomationLevel")
394
446
  def sdrs_policy_enforcement_automation_level(self) -> Optional[pulumi.Input[str]]:
395
447
  """
396
- 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.
397
450
  """
398
451
  return pulumi.get(self, "sdrs_policy_enforcement_automation_level")
399
452
 
@@ -405,7 +458,8 @@ class DatastoreClusterArgs:
405
458
  @pulumi.getter(name="sdrsRuleEnforcementAutomationLevel")
406
459
  def sdrs_rule_enforcement_automation_level(self) -> Optional[pulumi.Input[str]]:
407
460
  """
408
- Overrides the default automation settings when correcting affinity rule violations.
461
+ Overrides the default
462
+ automation settings when correcting affinity rule violations.
409
463
  """
410
464
  return pulumi.get(self, "sdrs_rule_enforcement_automation_level")
411
465
 
@@ -417,7 +471,8 @@ class DatastoreClusterArgs:
417
471
  @pulumi.getter(name="sdrsSpaceBalanceAutomationLevel")
418
472
  def sdrs_space_balance_automation_level(self) -> Optional[pulumi.Input[str]]:
419
473
  """
420
- Overrides the default automation settings when correcting disk space imbalances.
474
+ Overrides the default
475
+ automation settings when correcting disk space imbalances.
421
476
  """
422
477
  return pulumi.get(self, "sdrs_space_balance_automation_level")
423
478
 
@@ -429,7 +484,9 @@ class DatastoreClusterArgs:
429
484
  @pulumi.getter(name="sdrsSpaceUtilizationThreshold")
430
485
  def sdrs_space_utilization_threshold(self) -> Optional[pulumi.Input[int]]:
431
486
  """
432
- 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.
433
490
  """
434
491
  return pulumi.get(self, "sdrs_space_utilization_threshold")
435
492
 
@@ -441,7 +498,8 @@ class DatastoreClusterArgs:
441
498
  @pulumi.getter(name="sdrsVmEvacuationAutomationLevel")
442
499
  def sdrs_vm_evacuation_automation_level(self) -> Optional[pulumi.Input[str]]:
443
500
  """
444
- Overrides the default automation settings when generating recommendations for datastore evacuation.
501
+ Overrides the default
502
+ automation settings when generating recommendations for datastore evacuation.
445
503
  """
446
504
  return pulumi.get(self, "sdrs_vm_evacuation_automation_level")
447
505
 
@@ -454,6 +512,8 @@ class DatastoreClusterArgs:
454
512
  def tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
455
513
  """
456
514
  The IDs of any tags to attach to this resource.
515
+
516
+ > **NOTE:** Tagging support requires vCenter 6.0 or higher.
457
517
  """
458
518
  return pulumi.get(self, "tags")
459
519
 
@@ -512,33 +572,63 @@ class _DatastoreClusterState:
512
572
  `/dc1/datastore/foo/bar`, with the final inventory path being
513
573
  `/dc1/datastore/foo/bar/datastore-cluster-test`.
514
574
  :param pulumi.Input[str] name: The name of the datastore cluster.
515
- :param pulumi.Input[Mapping[str, pulumi.Input[str]]] sdrs_advanced_options: Advanced configuration options for storage DRS.
516
- :param pulumi.Input[str] sdrs_automation_level: The default automation level for all virtual machines in this storage cluster.
517
- :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`.
518
581
  :param pulumi.Input[bool] sdrs_enabled: Enable Storage DRS for this datastore cluster.
519
582
  Default: `false`.
520
- :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`.
521
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
522
588
  freeSpace, drs_free_space_threshold is used.
523
- :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
524
- balance the space.
525
- :param pulumi.Input[str] sdrs_io_balance_automation_level: Overrides the default automation settings when correcting I/O load imbalances.
526
- :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
527
- datastore.
528
- :param pulumi.Input[bool] sdrs_io_load_balance_enabled: Enable I/O load balancing for this datastore cluster.
529
- :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.
530
- :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
531
- move VMs off of a datastore.
532
- :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
533
- recommendations to move VMs off of a datastore when the total reservable IOPS exceeds the threshold.
534
- :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.
535
- :param pulumi.Input[int] sdrs_load_balance_interval: The storage DRS poll interval, in minutes.
536
- :param pulumi.Input[str] sdrs_policy_enforcement_automation_level: Overrides the default automation settings when correcting storage and VM policy violations.
537
- :param pulumi.Input[str] sdrs_rule_enforcement_automation_level: Overrides the default automation settings when correcting affinity rule violations.
538
- :param pulumi.Input[str] sdrs_space_balance_automation_level: Overrides the default automation settings when correcting disk space imbalances.
539
- :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.
540
- :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.
541
629
  :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource.
630
+
631
+ > **NOTE:** Tagging support requires vCenter 6.0 or higher.
542
632
  """
543
633
  if custom_attributes is not None:
544
634
  pulumi.set(__self__, "custom_attributes", custom_attributes)
@@ -659,7 +749,8 @@ class _DatastoreClusterState:
659
749
  @pulumi.getter(name="sdrsAdvancedOptions")
660
750
  def sdrs_advanced_options(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
661
751
  """
662
- 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.
663
754
  """
664
755
  return pulumi.get(self, "sdrs_advanced_options")
665
756
 
@@ -671,7 +762,8 @@ class _DatastoreClusterState:
671
762
  @pulumi.getter(name="sdrsAutomationLevel")
672
763
  def sdrs_automation_level(self) -> Optional[pulumi.Input[str]]:
673
764
  """
674
- 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`.
675
767
  """
676
768
  return pulumi.get(self, "sdrs_automation_level")
677
769
 
@@ -683,7 +775,8 @@ class _DatastoreClusterState:
683
775
  @pulumi.getter(name="sdrsDefaultIntraVmAffinity")
684
776
  def sdrs_default_intra_vm_affinity(self) -> Optional[pulumi.Input[bool]]:
685
777
  """
686
- 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`.
687
780
  """
688
781
  return pulumi.get(self, "sdrs_default_intra_vm_affinity")
689
782
 
@@ -708,7 +801,10 @@ class _DatastoreClusterState:
708
801
  @pulumi.getter(name="sdrsFreeSpaceThreshold")
709
802
  def sdrs_free_space_threshold(self) -> Optional[pulumi.Input[int]]:
710
803
  """
711
- 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`.
712
808
  """
713
809
  return pulumi.get(self, "sdrs_free_space_threshold")
714
810
 
@@ -733,8 +829,9 @@ class _DatastoreClusterState:
733
829
  @pulumi.getter(name="sdrsFreeSpaceUtilizationDifference")
734
830
  def sdrs_free_space_utilization_difference(self) -> Optional[pulumi.Input[int]]:
735
831
  """
736
- The threshold, in percent, of difference between space utilization in datastores before storage DRS makes decisions to
737
- 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.
738
835
  """
739
836
  return pulumi.get(self, "sdrs_free_space_utilization_difference")
740
837
 
@@ -746,7 +843,8 @@ class _DatastoreClusterState:
746
843
  @pulumi.getter(name="sdrsIoBalanceAutomationLevel")
747
844
  def sdrs_io_balance_automation_level(self) -> Optional[pulumi.Input[str]]:
748
845
  """
749
- Overrides the default automation settings when correcting I/O load imbalances.
846
+ Overrides the default
847
+ automation settings when correcting I/O load imbalances.
750
848
  """
751
849
  return pulumi.get(self, "sdrs_io_balance_automation_level")
752
850
 
@@ -758,8 +856,9 @@ class _DatastoreClusterState:
758
856
  @pulumi.getter(name="sdrsIoLatencyThreshold")
759
857
  def sdrs_io_latency_threshold(self) -> Optional[pulumi.Input[int]]:
760
858
  """
761
- The I/O latency threshold, in milliseconds, that storage DRS uses to make recommendations to move disks from this
762
- 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.
763
862
  """
764
863
  return pulumi.get(self, "sdrs_io_latency_threshold")
765
864
 
@@ -771,7 +870,8 @@ class _DatastoreClusterState:
771
870
  @pulumi.getter(name="sdrsIoLoadBalanceEnabled")
772
871
  def sdrs_io_load_balance_enabled(self) -> Optional[pulumi.Input[bool]]:
773
872
  """
774
- Enable I/O load balancing for this datastore cluster.
873
+ Enable I/O load balancing for
874
+ this datastore cluster. Default: `true`.
775
875
  """
776
876
  return pulumi.get(self, "sdrs_io_load_balance_enabled")
777
877
 
@@ -783,7 +883,9 @@ class _DatastoreClusterState:
783
883
  @pulumi.getter(name="sdrsIoLoadImbalanceThreshold")
784
884
  def sdrs_io_load_imbalance_threshold(self) -> Optional[pulumi.Input[int]]:
785
885
  """
786
- 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.
787
889
  """
788
890
  return pulumi.get(self, "sdrs_io_load_imbalance_threshold")
789
891
 
@@ -795,8 +897,12 @@ class _DatastoreClusterState:
795
897
  @pulumi.getter(name="sdrsIoReservableIopsThreshold")
796
898
  def sdrs_io_reservable_iops_threshold(self) -> Optional[pulumi.Input[int]]:
797
899
  """
798
- The threshold of reservable IOPS of all virtual machines on the datastore before storage DRS makes recommendations to
799
- 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.
800
906
  """
801
907
  return pulumi.get(self, "sdrs_io_reservable_iops_threshold")
802
908
 
@@ -808,8 +914,10 @@ class _DatastoreClusterState:
808
914
  @pulumi.getter(name="sdrsIoReservablePercentThreshold")
809
915
  def sdrs_io_reservable_percent_threshold(self) -> Optional[pulumi.Input[int]]:
810
916
  """
811
- The threshold, in percent, of actual estimated performance of the datastore (in IOPS) that storage DRS uses to make
812
- 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.
813
921
  """
814
922
  return pulumi.get(self, "sdrs_io_reservable_percent_threshold")
815
923
 
@@ -821,7 +929,10 @@ class _DatastoreClusterState:
821
929
  @pulumi.getter(name="sdrsIoReservableThresholdMode")
822
930
  def sdrs_io_reservable_threshold_mode(self) -> Optional[pulumi.Input[str]]:
823
931
  """
824
- 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`.
825
936
  """
826
937
  return pulumi.get(self, "sdrs_io_reservable_threshold_mode")
827
938
 
@@ -833,7 +944,8 @@ class _DatastoreClusterState:
833
944
  @pulumi.getter(name="sdrsLoadBalanceInterval")
834
945
  def sdrs_load_balance_interval(self) -> Optional[pulumi.Input[int]]:
835
946
  """
836
- The storage DRS poll interval, in minutes.
947
+ The storage DRS poll interval, in
948
+ minutes. Default: `480` minutes.
837
949
  """
838
950
  return pulumi.get(self, "sdrs_load_balance_interval")
839
951
 
@@ -845,7 +957,8 @@ class _DatastoreClusterState:
845
957
  @pulumi.getter(name="sdrsPolicyEnforcementAutomationLevel")
846
958
  def sdrs_policy_enforcement_automation_level(self) -> Optional[pulumi.Input[str]]:
847
959
  """
848
- 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.
849
962
  """
850
963
  return pulumi.get(self, "sdrs_policy_enforcement_automation_level")
851
964
 
@@ -857,7 +970,8 @@ class _DatastoreClusterState:
857
970
  @pulumi.getter(name="sdrsRuleEnforcementAutomationLevel")
858
971
  def sdrs_rule_enforcement_automation_level(self) -> Optional[pulumi.Input[str]]:
859
972
  """
860
- Overrides the default automation settings when correcting affinity rule violations.
973
+ Overrides the default
974
+ automation settings when correcting affinity rule violations.
861
975
  """
862
976
  return pulumi.get(self, "sdrs_rule_enforcement_automation_level")
863
977
 
@@ -869,7 +983,8 @@ class _DatastoreClusterState:
869
983
  @pulumi.getter(name="sdrsSpaceBalanceAutomationLevel")
870
984
  def sdrs_space_balance_automation_level(self) -> Optional[pulumi.Input[str]]:
871
985
  """
872
- Overrides the default automation settings when correcting disk space imbalances.
986
+ Overrides the default
987
+ automation settings when correcting disk space imbalances.
873
988
  """
874
989
  return pulumi.get(self, "sdrs_space_balance_automation_level")
875
990
 
@@ -881,7 +996,9 @@ class _DatastoreClusterState:
881
996
  @pulumi.getter(name="sdrsSpaceUtilizationThreshold")
882
997
  def sdrs_space_utilization_threshold(self) -> Optional[pulumi.Input[int]]:
883
998
  """
884
- 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.
885
1002
  """
886
1003
  return pulumi.get(self, "sdrs_space_utilization_threshold")
887
1004
 
@@ -893,7 +1010,8 @@ class _DatastoreClusterState:
893
1010
  @pulumi.getter(name="sdrsVmEvacuationAutomationLevel")
894
1011
  def sdrs_vm_evacuation_automation_level(self) -> Optional[pulumi.Input[str]]:
895
1012
  """
896
- Overrides the default automation settings when generating recommendations for datastore evacuation.
1013
+ Overrides the default
1014
+ automation settings when generating recommendations for datastore evacuation.
897
1015
  """
898
1016
  return pulumi.get(self, "sdrs_vm_evacuation_automation_level")
899
1017
 
@@ -906,6 +1024,8 @@ class _DatastoreClusterState:
906
1024
  def tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
907
1025
  """
908
1026
  The IDs of any tags to attach to this resource.
1027
+
1028
+ > **NOTE:** Tagging support requires vCenter 6.0 or higher.
909
1029
  """
910
1030
  return pulumi.get(self, "tags")
911
1031
 
@@ -969,33 +1089,63 @@ class DatastoreCluster(pulumi.CustomResource):
969
1089
  `/dc1/datastore/foo/bar`, with the final inventory path being
970
1090
  `/dc1/datastore/foo/bar/datastore-cluster-test`.
971
1091
  :param pulumi.Input[str] name: The name of the datastore cluster.
972
- :param pulumi.Input[Mapping[str, pulumi.Input[str]]] sdrs_advanced_options: Advanced configuration options for storage DRS.
973
- :param pulumi.Input[str] sdrs_automation_level: The default automation level for all virtual machines in this storage cluster.
974
- :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`.
975
1098
  :param pulumi.Input[bool] sdrs_enabled: Enable Storage DRS for this datastore cluster.
976
1099
  Default: `false`.
977
- :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`.
978
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
979
1105
  freeSpace, drs_free_space_threshold is used.
980
- :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
981
- balance the space.
982
- :param pulumi.Input[str] sdrs_io_balance_automation_level: Overrides the default automation settings when correcting I/O load imbalances.
983
- :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
984
- datastore.
985
- :param pulumi.Input[bool] sdrs_io_load_balance_enabled: Enable I/O load balancing for this datastore cluster.
986
- :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.
987
- :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
988
- move VMs off of a datastore.
989
- :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
990
- recommendations to move VMs off of a datastore when the total reservable IOPS exceeds the threshold.
991
- :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.
992
- :param pulumi.Input[int] sdrs_load_balance_interval: The storage DRS poll interval, in minutes.
993
- :param pulumi.Input[str] sdrs_policy_enforcement_automation_level: Overrides the default automation settings when correcting storage and VM policy violations.
994
- :param pulumi.Input[str] sdrs_rule_enforcement_automation_level: Overrides the default automation settings when correcting affinity rule violations.
995
- :param pulumi.Input[str] sdrs_space_balance_automation_level: Overrides the default automation settings when correcting disk space imbalances.
996
- :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.
997
- :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.
998
1146
  :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource.
1147
+
1148
+ > **NOTE:** Tagging support requires vCenter 6.0 or higher.
999
1149
  """
1000
1150
  ...
1001
1151
  @overload
@@ -1143,33 +1293,63 @@ class DatastoreCluster(pulumi.CustomResource):
1143
1293
  `/dc1/datastore/foo/bar`, with the final inventory path being
1144
1294
  `/dc1/datastore/foo/bar/datastore-cluster-test`.
1145
1295
  :param pulumi.Input[str] name: The name of the datastore cluster.
1146
- :param pulumi.Input[Mapping[str, pulumi.Input[str]]] sdrs_advanced_options: Advanced configuration options for storage DRS.
1147
- :param pulumi.Input[str] sdrs_automation_level: The default automation level for all virtual machines in this storage cluster.
1148
- :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`.
1149
1302
  :param pulumi.Input[bool] sdrs_enabled: Enable Storage DRS for this datastore cluster.
1150
1303
  Default: `false`.
1151
- :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`.
1152
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
1153
1309
  freeSpace, drs_free_space_threshold is used.
1154
- :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
1155
- balance the space.
1156
- :param pulumi.Input[str] sdrs_io_balance_automation_level: Overrides the default automation settings when correcting I/O load imbalances.
1157
- :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
1158
- datastore.
1159
- :param pulumi.Input[bool] sdrs_io_load_balance_enabled: Enable I/O load balancing for this datastore cluster.
1160
- :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.
1161
- :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
1162
- move VMs off of a datastore.
1163
- :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
1164
- recommendations to move VMs off of a datastore when the total reservable IOPS exceeds the threshold.
1165
- :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.
1166
- :param pulumi.Input[int] sdrs_load_balance_interval: The storage DRS poll interval, in minutes.
1167
- :param pulumi.Input[str] sdrs_policy_enforcement_automation_level: Overrides the default automation settings when correcting storage and VM policy violations.
1168
- :param pulumi.Input[str] sdrs_rule_enforcement_automation_level: Overrides the default automation settings when correcting affinity rule violations.
1169
- :param pulumi.Input[str] sdrs_space_balance_automation_level: Overrides the default automation settings when correcting disk space imbalances.
1170
- :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.
1171
- :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.
1172
1350
  :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource.
1351
+
1352
+ > **NOTE:** Tagging support requires vCenter 6.0 or higher.
1173
1353
  """
1174
1354
  opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
1175
1355
 
@@ -1254,7 +1434,8 @@ class DatastoreCluster(pulumi.CustomResource):
1254
1434
  @pulumi.getter(name="sdrsAdvancedOptions")
1255
1435
  def sdrs_advanced_options(self) -> pulumi.Output[Optional[Mapping[str, str]]]:
1256
1436
  """
1257
- 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.
1258
1439
  """
1259
1440
  return pulumi.get(self, "sdrs_advanced_options")
1260
1441
 
@@ -1262,7 +1443,8 @@ class DatastoreCluster(pulumi.CustomResource):
1262
1443
  @pulumi.getter(name="sdrsAutomationLevel")
1263
1444
  def sdrs_automation_level(self) -> pulumi.Output[Optional[str]]:
1264
1445
  """
1265
- 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`.
1266
1448
  """
1267
1449
  return pulumi.get(self, "sdrs_automation_level")
1268
1450
 
@@ -1270,7 +1452,8 @@ class DatastoreCluster(pulumi.CustomResource):
1270
1452
  @pulumi.getter(name="sdrsDefaultIntraVmAffinity")
1271
1453
  def sdrs_default_intra_vm_affinity(self) -> pulumi.Output[Optional[bool]]:
1272
1454
  """
1273
- 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`.
1274
1457
  """
1275
1458
  return pulumi.get(self, "sdrs_default_intra_vm_affinity")
1276
1459
 
@@ -1287,7 +1470,10 @@ class DatastoreCluster(pulumi.CustomResource):
1287
1470
  @pulumi.getter(name="sdrsFreeSpaceThreshold")
1288
1471
  def sdrs_free_space_threshold(self) -> pulumi.Output[Optional[int]]:
1289
1472
  """
1290
- 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`.
1291
1477
  """
1292
1478
  return pulumi.get(self, "sdrs_free_space_threshold")
1293
1479
 
@@ -1304,8 +1490,9 @@ class DatastoreCluster(pulumi.CustomResource):
1304
1490
  @pulumi.getter(name="sdrsFreeSpaceUtilizationDifference")
1305
1491
  def sdrs_free_space_utilization_difference(self) -> pulumi.Output[Optional[int]]:
1306
1492
  """
1307
- The threshold, in percent, of difference between space utilization in datastores before storage DRS makes decisions to
1308
- 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.
1309
1496
  """
1310
1497
  return pulumi.get(self, "sdrs_free_space_utilization_difference")
1311
1498
 
@@ -1313,7 +1500,8 @@ class DatastoreCluster(pulumi.CustomResource):
1313
1500
  @pulumi.getter(name="sdrsIoBalanceAutomationLevel")
1314
1501
  def sdrs_io_balance_automation_level(self) -> pulumi.Output[Optional[str]]:
1315
1502
  """
1316
- Overrides the default automation settings when correcting I/O load imbalances.
1503
+ Overrides the default
1504
+ automation settings when correcting I/O load imbalances.
1317
1505
  """
1318
1506
  return pulumi.get(self, "sdrs_io_balance_automation_level")
1319
1507
 
@@ -1321,8 +1509,9 @@ class DatastoreCluster(pulumi.CustomResource):
1321
1509
  @pulumi.getter(name="sdrsIoLatencyThreshold")
1322
1510
  def sdrs_io_latency_threshold(self) -> pulumi.Output[Optional[int]]:
1323
1511
  """
1324
- The I/O latency threshold, in milliseconds, that storage DRS uses to make recommendations to move disks from this
1325
- 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.
1326
1515
  """
1327
1516
  return pulumi.get(self, "sdrs_io_latency_threshold")
1328
1517
 
@@ -1330,7 +1519,8 @@ class DatastoreCluster(pulumi.CustomResource):
1330
1519
  @pulumi.getter(name="sdrsIoLoadBalanceEnabled")
1331
1520
  def sdrs_io_load_balance_enabled(self) -> pulumi.Output[Optional[bool]]:
1332
1521
  """
1333
- Enable I/O load balancing for this datastore cluster.
1522
+ Enable I/O load balancing for
1523
+ this datastore cluster. Default: `true`.
1334
1524
  """
1335
1525
  return pulumi.get(self, "sdrs_io_load_balance_enabled")
1336
1526
 
@@ -1338,7 +1528,9 @@ class DatastoreCluster(pulumi.CustomResource):
1338
1528
  @pulumi.getter(name="sdrsIoLoadImbalanceThreshold")
1339
1529
  def sdrs_io_load_imbalance_threshold(self) -> pulumi.Output[Optional[int]]:
1340
1530
  """
1341
- 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.
1342
1534
  """
1343
1535
  return pulumi.get(self, "sdrs_io_load_imbalance_threshold")
1344
1536
 
@@ -1346,8 +1538,12 @@ class DatastoreCluster(pulumi.CustomResource):
1346
1538
  @pulumi.getter(name="sdrsIoReservableIopsThreshold")
1347
1539
  def sdrs_io_reservable_iops_threshold(self) -> pulumi.Output[Optional[int]]:
1348
1540
  """
1349
- The threshold of reservable IOPS of all virtual machines on the datastore before storage DRS makes recommendations to
1350
- 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.
1351
1547
  """
1352
1548
  return pulumi.get(self, "sdrs_io_reservable_iops_threshold")
1353
1549
 
@@ -1355,8 +1551,10 @@ class DatastoreCluster(pulumi.CustomResource):
1355
1551
  @pulumi.getter(name="sdrsIoReservablePercentThreshold")
1356
1552
  def sdrs_io_reservable_percent_threshold(self) -> pulumi.Output[Optional[int]]:
1357
1553
  """
1358
- The threshold, in percent, of actual estimated performance of the datastore (in IOPS) that storage DRS uses to make
1359
- 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.
1360
1558
  """
1361
1559
  return pulumi.get(self, "sdrs_io_reservable_percent_threshold")
1362
1560
 
@@ -1364,7 +1562,10 @@ class DatastoreCluster(pulumi.CustomResource):
1364
1562
  @pulumi.getter(name="sdrsIoReservableThresholdMode")
1365
1563
  def sdrs_io_reservable_threshold_mode(self) -> pulumi.Output[Optional[str]]:
1366
1564
  """
1367
- 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`.
1368
1569
  """
1369
1570
  return pulumi.get(self, "sdrs_io_reservable_threshold_mode")
1370
1571
 
@@ -1372,7 +1573,8 @@ class DatastoreCluster(pulumi.CustomResource):
1372
1573
  @pulumi.getter(name="sdrsLoadBalanceInterval")
1373
1574
  def sdrs_load_balance_interval(self) -> pulumi.Output[Optional[int]]:
1374
1575
  """
1375
- The storage DRS poll interval, in minutes.
1576
+ The storage DRS poll interval, in
1577
+ minutes. Default: `480` minutes.
1376
1578
  """
1377
1579
  return pulumi.get(self, "sdrs_load_balance_interval")
1378
1580
 
@@ -1380,7 +1582,8 @@ class DatastoreCluster(pulumi.CustomResource):
1380
1582
  @pulumi.getter(name="sdrsPolicyEnforcementAutomationLevel")
1381
1583
  def sdrs_policy_enforcement_automation_level(self) -> pulumi.Output[Optional[str]]:
1382
1584
  """
1383
- 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.
1384
1587
  """
1385
1588
  return pulumi.get(self, "sdrs_policy_enforcement_automation_level")
1386
1589
 
@@ -1388,7 +1591,8 @@ class DatastoreCluster(pulumi.CustomResource):
1388
1591
  @pulumi.getter(name="sdrsRuleEnforcementAutomationLevel")
1389
1592
  def sdrs_rule_enforcement_automation_level(self) -> pulumi.Output[Optional[str]]:
1390
1593
  """
1391
- Overrides the default automation settings when correcting affinity rule violations.
1594
+ Overrides the default
1595
+ automation settings when correcting affinity rule violations.
1392
1596
  """
1393
1597
  return pulumi.get(self, "sdrs_rule_enforcement_automation_level")
1394
1598
 
@@ -1396,7 +1600,8 @@ class DatastoreCluster(pulumi.CustomResource):
1396
1600
  @pulumi.getter(name="sdrsSpaceBalanceAutomationLevel")
1397
1601
  def sdrs_space_balance_automation_level(self) -> pulumi.Output[Optional[str]]:
1398
1602
  """
1399
- Overrides the default automation settings when correcting disk space imbalances.
1603
+ Overrides the default
1604
+ automation settings when correcting disk space imbalances.
1400
1605
  """
1401
1606
  return pulumi.get(self, "sdrs_space_balance_automation_level")
1402
1607
 
@@ -1404,7 +1609,9 @@ class DatastoreCluster(pulumi.CustomResource):
1404
1609
  @pulumi.getter(name="sdrsSpaceUtilizationThreshold")
1405
1610
  def sdrs_space_utilization_threshold(self) -> pulumi.Output[Optional[int]]:
1406
1611
  """
1407
- 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.
1408
1615
  """
1409
1616
  return pulumi.get(self, "sdrs_space_utilization_threshold")
1410
1617
 
@@ -1412,7 +1619,8 @@ class DatastoreCluster(pulumi.CustomResource):
1412
1619
  @pulumi.getter(name="sdrsVmEvacuationAutomationLevel")
1413
1620
  def sdrs_vm_evacuation_automation_level(self) -> pulumi.Output[Optional[str]]:
1414
1621
  """
1415
- Overrides the default automation settings when generating recommendations for datastore evacuation.
1622
+ Overrides the default
1623
+ automation settings when generating recommendations for datastore evacuation.
1416
1624
  """
1417
1625
  return pulumi.get(self, "sdrs_vm_evacuation_automation_level")
1418
1626
 
@@ -1421,6 +1629,8 @@ class DatastoreCluster(pulumi.CustomResource):
1421
1629
  def tags(self) -> pulumi.Output[Optional[Sequence[str]]]:
1422
1630
  """
1423
1631
  The IDs of any tags to attach to this resource.
1632
+
1633
+ > **NOTE:** Tagging support requires vCenter 6.0 or higher.
1424
1634
  """
1425
1635
  return pulumi.get(self, "tags")
1426
1636