pulumi-vsphere 4.14.0a1746734806__py3-none-any.whl → 4.14.0a1747752163__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 (50) hide show
  1. pulumi_vsphere/compute_cluster.py +10 -10
  2. pulumi_vsphere/compute_cluster_host_group.py +70 -0
  3. pulumi_vsphere/compute_cluster_vm_anti_affinity_rule.py +4 -0
  4. pulumi_vsphere/compute_cluster_vm_dependency_rule.py +4 -0
  5. pulumi_vsphere/compute_cluster_vm_group.py +4 -0
  6. pulumi_vsphere/compute_cluster_vm_host_rule.py +4 -0
  7. pulumi_vsphere/content_library.py +4 -0
  8. pulumi_vsphere/content_library_item.py +4 -0
  9. pulumi_vsphere/custom_attribute.py +4 -0
  10. pulumi_vsphere/datastore_cluster.py +88 -0
  11. pulumi_vsphere/datastore_cluster_vm_anti_affinity_rule.py +4 -0
  12. pulumi_vsphere/distributed_port_group.py +4 -0
  13. pulumi_vsphere/distributed_virtual_switch.py +4 -0
  14. pulumi_vsphere/dpm_host_override.py +88 -0
  15. pulumi_vsphere/drs_vm_override.py +4 -0
  16. pulumi_vsphere/file.py +34 -49
  17. pulumi_vsphere/folder.py +16 -12
  18. pulumi_vsphere/get_compute_cluster_host_group.py +0 -4
  19. pulumi_vsphere/get_datastore_cluster.py +1 -1
  20. pulumi_vsphere/get_datastore_stats.py +0 -4
  21. pulumi_vsphere/get_dynamic.py +0 -4
  22. pulumi_vsphere/get_folder.py +130 -8
  23. pulumi_vsphere/get_guest_os_customization.py +21 -2
  24. pulumi_vsphere/get_license.py +8 -6
  25. pulumi_vsphere/get_network.py +35 -1
  26. pulumi_vsphere/get_ovf_vm_template.py +4 -4
  27. pulumi_vsphere/ha_vm_override.py +4 -0
  28. pulumi_vsphere/host.py +60 -6
  29. pulumi_vsphere/host_virtual_switch.py +4 -0
  30. pulumi_vsphere/license.py +66 -26
  31. pulumi_vsphere/nas_datastore.py +62 -0
  32. pulumi_vsphere/offline_software_depot.py +4 -0
  33. pulumi_vsphere/outputs.py +33 -0
  34. pulumi_vsphere/pulumi-plugin.json +1 -1
  35. pulumi_vsphere/resource_pool.py +489 -163
  36. pulumi_vsphere/storage_drs_vm_override.py +4 -0
  37. pulumi_vsphere/supervisor.py +2 -2
  38. pulumi_vsphere/tag.py +4 -0
  39. pulumi_vsphere/tag_category.py +4 -0
  40. pulumi_vsphere/vapp_container.py +4 -0
  41. pulumi_vsphere/vapp_entity.py +4 -0
  42. pulumi_vsphere/virtual_disk.py +4 -0
  43. pulumi_vsphere/virtual_machine.py +4 -4
  44. pulumi_vsphere/virtual_machine_class.py +4 -4
  45. pulumi_vsphere/vmfs_datastore.py +4 -0
  46. {pulumi_vsphere-4.14.0a1746734806.dist-info → pulumi_vsphere-4.14.0a1747752163.dist-info}/METADATA +1 -1
  47. pulumi_vsphere-4.14.0a1747752163.dist-info/RECORD +87 -0
  48. {pulumi_vsphere-4.14.0a1746734806.dist-info → pulumi_vsphere-4.14.0a1747752163.dist-info}/WHEEL +1 -1
  49. pulumi_vsphere-4.14.0a1746734806.dist-info/RECORD +0 -87
  50. {pulumi_vsphere-4.14.0a1746734806.dist-info → pulumi_vsphere-4.14.0a1747752163.dist-info}/top_level.txt +0 -0
@@ -37,30 +37,50 @@ class ResourcePoolArgs:
37
37
  tags: Optional[pulumi.Input[Sequence[pulumi.Input[builtins.str]]]] = None):
38
38
  """
39
39
  The set of arguments for constructing a ResourcePool resource.
40
- :param pulumi.Input[builtins.str] parent_resource_pool_id: The ID of the root resource pool of the compute resource the resource pool is in.
41
- :param pulumi.Input[builtins.bool] cpu_expandable: Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has
42
- unreserved resources.
43
- :param pulumi.Input[builtins.int] cpu_limit: The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for
44
- unlimited.
45
- :param pulumi.Input[builtins.int] cpu_reservation: Amount of CPU (MHz) that is guaranteed available to the resource pool.
46
- :param pulumi.Input[builtins.str] cpu_share_level: The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for
47
- shares. Can be one of low, normal, high, or custom.
48
- :param pulumi.Input[builtins.int] cpu_shares: The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set,
49
- cpu_share_level must be custom.
40
+ :param pulumi.Input[builtins.str] parent_resource_pool_id: The managed object ID
41
+ of the parent resource pool. This can be the root resource pool for a cluster
42
+ or standalone host, or a resource pool itself. When moving a resource pool
43
+ from one parent resource pool to another, both must share a common root
44
+ resource pool.
45
+ :param pulumi.Input[builtins.bool] cpu_expandable: Determines if the reservation on a resource
46
+ pool can grow beyond the specified value if the parent resource pool has
47
+ unreserved resources. Default: `true`
48
+ :param pulumi.Input[builtins.int] cpu_limit: The CPU utilization of a resource pool will not
49
+ exceed this limit, even if there are available resources. Set to `-1` for
50
+ unlimited. Default: `-1`
51
+ :param pulumi.Input[builtins.int] cpu_reservation: Amount of CPU (MHz) that is guaranteed
52
+ available to the resource pool. Default: `0`
53
+ :param pulumi.Input[builtins.str] cpu_share_level: The CPU allocation level. The level is a
54
+ simplified view of shares. Levels map to a pre-determined set of numeric
55
+ values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When
56
+ `low`, `normal`, or `high` are specified values in `cpu_shares` will be
57
+ ignored. Default: `normal`
58
+ :param pulumi.Input[builtins.int] cpu_shares: The number of shares allocated for CPU. Used to
59
+ determine resource allocation in case of resource contention. If this is set,
60
+ `cpu_share_level` must be `custom`.
50
61
  :param pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]] custom_attributes: A list of custom attributes to set on this resource.
51
- :param pulumi.Input[builtins.bool] memory_expandable: Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has
52
- unreserved resources.
53
- :param pulumi.Input[builtins.int] memory_limit: The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for
54
- unlimited.
55
- :param pulumi.Input[builtins.int] memory_reservation: Amount of memory (MB) that is guaranteed available to the resource pool.
56
- :param pulumi.Input[builtins.str] memory_share_level: The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for
57
- shares. Can be one of low, normal, high, or custom.
58
- :param pulumi.Input[builtins.int] memory_shares: The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set,
59
- memory_share_level must be custom.
60
- :param pulumi.Input[builtins.str] name: Name of resource pool.
61
- :param pulumi.Input[builtins.str] scale_descendants_shares: Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource
62
- pool are scaled up or down.
63
- :param pulumi.Input[Sequence[pulumi.Input[builtins.str]]] tags: A list of tag IDs to apply to this object.
62
+ :param pulumi.Input[builtins.bool] memory_expandable: Determines if the reservation on a resource
63
+ pool can grow beyond the specified value if the parent resource pool has
64
+ unreserved resources. Default: `true`
65
+ :param pulumi.Input[builtins.int] memory_limit: The CPU utilization of a resource pool will not
66
+ exceed this limit, even if there are available resources. Set to `-1` for
67
+ unlimited. Default: `-1`
68
+ :param pulumi.Input[builtins.int] memory_reservation: Amount of CPU (MHz) that is guaranteed
69
+ available to the resource pool. Default: `0`
70
+ :param pulumi.Input[builtins.str] memory_share_level: The CPU allocation level. The level is a
71
+ simplified view of shares. Levels map to a pre-determined set of numeric
72
+ values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When
73
+ `low`, `normal`, or `high` are specified values in `memory_shares` will be
74
+ ignored. Default: `normal`
75
+ :param pulumi.Input[builtins.int] memory_shares: The number of shares allocated for CPU. Used to
76
+ determine resource allocation in case of resource contention. If this is set,
77
+ `memory_share_level` must be `custom`.
78
+ :param pulumi.Input[builtins.str] name: The name of the resource pool.
79
+ :param pulumi.Input[builtins.str] scale_descendants_shares: Determines if the shares of all
80
+ descendants of the resource pool are scaled up or down when the shares
81
+ of the resource pool are scaled up or down. Can be one of `disabled` or
82
+ `scaleCpuAndMemoryShares`. Default: `disabled`.
83
+ :param pulumi.Input[Sequence[pulumi.Input[builtins.str]]] tags: The IDs of any tags to attach to this resource.
64
84
  """
65
85
  pulumi.set(__self__, "parent_resource_pool_id", parent_resource_pool_id)
66
86
  if cpu_expandable is not None:
@@ -96,7 +116,11 @@ class ResourcePoolArgs:
96
116
  @pulumi.getter(name="parentResourcePoolId")
97
117
  def parent_resource_pool_id(self) -> pulumi.Input[builtins.str]:
98
118
  """
99
- The ID of the root resource pool of the compute resource the resource pool is in.
119
+ The managed object ID
120
+ of the parent resource pool. This can be the root resource pool for a cluster
121
+ or standalone host, or a resource pool itself. When moving a resource pool
122
+ from one parent resource pool to another, both must share a common root
123
+ resource pool.
100
124
  """
101
125
  return pulumi.get(self, "parent_resource_pool_id")
102
126
 
@@ -108,8 +132,9 @@ class ResourcePoolArgs:
108
132
  @pulumi.getter(name="cpuExpandable")
109
133
  def cpu_expandable(self) -> Optional[pulumi.Input[builtins.bool]]:
110
134
  """
111
- Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has
112
- unreserved resources.
135
+ Determines if the reservation on a resource
136
+ pool can grow beyond the specified value if the parent resource pool has
137
+ unreserved resources. Default: `true`
113
138
  """
114
139
  return pulumi.get(self, "cpu_expandable")
115
140
 
@@ -121,8 +146,9 @@ class ResourcePoolArgs:
121
146
  @pulumi.getter(name="cpuLimit")
122
147
  def cpu_limit(self) -> Optional[pulumi.Input[builtins.int]]:
123
148
  """
124
- The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for
125
- unlimited.
149
+ The CPU utilization of a resource pool will not
150
+ exceed this limit, even if there are available resources. Set to `-1` for
151
+ unlimited. Default: `-1`
126
152
  """
127
153
  return pulumi.get(self, "cpu_limit")
128
154
 
@@ -134,7 +160,8 @@ class ResourcePoolArgs:
134
160
  @pulumi.getter(name="cpuReservation")
135
161
  def cpu_reservation(self) -> Optional[pulumi.Input[builtins.int]]:
136
162
  """
137
- Amount of CPU (MHz) that is guaranteed available to the resource pool.
163
+ Amount of CPU (MHz) that is guaranteed
164
+ available to the resource pool. Default: `0`
138
165
  """
139
166
  return pulumi.get(self, "cpu_reservation")
140
167
 
@@ -146,8 +173,11 @@ class ResourcePoolArgs:
146
173
  @pulumi.getter(name="cpuShareLevel")
147
174
  def cpu_share_level(self) -> Optional[pulumi.Input[builtins.str]]:
148
175
  """
149
- The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for
150
- shares. Can be one of low, normal, high, or custom.
176
+ The CPU allocation level. The level is a
177
+ simplified view of shares. Levels map to a pre-determined set of numeric
178
+ values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When
179
+ `low`, `normal`, or `high` are specified values in `cpu_shares` will be
180
+ ignored. Default: `normal`
151
181
  """
152
182
  return pulumi.get(self, "cpu_share_level")
153
183
 
@@ -159,8 +189,9 @@ class ResourcePoolArgs:
159
189
  @pulumi.getter(name="cpuShares")
160
190
  def cpu_shares(self) -> Optional[pulumi.Input[builtins.int]]:
161
191
  """
162
- The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set,
163
- cpu_share_level must be custom.
192
+ The number of shares allocated for CPU. Used to
193
+ determine resource allocation in case of resource contention. If this is set,
194
+ `cpu_share_level` must be `custom`.
164
195
  """
165
196
  return pulumi.get(self, "cpu_shares")
166
197
 
@@ -184,8 +215,9 @@ class ResourcePoolArgs:
184
215
  @pulumi.getter(name="memoryExpandable")
185
216
  def memory_expandable(self) -> Optional[pulumi.Input[builtins.bool]]:
186
217
  """
187
- Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has
188
- unreserved resources.
218
+ Determines if the reservation on a resource
219
+ pool can grow beyond the specified value if the parent resource pool has
220
+ unreserved resources. Default: `true`
189
221
  """
190
222
  return pulumi.get(self, "memory_expandable")
191
223
 
@@ -197,8 +229,9 @@ class ResourcePoolArgs:
197
229
  @pulumi.getter(name="memoryLimit")
198
230
  def memory_limit(self) -> Optional[pulumi.Input[builtins.int]]:
199
231
  """
200
- The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for
201
- unlimited.
232
+ The CPU utilization of a resource pool will not
233
+ exceed this limit, even if there are available resources. Set to `-1` for
234
+ unlimited. Default: `-1`
202
235
  """
203
236
  return pulumi.get(self, "memory_limit")
204
237
 
@@ -210,7 +243,8 @@ class ResourcePoolArgs:
210
243
  @pulumi.getter(name="memoryReservation")
211
244
  def memory_reservation(self) -> Optional[pulumi.Input[builtins.int]]:
212
245
  """
213
- Amount of memory (MB) that is guaranteed available to the resource pool.
246
+ Amount of CPU (MHz) that is guaranteed
247
+ available to the resource pool. Default: `0`
214
248
  """
215
249
  return pulumi.get(self, "memory_reservation")
216
250
 
@@ -222,8 +256,11 @@ class ResourcePoolArgs:
222
256
  @pulumi.getter(name="memoryShareLevel")
223
257
  def memory_share_level(self) -> Optional[pulumi.Input[builtins.str]]:
224
258
  """
225
- The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for
226
- shares. Can be one of low, normal, high, or custom.
259
+ The CPU allocation level. The level is a
260
+ simplified view of shares. Levels map to a pre-determined set of numeric
261
+ values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When
262
+ `low`, `normal`, or `high` are specified values in `memory_shares` will be
263
+ ignored. Default: `normal`
227
264
  """
228
265
  return pulumi.get(self, "memory_share_level")
229
266
 
@@ -235,8 +272,9 @@ class ResourcePoolArgs:
235
272
  @pulumi.getter(name="memoryShares")
236
273
  def memory_shares(self) -> Optional[pulumi.Input[builtins.int]]:
237
274
  """
238
- The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set,
239
- memory_share_level must be custom.
275
+ The number of shares allocated for CPU. Used to
276
+ determine resource allocation in case of resource contention. If this is set,
277
+ `memory_share_level` must be `custom`.
240
278
  """
241
279
  return pulumi.get(self, "memory_shares")
242
280
 
@@ -248,7 +286,7 @@ class ResourcePoolArgs:
248
286
  @pulumi.getter
249
287
  def name(self) -> Optional[pulumi.Input[builtins.str]]:
250
288
  """
251
- Name of resource pool.
289
+ The name of the resource pool.
252
290
  """
253
291
  return pulumi.get(self, "name")
254
292
 
@@ -260,8 +298,10 @@ class ResourcePoolArgs:
260
298
  @pulumi.getter(name="scaleDescendantsShares")
261
299
  def scale_descendants_shares(self) -> Optional[pulumi.Input[builtins.str]]:
262
300
  """
263
- Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource
264
- pool are scaled up or down.
301
+ Determines if the shares of all
302
+ descendants of the resource pool are scaled up or down when the shares
303
+ of the resource pool are scaled up or down. Can be one of `disabled` or
304
+ `scaleCpuAndMemoryShares`. Default: `disabled`.
265
305
  """
266
306
  return pulumi.get(self, "scale_descendants_shares")
267
307
 
@@ -273,7 +313,7 @@ class ResourcePoolArgs:
273
313
  @pulumi.getter
274
314
  def tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[builtins.str]]]]:
275
315
  """
276
- A list of tag IDs to apply to this object.
316
+ The IDs of any tags to attach to this resource.
277
317
  """
278
318
  return pulumi.get(self, "tags")
279
319
 
@@ -302,30 +342,50 @@ class _ResourcePoolState:
302
342
  tags: Optional[pulumi.Input[Sequence[pulumi.Input[builtins.str]]]] = None):
303
343
  """
304
344
  Input properties used for looking up and filtering ResourcePool resources.
305
- :param pulumi.Input[builtins.bool] cpu_expandable: Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has
306
- unreserved resources.
307
- :param pulumi.Input[builtins.int] cpu_limit: The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for
308
- unlimited.
309
- :param pulumi.Input[builtins.int] cpu_reservation: Amount of CPU (MHz) that is guaranteed available to the resource pool.
310
- :param pulumi.Input[builtins.str] cpu_share_level: The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for
311
- shares. Can be one of low, normal, high, or custom.
312
- :param pulumi.Input[builtins.int] cpu_shares: The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set,
313
- cpu_share_level must be custom.
345
+ :param pulumi.Input[builtins.bool] cpu_expandable: Determines if the reservation on a resource
346
+ pool can grow beyond the specified value if the parent resource pool has
347
+ unreserved resources. Default: `true`
348
+ :param pulumi.Input[builtins.int] cpu_limit: The CPU utilization of a resource pool will not
349
+ exceed this limit, even if there are available resources. Set to `-1` for
350
+ unlimited. Default: `-1`
351
+ :param pulumi.Input[builtins.int] cpu_reservation: Amount of CPU (MHz) that is guaranteed
352
+ available to the resource pool. Default: `0`
353
+ :param pulumi.Input[builtins.str] cpu_share_level: The CPU allocation level. The level is a
354
+ simplified view of shares. Levels map to a pre-determined set of numeric
355
+ values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When
356
+ `low`, `normal`, or `high` are specified values in `cpu_shares` will be
357
+ ignored. Default: `normal`
358
+ :param pulumi.Input[builtins.int] cpu_shares: The number of shares allocated for CPU. Used to
359
+ determine resource allocation in case of resource contention. If this is set,
360
+ `cpu_share_level` must be `custom`.
314
361
  :param pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]] custom_attributes: A list of custom attributes to set on this resource.
315
- :param pulumi.Input[builtins.bool] memory_expandable: Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has
316
- unreserved resources.
317
- :param pulumi.Input[builtins.int] memory_limit: The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for
318
- unlimited.
319
- :param pulumi.Input[builtins.int] memory_reservation: Amount of memory (MB) that is guaranteed available to the resource pool.
320
- :param pulumi.Input[builtins.str] memory_share_level: The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for
321
- shares. Can be one of low, normal, high, or custom.
322
- :param pulumi.Input[builtins.int] memory_shares: The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set,
323
- memory_share_level must be custom.
324
- :param pulumi.Input[builtins.str] name: Name of resource pool.
325
- :param pulumi.Input[builtins.str] parent_resource_pool_id: The ID of the root resource pool of the compute resource the resource pool is in.
326
- :param pulumi.Input[builtins.str] scale_descendants_shares: Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource
327
- pool are scaled up or down.
328
- :param pulumi.Input[Sequence[pulumi.Input[builtins.str]]] tags: A list of tag IDs to apply to this object.
362
+ :param pulumi.Input[builtins.bool] memory_expandable: Determines if the reservation on a resource
363
+ pool can grow beyond the specified value if the parent resource pool has
364
+ unreserved resources. Default: `true`
365
+ :param pulumi.Input[builtins.int] memory_limit: The CPU utilization of a resource pool will not
366
+ exceed this limit, even if there are available resources. Set to `-1` for
367
+ unlimited. Default: `-1`
368
+ :param pulumi.Input[builtins.int] memory_reservation: Amount of CPU (MHz) that is guaranteed
369
+ available to the resource pool. Default: `0`
370
+ :param pulumi.Input[builtins.str] memory_share_level: The CPU allocation level. The level is a
371
+ simplified view of shares. Levels map to a pre-determined set of numeric
372
+ values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When
373
+ `low`, `normal`, or `high` are specified values in `memory_shares` will be
374
+ ignored. Default: `normal`
375
+ :param pulumi.Input[builtins.int] memory_shares: The number of shares allocated for CPU. Used to
376
+ determine resource allocation in case of resource contention. If this is set,
377
+ `memory_share_level` must be `custom`.
378
+ :param pulumi.Input[builtins.str] name: The name of the resource pool.
379
+ :param pulumi.Input[builtins.str] parent_resource_pool_id: The managed object ID
380
+ of the parent resource pool. This can be the root resource pool for a cluster
381
+ or standalone host, or a resource pool itself. When moving a resource pool
382
+ from one parent resource pool to another, both must share a common root
383
+ resource pool.
384
+ :param pulumi.Input[builtins.str] scale_descendants_shares: Determines if the shares of all
385
+ descendants of the resource pool are scaled up or down when the shares
386
+ of the resource pool are scaled up or down. Can be one of `disabled` or
387
+ `scaleCpuAndMemoryShares`. Default: `disabled`.
388
+ :param pulumi.Input[Sequence[pulumi.Input[builtins.str]]] tags: The IDs of any tags to attach to this resource.
329
389
  """
330
390
  if cpu_expandable is not None:
331
391
  pulumi.set(__self__, "cpu_expandable", cpu_expandable)
@@ -362,8 +422,9 @@ class _ResourcePoolState:
362
422
  @pulumi.getter(name="cpuExpandable")
363
423
  def cpu_expandable(self) -> Optional[pulumi.Input[builtins.bool]]:
364
424
  """
365
- Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has
366
- unreserved resources.
425
+ Determines if the reservation on a resource
426
+ pool can grow beyond the specified value if the parent resource pool has
427
+ unreserved resources. Default: `true`
367
428
  """
368
429
  return pulumi.get(self, "cpu_expandable")
369
430
 
@@ -375,8 +436,9 @@ class _ResourcePoolState:
375
436
  @pulumi.getter(name="cpuLimit")
376
437
  def cpu_limit(self) -> Optional[pulumi.Input[builtins.int]]:
377
438
  """
378
- The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for
379
- unlimited.
439
+ The CPU utilization of a resource pool will not
440
+ exceed this limit, even if there are available resources. Set to `-1` for
441
+ unlimited. Default: `-1`
380
442
  """
381
443
  return pulumi.get(self, "cpu_limit")
382
444
 
@@ -388,7 +450,8 @@ class _ResourcePoolState:
388
450
  @pulumi.getter(name="cpuReservation")
389
451
  def cpu_reservation(self) -> Optional[pulumi.Input[builtins.int]]:
390
452
  """
391
- Amount of CPU (MHz) that is guaranteed available to the resource pool.
453
+ Amount of CPU (MHz) that is guaranteed
454
+ available to the resource pool. Default: `0`
392
455
  """
393
456
  return pulumi.get(self, "cpu_reservation")
394
457
 
@@ -400,8 +463,11 @@ class _ResourcePoolState:
400
463
  @pulumi.getter(name="cpuShareLevel")
401
464
  def cpu_share_level(self) -> Optional[pulumi.Input[builtins.str]]:
402
465
  """
403
- The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for
404
- shares. Can be one of low, normal, high, or custom.
466
+ The CPU allocation level. The level is a
467
+ simplified view of shares. Levels map to a pre-determined set of numeric
468
+ values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When
469
+ `low`, `normal`, or `high` are specified values in `cpu_shares` will be
470
+ ignored. Default: `normal`
405
471
  """
406
472
  return pulumi.get(self, "cpu_share_level")
407
473
 
@@ -413,8 +479,9 @@ class _ResourcePoolState:
413
479
  @pulumi.getter(name="cpuShares")
414
480
  def cpu_shares(self) -> Optional[pulumi.Input[builtins.int]]:
415
481
  """
416
- The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set,
417
- cpu_share_level must be custom.
482
+ The number of shares allocated for CPU. Used to
483
+ determine resource allocation in case of resource contention. If this is set,
484
+ `cpu_share_level` must be `custom`.
418
485
  """
419
486
  return pulumi.get(self, "cpu_shares")
420
487
 
@@ -438,8 +505,9 @@ class _ResourcePoolState:
438
505
  @pulumi.getter(name="memoryExpandable")
439
506
  def memory_expandable(self) -> Optional[pulumi.Input[builtins.bool]]:
440
507
  """
441
- Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has
442
- unreserved resources.
508
+ Determines if the reservation on a resource
509
+ pool can grow beyond the specified value if the parent resource pool has
510
+ unreserved resources. Default: `true`
443
511
  """
444
512
  return pulumi.get(self, "memory_expandable")
445
513
 
@@ -451,8 +519,9 @@ class _ResourcePoolState:
451
519
  @pulumi.getter(name="memoryLimit")
452
520
  def memory_limit(self) -> Optional[pulumi.Input[builtins.int]]:
453
521
  """
454
- The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for
455
- unlimited.
522
+ The CPU utilization of a resource pool will not
523
+ exceed this limit, even if there are available resources. Set to `-1` for
524
+ unlimited. Default: `-1`
456
525
  """
457
526
  return pulumi.get(self, "memory_limit")
458
527
 
@@ -464,7 +533,8 @@ class _ResourcePoolState:
464
533
  @pulumi.getter(name="memoryReservation")
465
534
  def memory_reservation(self) -> Optional[pulumi.Input[builtins.int]]:
466
535
  """
467
- Amount of memory (MB) that is guaranteed available to the resource pool.
536
+ Amount of CPU (MHz) that is guaranteed
537
+ available to the resource pool. Default: `0`
468
538
  """
469
539
  return pulumi.get(self, "memory_reservation")
470
540
 
@@ -476,8 +546,11 @@ class _ResourcePoolState:
476
546
  @pulumi.getter(name="memoryShareLevel")
477
547
  def memory_share_level(self) -> Optional[pulumi.Input[builtins.str]]:
478
548
  """
479
- The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for
480
- shares. Can be one of low, normal, high, or custom.
549
+ The CPU allocation level. The level is a
550
+ simplified view of shares. Levels map to a pre-determined set of numeric
551
+ values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When
552
+ `low`, `normal`, or `high` are specified values in `memory_shares` will be
553
+ ignored. Default: `normal`
481
554
  """
482
555
  return pulumi.get(self, "memory_share_level")
483
556
 
@@ -489,8 +562,9 @@ class _ResourcePoolState:
489
562
  @pulumi.getter(name="memoryShares")
490
563
  def memory_shares(self) -> Optional[pulumi.Input[builtins.int]]:
491
564
  """
492
- The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set,
493
- memory_share_level must be custom.
565
+ The number of shares allocated for CPU. Used to
566
+ determine resource allocation in case of resource contention. If this is set,
567
+ `memory_share_level` must be `custom`.
494
568
  """
495
569
  return pulumi.get(self, "memory_shares")
496
570
 
@@ -502,7 +576,7 @@ class _ResourcePoolState:
502
576
  @pulumi.getter
503
577
  def name(self) -> Optional[pulumi.Input[builtins.str]]:
504
578
  """
505
- Name of resource pool.
579
+ The name of the resource pool.
506
580
  """
507
581
  return pulumi.get(self, "name")
508
582
 
@@ -514,7 +588,11 @@ class _ResourcePoolState:
514
588
  @pulumi.getter(name="parentResourcePoolId")
515
589
  def parent_resource_pool_id(self) -> Optional[pulumi.Input[builtins.str]]:
516
590
  """
517
- The ID of the root resource pool of the compute resource the resource pool is in.
591
+ The managed object ID
592
+ of the parent resource pool. This can be the root resource pool for a cluster
593
+ or standalone host, or a resource pool itself. When moving a resource pool
594
+ from one parent resource pool to another, both must share a common root
595
+ resource pool.
518
596
  """
519
597
  return pulumi.get(self, "parent_resource_pool_id")
520
598
 
@@ -526,8 +604,10 @@ class _ResourcePoolState:
526
604
  @pulumi.getter(name="scaleDescendantsShares")
527
605
  def scale_descendants_shares(self) -> Optional[pulumi.Input[builtins.str]]:
528
606
  """
529
- Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource
530
- pool are scaled up or down.
607
+ Determines if the shares of all
608
+ descendants of the resource pool are scaled up or down when the shares
609
+ of the resource pool are scaled up or down. Can be one of `disabled` or
610
+ `scaleCpuAndMemoryShares`. Default: `disabled`.
531
611
  """
532
612
  return pulumi.get(self, "scale_descendants_shares")
533
613
 
@@ -539,7 +619,7 @@ class _ResourcePoolState:
539
619
  @pulumi.getter
540
620
  def tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[builtins.str]]]]:
541
621
  """
542
- A list of tag IDs to apply to this object.
622
+ The IDs of any tags to attach to this resource.
543
623
  """
544
624
  return pulumi.get(self, "tags")
545
625
 
@@ -571,33 +651,146 @@ class ResourcePool(pulumi.CustomResource):
571
651
  tags: Optional[pulumi.Input[Sequence[pulumi.Input[builtins.str]]]] = None,
572
652
  __props__=None):
573
653
  """
574
- Create a ResourcePool resource with the given unique name, props, and options.
654
+ The `ResourcePool` resource can be used to create and manage
655
+ resource pools on DRS-enabled vSphere clusters or standalone ESXi hosts.
656
+
657
+ For more information on vSphere resource pools, please refer to the
658
+ [product documentation][ref-vsphere-resource_pools].
659
+
660
+ [ref-vsphere-resource_pools]: https://techdocs.broadcom.com/us/en/vmware-cis/vsphere/vsphere/8-0/vsphere-resource-management-8-0/managing-resource-pools.html
661
+
662
+ ## Example Usage
663
+
664
+ The following example sets up a resource pool in an existing compute cluster
665
+ with the default settings for CPU and memory reservations, shares, and limits.
666
+
667
+ ```python
668
+ import pulumi
669
+ import pulumi_vsphere as vsphere
670
+
671
+ datacenter = vsphere.get_datacenter(name="dc-01")
672
+ compute_cluster = vsphere.get_compute_cluster(name="cluster-01",
673
+ datacenter_id=datacenter.id)
674
+ resource_pool = vsphere.ResourcePool("resource_pool",
675
+ name="resource-pool-01",
676
+ parent_resource_pool_id=compute_cluster.resource_pool_id)
677
+ ```
678
+
679
+ A virtual machine resource could be targeted to use the default resource pool
680
+ of the cluster using the following:
681
+
682
+ ```python
683
+ import pulumi
684
+ import pulumi_vsphere as vsphere
685
+
686
+ vm = vsphere.VirtualMachine("vm", resource_pool_id=cluster["resourcePoolId"])
687
+ ```
688
+
689
+ The following example sets up a parent resource pool in an existing compute cluster
690
+ with a child resource pool nested below. Each resource pool is configured with
691
+ the default settings for CPU and memory reservations, shares, and limits.
692
+
693
+ ```python
694
+ import pulumi
695
+ import pulumi_vsphere as vsphere
696
+
697
+ datacenter = vsphere.get_datacenter(name="dc-01")
698
+ compute_cluster = vsphere.get_compute_cluster(name="cluster-01",
699
+ datacenter_id=datacenter.id)
700
+ resource_pool_parent = vsphere.ResourcePool("resource_pool_parent",
701
+ name="parent",
702
+ parent_resource_pool_id=compute_cluster.resource_pool_id)
703
+ resource_pool_child = vsphere.ResourcePool("resource_pool_child",
704
+ name="child",
705
+ parent_resource_pool_id=resource_pool_parent.id)
706
+ ```
707
+
708
+ The following example set up a parent resource pool on a standalone ESXi host with the default
709
+ settings for CPU and memory reservations, shares, and limits.
710
+
711
+ ```python
712
+ import pulumi
713
+ import pulumi_vsphere as vsphere
714
+
715
+ datacenter = vsphere.get_datacenter(name="dc-01")
716
+ thumbprint = vsphere.get_host_thumbprint(address="esxi-01.example.com",
717
+ insecure=True)
718
+ esx_01 = vsphere.Host("esx-01",
719
+ hostname="esxi-01.example.com",
720
+ username="root",
721
+ password="password",
722
+ license="00000-00000-00000-00000-00000",
723
+ thumbprint=thumbprint.id,
724
+ datacenter=datacenter.id)
725
+ ```
726
+
727
+ After the hosts are added to the datacenter, a resource pool can then be created on the host.
728
+
729
+ ```python
730
+ import pulumi
731
+ import pulumi_vsphere as vsphere
732
+
733
+ host = vsphere.get_host(name="esxi-01.example.com",
734
+ datacenter_id=datacenter["id"])
735
+ resource_pool = vsphere.ResourcePool("resource_pool",
736
+ name="site1-resource-pool",
737
+ parent_resource_pool_id=host.resource_pool_id)
738
+ ```
739
+
740
+ ## Import
741
+
742
+ ### Settings that Require vSphere 7.0 or higher
743
+
744
+ These settings require vSphere 7.0 or higher:
745
+
746
+ * [`scale_descendants_shares`](#scale_descendants_shares)
747
+
575
748
  :param str resource_name: The name of the resource.
576
749
  :param pulumi.ResourceOptions opts: Options for the resource.
577
- :param pulumi.Input[builtins.bool] cpu_expandable: Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has
578
- unreserved resources.
579
- :param pulumi.Input[builtins.int] cpu_limit: The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for
580
- unlimited.
581
- :param pulumi.Input[builtins.int] cpu_reservation: Amount of CPU (MHz) that is guaranteed available to the resource pool.
582
- :param pulumi.Input[builtins.str] cpu_share_level: The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for
583
- shares. Can be one of low, normal, high, or custom.
584
- :param pulumi.Input[builtins.int] cpu_shares: The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set,
585
- cpu_share_level must be custom.
750
+ :param pulumi.Input[builtins.bool] cpu_expandable: Determines if the reservation on a resource
751
+ pool can grow beyond the specified value if the parent resource pool has
752
+ unreserved resources. Default: `true`
753
+ :param pulumi.Input[builtins.int] cpu_limit: The CPU utilization of a resource pool will not
754
+ exceed this limit, even if there are available resources. Set to `-1` for
755
+ unlimited. Default: `-1`
756
+ :param pulumi.Input[builtins.int] cpu_reservation: Amount of CPU (MHz) that is guaranteed
757
+ available to the resource pool. Default: `0`
758
+ :param pulumi.Input[builtins.str] cpu_share_level: The CPU allocation level. The level is a
759
+ simplified view of shares. Levels map to a pre-determined set of numeric
760
+ values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When
761
+ `low`, `normal`, or `high` are specified values in `cpu_shares` will be
762
+ ignored. Default: `normal`
763
+ :param pulumi.Input[builtins.int] cpu_shares: The number of shares allocated for CPU. Used to
764
+ determine resource allocation in case of resource contention. If this is set,
765
+ `cpu_share_level` must be `custom`.
586
766
  :param pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]] custom_attributes: A list of custom attributes to set on this resource.
587
- :param pulumi.Input[builtins.bool] memory_expandable: Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has
588
- unreserved resources.
589
- :param pulumi.Input[builtins.int] memory_limit: The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for
590
- unlimited.
591
- :param pulumi.Input[builtins.int] memory_reservation: Amount of memory (MB) that is guaranteed available to the resource pool.
592
- :param pulumi.Input[builtins.str] memory_share_level: The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for
593
- shares. Can be one of low, normal, high, or custom.
594
- :param pulumi.Input[builtins.int] memory_shares: The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set,
595
- memory_share_level must be custom.
596
- :param pulumi.Input[builtins.str] name: Name of resource pool.
597
- :param pulumi.Input[builtins.str] parent_resource_pool_id: The ID of the root resource pool of the compute resource the resource pool is in.
598
- :param pulumi.Input[builtins.str] scale_descendants_shares: Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource
599
- pool are scaled up or down.
600
- :param pulumi.Input[Sequence[pulumi.Input[builtins.str]]] tags: A list of tag IDs to apply to this object.
767
+ :param pulumi.Input[builtins.bool] memory_expandable: Determines if the reservation on a resource
768
+ pool can grow beyond the specified value if the parent resource pool has
769
+ unreserved resources. Default: `true`
770
+ :param pulumi.Input[builtins.int] memory_limit: The CPU utilization of a resource pool will not
771
+ exceed this limit, even if there are available resources. Set to `-1` for
772
+ unlimited. Default: `-1`
773
+ :param pulumi.Input[builtins.int] memory_reservation: Amount of CPU (MHz) that is guaranteed
774
+ available to the resource pool. Default: `0`
775
+ :param pulumi.Input[builtins.str] memory_share_level: The CPU allocation level. The level is a
776
+ simplified view of shares. Levels map to a pre-determined set of numeric
777
+ values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When
778
+ `low`, `normal`, or `high` are specified values in `memory_shares` will be
779
+ ignored. Default: `normal`
780
+ :param pulumi.Input[builtins.int] memory_shares: The number of shares allocated for CPU. Used to
781
+ determine resource allocation in case of resource contention. If this is set,
782
+ `memory_share_level` must be `custom`.
783
+ :param pulumi.Input[builtins.str] name: The name of the resource pool.
784
+ :param pulumi.Input[builtins.str] parent_resource_pool_id: The managed object ID
785
+ of the parent resource pool. This can be the root resource pool for a cluster
786
+ or standalone host, or a resource pool itself. When moving a resource pool
787
+ from one parent resource pool to another, both must share a common root
788
+ resource pool.
789
+ :param pulumi.Input[builtins.str] scale_descendants_shares: Determines if the shares of all
790
+ descendants of the resource pool are scaled up or down when the shares
791
+ of the resource pool are scaled up or down. Can be one of `disabled` or
792
+ `scaleCpuAndMemoryShares`. Default: `disabled`.
793
+ :param pulumi.Input[Sequence[pulumi.Input[builtins.str]]] tags: The IDs of any tags to attach to this resource.
601
794
  """
602
795
  ...
603
796
  @overload
@@ -606,7 +799,100 @@ class ResourcePool(pulumi.CustomResource):
606
799
  args: ResourcePoolArgs,
607
800
  opts: Optional[pulumi.ResourceOptions] = None):
608
801
  """
609
- Create a ResourcePool resource with the given unique name, props, and options.
802
+ The `ResourcePool` resource can be used to create and manage
803
+ resource pools on DRS-enabled vSphere clusters or standalone ESXi hosts.
804
+
805
+ For more information on vSphere resource pools, please refer to the
806
+ [product documentation][ref-vsphere-resource_pools].
807
+
808
+ [ref-vsphere-resource_pools]: https://techdocs.broadcom.com/us/en/vmware-cis/vsphere/vsphere/8-0/vsphere-resource-management-8-0/managing-resource-pools.html
809
+
810
+ ## Example Usage
811
+
812
+ The following example sets up a resource pool in an existing compute cluster
813
+ with the default settings for CPU and memory reservations, shares, and limits.
814
+
815
+ ```python
816
+ import pulumi
817
+ import pulumi_vsphere as vsphere
818
+
819
+ datacenter = vsphere.get_datacenter(name="dc-01")
820
+ compute_cluster = vsphere.get_compute_cluster(name="cluster-01",
821
+ datacenter_id=datacenter.id)
822
+ resource_pool = vsphere.ResourcePool("resource_pool",
823
+ name="resource-pool-01",
824
+ parent_resource_pool_id=compute_cluster.resource_pool_id)
825
+ ```
826
+
827
+ A virtual machine resource could be targeted to use the default resource pool
828
+ of the cluster using the following:
829
+
830
+ ```python
831
+ import pulumi
832
+ import pulumi_vsphere as vsphere
833
+
834
+ vm = vsphere.VirtualMachine("vm", resource_pool_id=cluster["resourcePoolId"])
835
+ ```
836
+
837
+ The following example sets up a parent resource pool in an existing compute cluster
838
+ with a child resource pool nested below. Each resource pool is configured with
839
+ the default settings for CPU and memory reservations, shares, and limits.
840
+
841
+ ```python
842
+ import pulumi
843
+ import pulumi_vsphere as vsphere
844
+
845
+ datacenter = vsphere.get_datacenter(name="dc-01")
846
+ compute_cluster = vsphere.get_compute_cluster(name="cluster-01",
847
+ datacenter_id=datacenter.id)
848
+ resource_pool_parent = vsphere.ResourcePool("resource_pool_parent",
849
+ name="parent",
850
+ parent_resource_pool_id=compute_cluster.resource_pool_id)
851
+ resource_pool_child = vsphere.ResourcePool("resource_pool_child",
852
+ name="child",
853
+ parent_resource_pool_id=resource_pool_parent.id)
854
+ ```
855
+
856
+ The following example set up a parent resource pool on a standalone ESXi host with the default
857
+ settings for CPU and memory reservations, shares, and limits.
858
+
859
+ ```python
860
+ import pulumi
861
+ import pulumi_vsphere as vsphere
862
+
863
+ datacenter = vsphere.get_datacenter(name="dc-01")
864
+ thumbprint = vsphere.get_host_thumbprint(address="esxi-01.example.com",
865
+ insecure=True)
866
+ esx_01 = vsphere.Host("esx-01",
867
+ hostname="esxi-01.example.com",
868
+ username="root",
869
+ password="password",
870
+ license="00000-00000-00000-00000-00000",
871
+ thumbprint=thumbprint.id,
872
+ datacenter=datacenter.id)
873
+ ```
874
+
875
+ After the hosts are added to the datacenter, a resource pool can then be created on the host.
876
+
877
+ ```python
878
+ import pulumi
879
+ import pulumi_vsphere as vsphere
880
+
881
+ host = vsphere.get_host(name="esxi-01.example.com",
882
+ datacenter_id=datacenter["id"])
883
+ resource_pool = vsphere.ResourcePool("resource_pool",
884
+ name="site1-resource-pool",
885
+ parent_resource_pool_id=host.resource_pool_id)
886
+ ```
887
+
888
+ ## Import
889
+
890
+ ### Settings that Require vSphere 7.0 or higher
891
+
892
+ These settings require vSphere 7.0 or higher:
893
+
894
+ * [`scale_descendants_shares`](#scale_descendants_shares)
895
+
610
896
  :param str resource_name: The name of the resource.
611
897
  :param ResourcePoolArgs args: The arguments to use to populate this resource's properties.
612
898
  :param pulumi.ResourceOptions opts: Options for the resource.
@@ -695,30 +981,50 @@ class ResourcePool(pulumi.CustomResource):
695
981
  :param str resource_name: The unique name of the resulting resource.
696
982
  :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
697
983
  :param pulumi.ResourceOptions opts: Options for the resource.
698
- :param pulumi.Input[builtins.bool] cpu_expandable: Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has
699
- unreserved resources.
700
- :param pulumi.Input[builtins.int] cpu_limit: The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for
701
- unlimited.
702
- :param pulumi.Input[builtins.int] cpu_reservation: Amount of CPU (MHz) that is guaranteed available to the resource pool.
703
- :param pulumi.Input[builtins.str] cpu_share_level: The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for
704
- shares. Can be one of low, normal, high, or custom.
705
- :param pulumi.Input[builtins.int] cpu_shares: The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set,
706
- cpu_share_level must be custom.
984
+ :param pulumi.Input[builtins.bool] cpu_expandable: Determines if the reservation on a resource
985
+ pool can grow beyond the specified value if the parent resource pool has
986
+ unreserved resources. Default: `true`
987
+ :param pulumi.Input[builtins.int] cpu_limit: The CPU utilization of a resource pool will not
988
+ exceed this limit, even if there are available resources. Set to `-1` for
989
+ unlimited. Default: `-1`
990
+ :param pulumi.Input[builtins.int] cpu_reservation: Amount of CPU (MHz) that is guaranteed
991
+ available to the resource pool. Default: `0`
992
+ :param pulumi.Input[builtins.str] cpu_share_level: The CPU allocation level. The level is a
993
+ simplified view of shares. Levels map to a pre-determined set of numeric
994
+ values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When
995
+ `low`, `normal`, or `high` are specified values in `cpu_shares` will be
996
+ ignored. Default: `normal`
997
+ :param pulumi.Input[builtins.int] cpu_shares: The number of shares allocated for CPU. Used to
998
+ determine resource allocation in case of resource contention. If this is set,
999
+ `cpu_share_level` must be `custom`.
707
1000
  :param pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]] custom_attributes: A list of custom attributes to set on this resource.
708
- :param pulumi.Input[builtins.bool] memory_expandable: Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has
709
- unreserved resources.
710
- :param pulumi.Input[builtins.int] memory_limit: The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for
711
- unlimited.
712
- :param pulumi.Input[builtins.int] memory_reservation: Amount of memory (MB) that is guaranteed available to the resource pool.
713
- :param pulumi.Input[builtins.str] memory_share_level: The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for
714
- shares. Can be one of low, normal, high, or custom.
715
- :param pulumi.Input[builtins.int] memory_shares: The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set,
716
- memory_share_level must be custom.
717
- :param pulumi.Input[builtins.str] name: Name of resource pool.
718
- :param pulumi.Input[builtins.str] parent_resource_pool_id: The ID of the root resource pool of the compute resource the resource pool is in.
719
- :param pulumi.Input[builtins.str] scale_descendants_shares: Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource
720
- pool are scaled up or down.
721
- :param pulumi.Input[Sequence[pulumi.Input[builtins.str]]] tags: A list of tag IDs to apply to this object.
1001
+ :param pulumi.Input[builtins.bool] memory_expandable: Determines if the reservation on a resource
1002
+ pool can grow beyond the specified value if the parent resource pool has
1003
+ unreserved resources. Default: `true`
1004
+ :param pulumi.Input[builtins.int] memory_limit: The CPU utilization of a resource pool will not
1005
+ exceed this limit, even if there are available resources. Set to `-1` for
1006
+ unlimited. Default: `-1`
1007
+ :param pulumi.Input[builtins.int] memory_reservation: Amount of CPU (MHz) that is guaranteed
1008
+ available to the resource pool. Default: `0`
1009
+ :param pulumi.Input[builtins.str] memory_share_level: The CPU allocation level. The level is a
1010
+ simplified view of shares. Levels map to a pre-determined set of numeric
1011
+ values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When
1012
+ `low`, `normal`, or `high` are specified values in `memory_shares` will be
1013
+ ignored. Default: `normal`
1014
+ :param pulumi.Input[builtins.int] memory_shares: The number of shares allocated for CPU. Used to
1015
+ determine resource allocation in case of resource contention. If this is set,
1016
+ `memory_share_level` must be `custom`.
1017
+ :param pulumi.Input[builtins.str] name: The name of the resource pool.
1018
+ :param pulumi.Input[builtins.str] parent_resource_pool_id: The managed object ID
1019
+ of the parent resource pool. This can be the root resource pool for a cluster
1020
+ or standalone host, or a resource pool itself. When moving a resource pool
1021
+ from one parent resource pool to another, both must share a common root
1022
+ resource pool.
1023
+ :param pulumi.Input[builtins.str] scale_descendants_shares: Determines if the shares of all
1024
+ descendants of the resource pool are scaled up or down when the shares
1025
+ of the resource pool are scaled up or down. Can be one of `disabled` or
1026
+ `scaleCpuAndMemoryShares`. Default: `disabled`.
1027
+ :param pulumi.Input[Sequence[pulumi.Input[builtins.str]]] tags: The IDs of any tags to attach to this resource.
722
1028
  """
723
1029
  opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
724
1030
 
@@ -745,8 +1051,9 @@ class ResourcePool(pulumi.CustomResource):
745
1051
  @pulumi.getter(name="cpuExpandable")
746
1052
  def cpu_expandable(self) -> pulumi.Output[Optional[builtins.bool]]:
747
1053
  """
748
- Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has
749
- unreserved resources.
1054
+ Determines if the reservation on a resource
1055
+ pool can grow beyond the specified value if the parent resource pool has
1056
+ unreserved resources. Default: `true`
750
1057
  """
751
1058
  return pulumi.get(self, "cpu_expandable")
752
1059
 
@@ -754,8 +1061,9 @@ class ResourcePool(pulumi.CustomResource):
754
1061
  @pulumi.getter(name="cpuLimit")
755
1062
  def cpu_limit(self) -> pulumi.Output[Optional[builtins.int]]:
756
1063
  """
757
- The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for
758
- unlimited.
1064
+ The CPU utilization of a resource pool will not
1065
+ exceed this limit, even if there are available resources. Set to `-1` for
1066
+ unlimited. Default: `-1`
759
1067
  """
760
1068
  return pulumi.get(self, "cpu_limit")
761
1069
 
@@ -763,7 +1071,8 @@ class ResourcePool(pulumi.CustomResource):
763
1071
  @pulumi.getter(name="cpuReservation")
764
1072
  def cpu_reservation(self) -> pulumi.Output[Optional[builtins.int]]:
765
1073
  """
766
- Amount of CPU (MHz) that is guaranteed available to the resource pool.
1074
+ Amount of CPU (MHz) that is guaranteed
1075
+ available to the resource pool. Default: `0`
767
1076
  """
768
1077
  return pulumi.get(self, "cpu_reservation")
769
1078
 
@@ -771,8 +1080,11 @@ class ResourcePool(pulumi.CustomResource):
771
1080
  @pulumi.getter(name="cpuShareLevel")
772
1081
  def cpu_share_level(self) -> pulumi.Output[Optional[builtins.str]]:
773
1082
  """
774
- The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for
775
- shares. Can be one of low, normal, high, or custom.
1083
+ The CPU allocation level. The level is a
1084
+ simplified view of shares. Levels map to a pre-determined set of numeric
1085
+ values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When
1086
+ `low`, `normal`, or `high` are specified values in `cpu_shares` will be
1087
+ ignored. Default: `normal`
776
1088
  """
777
1089
  return pulumi.get(self, "cpu_share_level")
778
1090
 
@@ -780,8 +1092,9 @@ class ResourcePool(pulumi.CustomResource):
780
1092
  @pulumi.getter(name="cpuShares")
781
1093
  def cpu_shares(self) -> pulumi.Output[builtins.int]:
782
1094
  """
783
- The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set,
784
- cpu_share_level must be custom.
1095
+ The number of shares allocated for CPU. Used to
1096
+ determine resource allocation in case of resource contention. If this is set,
1097
+ `cpu_share_level` must be `custom`.
785
1098
  """
786
1099
  return pulumi.get(self, "cpu_shares")
787
1100
 
@@ -797,8 +1110,9 @@ class ResourcePool(pulumi.CustomResource):
797
1110
  @pulumi.getter(name="memoryExpandable")
798
1111
  def memory_expandable(self) -> pulumi.Output[Optional[builtins.bool]]:
799
1112
  """
800
- Determines if the reservation on a resource pool can grow beyond the specified value, if the parent resource pool has
801
- unreserved resources.
1113
+ Determines if the reservation on a resource
1114
+ pool can grow beyond the specified value if the parent resource pool has
1115
+ unreserved resources. Default: `true`
802
1116
  """
803
1117
  return pulumi.get(self, "memory_expandable")
804
1118
 
@@ -806,8 +1120,9 @@ class ResourcePool(pulumi.CustomResource):
806
1120
  @pulumi.getter(name="memoryLimit")
807
1121
  def memory_limit(self) -> pulumi.Output[Optional[builtins.int]]:
808
1122
  """
809
- The utilization of a resource pool will not exceed this limit, even if there are available resources. Set to -1 for
810
- unlimited.
1123
+ The CPU utilization of a resource pool will not
1124
+ exceed this limit, even if there are available resources. Set to `-1` for
1125
+ unlimited. Default: `-1`
811
1126
  """
812
1127
  return pulumi.get(self, "memory_limit")
813
1128
 
@@ -815,7 +1130,8 @@ class ResourcePool(pulumi.CustomResource):
815
1130
  @pulumi.getter(name="memoryReservation")
816
1131
  def memory_reservation(self) -> pulumi.Output[Optional[builtins.int]]:
817
1132
  """
818
- Amount of memory (MB) that is guaranteed available to the resource pool.
1133
+ Amount of CPU (MHz) that is guaranteed
1134
+ available to the resource pool. Default: `0`
819
1135
  """
820
1136
  return pulumi.get(self, "memory_reservation")
821
1137
 
@@ -823,8 +1139,11 @@ class ResourcePool(pulumi.CustomResource):
823
1139
  @pulumi.getter(name="memoryShareLevel")
824
1140
  def memory_share_level(self) -> pulumi.Output[Optional[builtins.str]]:
825
1141
  """
826
- The allocation level. The level is a simplified view of shares. Levels map to a pre-determined set of numeric values for
827
- shares. Can be one of low, normal, high, or custom.
1142
+ The CPU allocation level. The level is a
1143
+ simplified view of shares. Levels map to a pre-determined set of numeric
1144
+ values for shares. Can be one of `low`, `normal`, `high`, or `custom`. When
1145
+ `low`, `normal`, or `high` are specified values in `memory_shares` will be
1146
+ ignored. Default: `normal`
828
1147
  """
829
1148
  return pulumi.get(self, "memory_share_level")
830
1149
 
@@ -832,8 +1151,9 @@ class ResourcePool(pulumi.CustomResource):
832
1151
  @pulumi.getter(name="memoryShares")
833
1152
  def memory_shares(self) -> pulumi.Output[builtins.int]:
834
1153
  """
835
- The number of shares allocated. Used to determine resource allocation in case of resource contention. If this is set,
836
- memory_share_level must be custom.
1154
+ The number of shares allocated for CPU. Used to
1155
+ determine resource allocation in case of resource contention. If this is set,
1156
+ `memory_share_level` must be `custom`.
837
1157
  """
838
1158
  return pulumi.get(self, "memory_shares")
839
1159
 
@@ -841,7 +1161,7 @@ class ResourcePool(pulumi.CustomResource):
841
1161
  @pulumi.getter
842
1162
  def name(self) -> pulumi.Output[builtins.str]:
843
1163
  """
844
- Name of resource pool.
1164
+ The name of the resource pool.
845
1165
  """
846
1166
  return pulumi.get(self, "name")
847
1167
 
@@ -849,7 +1169,11 @@ class ResourcePool(pulumi.CustomResource):
849
1169
  @pulumi.getter(name="parentResourcePoolId")
850
1170
  def parent_resource_pool_id(self) -> pulumi.Output[builtins.str]:
851
1171
  """
852
- The ID of the root resource pool of the compute resource the resource pool is in.
1172
+ The managed object ID
1173
+ of the parent resource pool. This can be the root resource pool for a cluster
1174
+ or standalone host, or a resource pool itself. When moving a resource pool
1175
+ from one parent resource pool to another, both must share a common root
1176
+ resource pool.
853
1177
  """
854
1178
  return pulumi.get(self, "parent_resource_pool_id")
855
1179
 
@@ -857,8 +1181,10 @@ class ResourcePool(pulumi.CustomResource):
857
1181
  @pulumi.getter(name="scaleDescendantsShares")
858
1182
  def scale_descendants_shares(self) -> pulumi.Output[Optional[builtins.str]]:
859
1183
  """
860
- Determines if the shares of all descendants of the resource pool are scaled up or down when the shares of the resource
861
- pool are scaled up or down.
1184
+ Determines if the shares of all
1185
+ descendants of the resource pool are scaled up or down when the shares
1186
+ of the resource pool are scaled up or down. Can be one of `disabled` or
1187
+ `scaleCpuAndMemoryShares`. Default: `disabled`.
862
1188
  """
863
1189
  return pulumi.get(self, "scale_descendants_shares")
864
1190
 
@@ -866,7 +1192,7 @@ class ResourcePool(pulumi.CustomResource):
866
1192
  @pulumi.getter
867
1193
  def tags(self) -> pulumi.Output[Optional[Sequence[builtins.str]]]:
868
1194
  """
869
- A list of tag IDs to apply to this object.
1195
+ The IDs of any tags to attach to this resource.
870
1196
  """
871
1197
  return pulumi.get(self, "tags")
872
1198