pulumi-vsphere 4.14.0a1745952392__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 (61) hide show
  1. pulumi_vsphere/compute_cluster.py +11 -13
  2. pulumi_vsphere/compute_cluster_host_group.py +71 -3
  3. pulumi_vsphere/compute_cluster_vm_affinity_rule.py +1 -3
  4. pulumi_vsphere/compute_cluster_vm_anti_affinity_rule.py +5 -3
  5. pulumi_vsphere/compute_cluster_vm_dependency_rule.py +5 -3
  6. pulumi_vsphere/compute_cluster_vm_group.py +5 -3
  7. pulumi_vsphere/compute_cluster_vm_host_rule.py +5 -3
  8. pulumi_vsphere/content_library.py +5 -3
  9. pulumi_vsphere/content_library_item.py +5 -3
  10. pulumi_vsphere/custom_attribute.py +5 -3
  11. pulumi_vsphere/datacenter.py +1 -3
  12. pulumi_vsphere/datastore_cluster.py +89 -3
  13. pulumi_vsphere/datastore_cluster_vm_anti_affinity_rule.py +5 -3
  14. pulumi_vsphere/distributed_port_group.py +5 -3
  15. pulumi_vsphere/distributed_virtual_switch.py +5 -3
  16. pulumi_vsphere/distributed_virtual_switch_pvlan_mapping.py +1 -3
  17. pulumi_vsphere/dpm_host_override.py +89 -3
  18. pulumi_vsphere/drs_vm_override.py +5 -3
  19. pulumi_vsphere/entity_permissions.py +1 -3
  20. pulumi_vsphere/file.py +35 -52
  21. pulumi_vsphere/folder.py +17 -15
  22. pulumi_vsphere/get_compute_cluster_host_group.py +0 -4
  23. pulumi_vsphere/get_datastore_cluster.py +1 -1
  24. pulumi_vsphere/get_datastore_stats.py +0 -4
  25. pulumi_vsphere/get_dynamic.py +0 -4
  26. pulumi_vsphere/get_folder.py +130 -8
  27. pulumi_vsphere/get_guest_os_customization.py +21 -2
  28. pulumi_vsphere/get_license.py +8 -6
  29. pulumi_vsphere/get_network.py +35 -1
  30. pulumi_vsphere/get_ovf_vm_template.py +4 -4
  31. pulumi_vsphere/guest_os_customization.py +1 -3
  32. pulumi_vsphere/ha_vm_override.py +5 -3
  33. pulumi_vsphere/host.py +61 -9
  34. pulumi_vsphere/host_port_group.py +1 -3
  35. pulumi_vsphere/host_virtual_switch.py +5 -3
  36. pulumi_vsphere/license.py +67 -29
  37. pulumi_vsphere/nas_datastore.py +63 -3
  38. pulumi_vsphere/offline_software_depot.py +5 -3
  39. pulumi_vsphere/outputs.py +33 -0
  40. pulumi_vsphere/provider.py +21 -3
  41. pulumi_vsphere/pulumi-plugin.json +1 -1
  42. pulumi_vsphere/resource_pool.py +490 -166
  43. pulumi_vsphere/role.py +1 -3
  44. pulumi_vsphere/storage_drs_vm_override.py +5 -3
  45. pulumi_vsphere/supervisor.py +3 -5
  46. pulumi_vsphere/tag.py +5 -3
  47. pulumi_vsphere/tag_category.py +5 -3
  48. pulumi_vsphere/vapp_container.py +5 -3
  49. pulumi_vsphere/vapp_entity.py +5 -3
  50. pulumi_vsphere/virtual_disk.py +5 -3
  51. pulumi_vsphere/virtual_machine.py +5 -7
  52. pulumi_vsphere/virtual_machine_class.py +5 -7
  53. pulumi_vsphere/virtual_machine_snapshot.py +1 -3
  54. pulumi_vsphere/vm_storage_policy.py +1 -3
  55. pulumi_vsphere/vmfs_datastore.py +5 -3
  56. pulumi_vsphere/vnic.py +1 -3
  57. {pulumi_vsphere-4.14.0a1745952392.dist-info → pulumi_vsphere-4.14.0a1747752163.dist-info}/METADATA +3 -3
  58. pulumi_vsphere-4.14.0a1747752163.dist-info/RECORD +87 -0
  59. {pulumi_vsphere-4.14.0a1745952392.dist-info → pulumi_vsphere-4.14.0a1747752163.dist-info}/WHEEL +1 -1
  60. pulumi_vsphere-4.14.0a1745952392.dist-info/RECORD +0 -87
  61. {pulumi_vsphere-4.14.0a1745952392.dist-info → pulumi_vsphere-4.14.0a1747752163.dist-info}/top_level.txt +0 -0
@@ -195,10 +195,8 @@ class _DpmHostOverrideState:
195
195
  pulumi.set(self, "host_system_id", value)
196
196
 
197
197
 
198
+ @pulumi.type_token("vsphere:index/dpmHostOverride:DpmHostOverride")
198
199
  class DpmHostOverride(pulumi.CustomResource):
199
-
200
- pulumi_type = "vsphere:index/dpmHostOverride:DpmHostOverride"
201
-
202
200
  @overload
203
201
  def __init__(__self__,
204
202
  resource_name: str,
@@ -222,6 +220,48 @@ class DpmHostOverride(pulumi.CustomResource):
222
220
  > **NOTE:** This resource requires vCenter and is not available on direct ESXi
223
221
  connections.
224
222
 
223
+ ## Example Usage
224
+
225
+ The following example creates a compute cluster comprised of three hosts,
226
+ making use of the
227
+ `ComputeCluster` resource. DPM
228
+ will be disabled in the cluster as it is the default setting, but we override
229
+ the setting of the first host referenced by the
230
+ `Host` data source (`esxi1`) by using
231
+ the `DpmHostOverride` resource so it will be powered off when the
232
+ cluster does not need it to service virtual machines.
233
+
234
+ ```python
235
+ import pulumi
236
+ import pulumi_vsphere as vsphere
237
+
238
+ config = pulumi.Config()
239
+ datacenter = config.get("datacenter")
240
+ if datacenter is None:
241
+ datacenter = "dc-01"
242
+ hosts = config.get_object("hosts")
243
+ if hosts is None:
244
+ hosts = [
245
+ "esxi-01.example.com",
246
+ "esxi-02.example.com",
247
+ "esxi-03.example.com",
248
+ ]
249
+ datacenter_get_datacenter = vsphere.get_datacenter(name=datacenter)
250
+ hosts_get_host = [vsphere.get_host(name=hosts[__index],
251
+ datacenter_id=datacenter_get_datacenter.id) for __index in range(len(hosts))]
252
+ compute_cluster = vsphere.ComputeCluster("compute_cluster",
253
+ name="compute-cluster-test",
254
+ datacenter_id=dc["id"],
255
+ host_system_ids=[[__item.id for __item in hosts_get_host]],
256
+ drs_enabled=True,
257
+ drs_automation_level="fullyAutomated")
258
+ dpm_host_override = vsphere.DpmHostOverride("dpm_host_override",
259
+ compute_cluster_id=compute_cluster.id,
260
+ host_system_id=hosts_get_host[0].id,
261
+ dpm_enabled=True,
262
+ dpm_automation_level="automated")
263
+ ```
264
+
225
265
  ## Import
226
266
 
227
267
  An existing override can be imported into this resource by
@@ -230,6 +270,8 @@ class DpmHostOverride(pulumi.CustomResource):
230
270
 
231
271
  import`. If no override exists, an error will be given. An example is below:
232
272
 
273
+ [docs-import]: https://developer.hashicorp.com/terraform/cli/import
274
+
233
275
  ```sh
234
276
  $ pulumi import vsphere:index/dpmHostOverride:DpmHostOverride dpm_host_override \\
235
277
  ```
@@ -274,6 +316,48 @@ class DpmHostOverride(pulumi.CustomResource):
274
316
  > **NOTE:** This resource requires vCenter and is not available on direct ESXi
275
317
  connections.
276
318
 
319
+ ## Example Usage
320
+
321
+ The following example creates a compute cluster comprised of three hosts,
322
+ making use of the
323
+ `ComputeCluster` resource. DPM
324
+ will be disabled in the cluster as it is the default setting, but we override
325
+ the setting of the first host referenced by the
326
+ `Host` data source (`esxi1`) by using
327
+ the `DpmHostOverride` resource so it will be powered off when the
328
+ cluster does not need it to service virtual machines.
329
+
330
+ ```python
331
+ import pulumi
332
+ import pulumi_vsphere as vsphere
333
+
334
+ config = pulumi.Config()
335
+ datacenter = config.get("datacenter")
336
+ if datacenter is None:
337
+ datacenter = "dc-01"
338
+ hosts = config.get_object("hosts")
339
+ if hosts is None:
340
+ hosts = [
341
+ "esxi-01.example.com",
342
+ "esxi-02.example.com",
343
+ "esxi-03.example.com",
344
+ ]
345
+ datacenter_get_datacenter = vsphere.get_datacenter(name=datacenter)
346
+ hosts_get_host = [vsphere.get_host(name=hosts[__index],
347
+ datacenter_id=datacenter_get_datacenter.id) for __index in range(len(hosts))]
348
+ compute_cluster = vsphere.ComputeCluster("compute_cluster",
349
+ name="compute-cluster-test",
350
+ datacenter_id=dc["id"],
351
+ host_system_ids=[[__item.id for __item in hosts_get_host]],
352
+ drs_enabled=True,
353
+ drs_automation_level="fullyAutomated")
354
+ dpm_host_override = vsphere.DpmHostOverride("dpm_host_override",
355
+ compute_cluster_id=compute_cluster.id,
356
+ host_system_id=hosts_get_host[0].id,
357
+ dpm_enabled=True,
358
+ dpm_automation_level="automated")
359
+ ```
360
+
277
361
  ## Import
278
362
 
279
363
  An existing override can be imported into this resource by
@@ -282,6 +366,8 @@ class DpmHostOverride(pulumi.CustomResource):
282
366
 
283
367
  import`. If no override exists, an error will be given. An example is below:
284
368
 
369
+ [docs-import]: https://developer.hashicorp.com/terraform/cli/import
370
+
285
371
  ```sh
286
372
  $ pulumi import vsphere:index/dpmHostOverride:DpmHostOverride dpm_host_override \\
287
373
  ```
@@ -199,10 +199,8 @@ class _DrsVmOverrideState:
199
199
  pulumi.set(self, "virtual_machine_id", value)
200
200
 
201
201
 
202
+ @pulumi.type_token("vsphere:index/drsVmOverride:DrsVmOverride")
202
203
  class DrsVmOverride(pulumi.CustomResource):
203
-
204
- pulumi_type = "vsphere:index/drsVmOverride:DrsVmOverride"
205
-
206
204
  @overload
207
205
  def __init__(__self__,
208
206
  resource_name: str,
@@ -283,6 +281,8 @@ class DrsVmOverride(pulumi.CustomResource):
283
281
 
284
282
  is below:
285
283
 
284
+ [docs-import]: https://developer.hashicorp.com/terraform/cli/import
285
+
286
286
  ```sh
287
287
  $ pulumi import vsphere:index/drsVmOverride:DrsVmOverride drs_vm_override \\
288
288
  ```
@@ -385,6 +385,8 @@ class DrsVmOverride(pulumi.CustomResource):
385
385
 
386
386
  is below:
387
387
 
388
+ [docs-import]: https://developer.hashicorp.com/terraform/cli/import
389
+
388
390
  ```sh
389
391
  $ pulumi import vsphere:index/drsVmOverride:DrsVmOverride drs_vm_override \\
390
392
  ```
@@ -148,10 +148,8 @@ class _EntityPermissionsState:
148
148
  pulumi.set(self, "permissions", value)
149
149
 
150
150
 
151
+ @pulumi.type_token("vsphere:index/entityPermissions:EntityPermissions")
151
152
  class EntityPermissions(pulumi.CustomResource):
152
-
153
- pulumi_type = "vsphere:index/entityPermissions:EntityPermissions"
154
-
155
153
  @overload
156
154
  def __init__(__self__,
157
155
  resource_name: str,
pulumi_vsphere/file.py CHANGED
@@ -32,13 +32,10 @@ class FileArgs:
32
32
  :param pulumi.Input[builtins.str] datastore: The name of the datastore to which to upload the
33
33
  file.
34
34
  :param pulumi.Input[builtins.str] destination_file: The path to where the file should be uploaded
35
- or copied to on the destination `datastore` in vSphere.
36
- :param pulumi.Input[builtins.bool] create_directories: Create directories in `destination_file`
37
- path parameter on first apply if any are missing for copy operation.
38
-
39
- > **NOTE:** Any directory created as part of the `create_directories` argument
40
- will not be deleted when the resource is destroyed. New directories are not
41
- created if the `destination_file` path is changed in subsequent applies.
35
+ or copied to on the destination datastore.
36
+ :param pulumi.Input[builtins.str] source_file: The path to the file being uploaded from or copied.
37
+ Forces a new resource if changed.
38
+ :param pulumi.Input[builtins.bool] create_directories: Specifies whether to create the parent directories of the destination file if they do not exist.
42
39
  :param pulumi.Input[builtins.str] datacenter: The name of a datacenter to which the file will be
43
40
  uploaded.
44
41
  :param pulumi.Input[builtins.str] source_datacenter: The name of a datacenter from which the file
@@ -76,7 +73,7 @@ class FileArgs:
76
73
  def destination_file(self) -> pulumi.Input[builtins.str]:
77
74
  """
78
75
  The path to where the file should be uploaded
79
- or copied to on the destination `datastore` in vSphere.
76
+ or copied to on the destination datastore.
80
77
  """
81
78
  return pulumi.get(self, "destination_file")
82
79
 
@@ -87,6 +84,10 @@ class FileArgs:
87
84
  @property
88
85
  @pulumi.getter(name="sourceFile")
89
86
  def source_file(self) -> pulumi.Input[builtins.str]:
87
+ """
88
+ The path to the file being uploaded from or copied.
89
+ Forces a new resource if changed.
90
+ """
90
91
  return pulumi.get(self, "source_file")
91
92
 
92
93
  @source_file.setter
@@ -97,12 +98,7 @@ class FileArgs:
97
98
  @pulumi.getter(name="createDirectories")
98
99
  def create_directories(self) -> Optional[pulumi.Input[builtins.bool]]:
99
100
  """
100
- Create directories in `destination_file`
101
- path parameter on first apply if any are missing for copy operation.
102
-
103
- > **NOTE:** Any directory created as part of the `create_directories` argument
104
- will not be deleted when the resource is destroyed. New directories are not
105
- created if the `destination_file` path is changed in subsequent applies.
101
+ Specifies whether to create the parent directories of the destination file if they do not exist.
106
102
  """
107
103
  return pulumi.get(self, "create_directories")
108
104
 
@@ -162,22 +158,19 @@ class _FileState:
162
158
  source_file: Optional[pulumi.Input[builtins.str]] = None):
163
159
  """
164
160
  Input properties used for looking up and filtering File resources.
165
- :param pulumi.Input[builtins.bool] create_directories: Create directories in `destination_file`
166
- path parameter on first apply if any are missing for copy operation.
167
-
168
- > **NOTE:** Any directory created as part of the `create_directories` argument
169
- will not be deleted when the resource is destroyed. New directories are not
170
- created if the `destination_file` path is changed in subsequent applies.
161
+ :param pulumi.Input[builtins.bool] create_directories: Specifies whether to create the parent directories of the destination file if they do not exist.
171
162
  :param pulumi.Input[builtins.str] datacenter: The name of a datacenter to which the file will be
172
163
  uploaded.
173
164
  :param pulumi.Input[builtins.str] datastore: The name of the datastore to which to upload the
174
165
  file.
175
166
  :param pulumi.Input[builtins.str] destination_file: The path to where the file should be uploaded
176
- or copied to on the destination `datastore` in vSphere.
167
+ or copied to on the destination datastore.
177
168
  :param pulumi.Input[builtins.str] source_datacenter: The name of a datacenter from which the file
178
169
  will be copied. Forces a new resource if changed.
179
170
  :param pulumi.Input[builtins.str] source_datastore: The name of the datastore from which file will
180
171
  be copied. Forces a new resource if changed.
172
+ :param pulumi.Input[builtins.str] source_file: The path to the file being uploaded from or copied.
173
+ Forces a new resource if changed.
181
174
  """
182
175
  if create_directories is not None:
183
176
  pulumi.set(__self__, "create_directories", create_directories)
@@ -198,12 +191,7 @@ class _FileState:
198
191
  @pulumi.getter(name="createDirectories")
199
192
  def create_directories(self) -> Optional[pulumi.Input[builtins.bool]]:
200
193
  """
201
- Create directories in `destination_file`
202
- path parameter on first apply if any are missing for copy operation.
203
-
204
- > **NOTE:** Any directory created as part of the `create_directories` argument
205
- will not be deleted when the resource is destroyed. New directories are not
206
- created if the `destination_file` path is changed in subsequent applies.
194
+ Specifies whether to create the parent directories of the destination file if they do not exist.
207
195
  """
208
196
  return pulumi.get(self, "create_directories")
209
197
 
@@ -242,7 +230,7 @@ class _FileState:
242
230
  def destination_file(self) -> Optional[pulumi.Input[builtins.str]]:
243
231
  """
244
232
  The path to where the file should be uploaded
245
- or copied to on the destination `datastore` in vSphere.
233
+ or copied to on the destination datastore.
246
234
  """
247
235
  return pulumi.get(self, "destination_file")
248
236
 
@@ -279,6 +267,10 @@ class _FileState:
279
267
  @property
280
268
  @pulumi.getter(name="sourceFile")
281
269
  def source_file(self) -> Optional[pulumi.Input[builtins.str]]:
270
+ """
271
+ The path to the file being uploaded from or copied.
272
+ Forces a new resource if changed.
273
+ """
282
274
  return pulumi.get(self, "source_file")
283
275
 
284
276
  @source_file.setter
@@ -286,10 +278,8 @@ class _FileState:
286
278
  pulumi.set(self, "source_file", value)
287
279
 
288
280
 
281
+ @pulumi.type_token("vsphere:index/file:File")
289
282
  class File(pulumi.CustomResource):
290
-
291
- pulumi_type = "vsphere:index/file:File"
292
-
293
283
  @overload
294
284
  def __init__(__self__,
295
285
  resource_name: str,
@@ -337,22 +327,19 @@ class File(pulumi.CustomResource):
337
327
 
338
328
  :param str resource_name: The name of the resource.
339
329
  :param pulumi.ResourceOptions opts: Options for the resource.
340
- :param pulumi.Input[builtins.bool] create_directories: Create directories in `destination_file`
341
- path parameter on first apply if any are missing for copy operation.
342
-
343
- > **NOTE:** Any directory created as part of the `create_directories` argument
344
- will not be deleted when the resource is destroyed. New directories are not
345
- created if the `destination_file` path is changed in subsequent applies.
330
+ :param pulumi.Input[builtins.bool] create_directories: Specifies whether to create the parent directories of the destination file if they do not exist.
346
331
  :param pulumi.Input[builtins.str] datacenter: The name of a datacenter to which the file will be
347
332
  uploaded.
348
333
  :param pulumi.Input[builtins.str] datastore: The name of the datastore to which to upload the
349
334
  file.
350
335
  :param pulumi.Input[builtins.str] destination_file: The path to where the file should be uploaded
351
- or copied to on the destination `datastore` in vSphere.
336
+ or copied to on the destination datastore.
352
337
  :param pulumi.Input[builtins.str] source_datacenter: The name of a datacenter from which the file
353
338
  will be copied. Forces a new resource if changed.
354
339
  :param pulumi.Input[builtins.str] source_datastore: The name of the datastore from which file will
355
340
  be copied. Forces a new resource if changed.
341
+ :param pulumi.Input[builtins.str] source_file: The path to the file being uploaded from or copied.
342
+ Forces a new resource if changed.
356
343
  """
357
344
  ...
358
345
  @overload
@@ -461,22 +448,19 @@ class File(pulumi.CustomResource):
461
448
  :param str resource_name: The unique name of the resulting resource.
462
449
  :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
463
450
  :param pulumi.ResourceOptions opts: Options for the resource.
464
- :param pulumi.Input[builtins.bool] create_directories: Create directories in `destination_file`
465
- path parameter on first apply if any are missing for copy operation.
466
-
467
- > **NOTE:** Any directory created as part of the `create_directories` argument
468
- will not be deleted when the resource is destroyed. New directories are not
469
- created if the `destination_file` path is changed in subsequent applies.
451
+ :param pulumi.Input[builtins.bool] create_directories: Specifies whether to create the parent directories of the destination file if they do not exist.
470
452
  :param pulumi.Input[builtins.str] datacenter: The name of a datacenter to which the file will be
471
453
  uploaded.
472
454
  :param pulumi.Input[builtins.str] datastore: The name of the datastore to which to upload the
473
455
  file.
474
456
  :param pulumi.Input[builtins.str] destination_file: The path to where the file should be uploaded
475
- or copied to on the destination `datastore` in vSphere.
457
+ or copied to on the destination datastore.
476
458
  :param pulumi.Input[builtins.str] source_datacenter: The name of a datacenter from which the file
477
459
  will be copied. Forces a new resource if changed.
478
460
  :param pulumi.Input[builtins.str] source_datastore: The name of the datastore from which file will
479
461
  be copied. Forces a new resource if changed.
462
+ :param pulumi.Input[builtins.str] source_file: The path to the file being uploaded from or copied.
463
+ Forces a new resource if changed.
480
464
  """
481
465
  opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
482
466
 
@@ -495,12 +479,7 @@ class File(pulumi.CustomResource):
495
479
  @pulumi.getter(name="createDirectories")
496
480
  def create_directories(self) -> pulumi.Output[Optional[builtins.bool]]:
497
481
  """
498
- Create directories in `destination_file`
499
- path parameter on first apply if any are missing for copy operation.
500
-
501
- > **NOTE:** Any directory created as part of the `create_directories` argument
502
- will not be deleted when the resource is destroyed. New directories are not
503
- created if the `destination_file` path is changed in subsequent applies.
482
+ Specifies whether to create the parent directories of the destination file if they do not exist.
504
483
  """
505
484
  return pulumi.get(self, "create_directories")
506
485
 
@@ -527,7 +506,7 @@ class File(pulumi.CustomResource):
527
506
  def destination_file(self) -> pulumi.Output[builtins.str]:
528
507
  """
529
508
  The path to where the file should be uploaded
530
- or copied to on the destination `datastore` in vSphere.
509
+ or copied to on the destination datastore.
531
510
  """
532
511
  return pulumi.get(self, "destination_file")
533
512
 
@@ -552,5 +531,9 @@ class File(pulumi.CustomResource):
552
531
  @property
553
532
  @pulumi.getter(name="sourceFile")
554
533
  def source_file(self) -> pulumi.Output[builtins.str]:
534
+ """
535
+ The path to the file being uploaded from or copied.
536
+ Forces a new resource if changed.
537
+ """
555
538
  return pulumi.get(self, "source_file")
556
539
 
pulumi_vsphere/folder.py CHANGED
@@ -279,10 +279,8 @@ class _FolderState:
279
279
  pulumi.set(self, "type", value)
280
280
 
281
281
 
282
+ @pulumi.type_token("vsphere:index/folder:Folder")
282
283
  class Folder(pulumi.CustomResource):
283
-
284
- pulumi_type = "vsphere:index/folder:Folder"
285
-
286
284
  @overload
287
285
  def __init__(__self__,
288
286
  resource_name: str,
@@ -302,7 +300,7 @@ class Folder(pulumi.CustomResource):
302
300
  Paths are always relative to the specific type of folder you are creating.
303
301
  A subfolder is discovered by parsing the relative path specified in `path`, so
304
302
  `foo/bar` will create a folder named `bar` in the parent folder `foo`, as long
305
- as that folder exists.
303
+ as the folder `foo` exists.
306
304
 
307
305
  ## Example Usage
308
306
 
@@ -313,14 +311,14 @@ class Folder(pulumi.CustomResource):
313
311
  import pulumi
314
312
  import pulumi_vsphere as vsphere
315
313
 
316
- datacenter = vsphere.get_datacenter()
314
+ datacenter = vsphere.get_datacenter(name=vsphere_datacenter)
317
315
  folder = vsphere.Folder("folder",
318
316
  path="test-folder",
319
317
  type="vm",
320
318
  datacenter_id=datacenter.id)
321
319
  ```
322
320
 
323
- ### Example with subfolders
321
+ ### Example with Sub-folders
324
322
 
325
323
  The below example builds off of the above by first creating a folder named
326
324
  `test-parent`, and then locating `test-folder` in that
@@ -335,7 +333,7 @@ class Folder(pulumi.CustomResource):
335
333
  import pulumi
336
334
  import pulumi_vsphere as vsphere
337
335
 
338
- datacenter = vsphere.get_datacenter()
336
+ datacenter = vsphere.get_datacenter(name=vsphere_datacenter)
339
337
  parent = vsphere.Folder("parent",
340
338
  path="test-parent",
341
339
  type="vm",
@@ -352,13 +350,15 @@ class Folder(pulumi.CustomResource):
352
350
 
353
351
  its full path, via the following command:
354
352
 
353
+ [docs-import]: https://developer.hashicorp.com/terraform/cli/import
354
+
355
355
  ```sh
356
- $ pulumi import vsphere:index/folder:Folder folder /default-dc/vm/terraform-test-folder
356
+ $ pulumi import vsphere:index/folder:Folder folder /default-dc/vm/example-vm-folder
357
357
  ```
358
358
 
359
359
  The above command would import the folder from our examples above, the VM
360
360
 
361
- folder named `terraform-test-folder` located in the datacenter named
361
+ folder named `example-vm-folder` located in the datacenter named
362
362
 
363
363
  `default-dc`.
364
364
 
@@ -407,7 +407,7 @@ class Folder(pulumi.CustomResource):
407
407
  Paths are always relative to the specific type of folder you are creating.
408
408
  A subfolder is discovered by parsing the relative path specified in `path`, so
409
409
  `foo/bar` will create a folder named `bar` in the parent folder `foo`, as long
410
- as that folder exists.
410
+ as the folder `foo` exists.
411
411
 
412
412
  ## Example Usage
413
413
 
@@ -418,14 +418,14 @@ class Folder(pulumi.CustomResource):
418
418
  import pulumi
419
419
  import pulumi_vsphere as vsphere
420
420
 
421
- datacenter = vsphere.get_datacenter()
421
+ datacenter = vsphere.get_datacenter(name=vsphere_datacenter)
422
422
  folder = vsphere.Folder("folder",
423
423
  path="test-folder",
424
424
  type="vm",
425
425
  datacenter_id=datacenter.id)
426
426
  ```
427
427
 
428
- ### Example with subfolders
428
+ ### Example with Sub-folders
429
429
 
430
430
  The below example builds off of the above by first creating a folder named
431
431
  `test-parent`, and then locating `test-folder` in that
@@ -440,7 +440,7 @@ class Folder(pulumi.CustomResource):
440
440
  import pulumi
441
441
  import pulumi_vsphere as vsphere
442
442
 
443
- datacenter = vsphere.get_datacenter()
443
+ datacenter = vsphere.get_datacenter(name=vsphere_datacenter)
444
444
  parent = vsphere.Folder("parent",
445
445
  path="test-parent",
446
446
  type="vm",
@@ -457,13 +457,15 @@ class Folder(pulumi.CustomResource):
457
457
 
458
458
  its full path, via the following command:
459
459
 
460
+ [docs-import]: https://developer.hashicorp.com/terraform/cli/import
461
+
460
462
  ```sh
461
- $ pulumi import vsphere:index/folder:Folder folder /default-dc/vm/terraform-test-folder
463
+ $ pulumi import vsphere:index/folder:Folder folder /default-dc/vm/example-vm-folder
462
464
  ```
463
465
 
464
466
  The above command would import the folder from our examples above, the VM
465
467
 
466
- folder named `terraform-test-folder` located in the datacenter named
468
+ folder named `example-vm-folder` located in the datacenter named
467
469
 
468
470
  `default-dc`.
469
471
 
@@ -111,8 +111,6 @@ def get_compute_cluster_host_group(compute_cluster_id: Optional[builtins.str] =
111
111
  :param builtins.str compute_cluster_id: The
112
112
  [managed object reference ID][docs-about-morefs] of the compute cluster for
113
113
  the host group.
114
-
115
- [docs-about-morefs]: /docs/providers/vsphere/index.html#use-of-managed-object-references-by-the-vsphere-provider
116
114
  :param builtins.str name: The name of the host group.
117
115
  """
118
116
  __args__ = dict()
@@ -156,8 +154,6 @@ def get_compute_cluster_host_group_output(compute_cluster_id: Optional[pulumi.In
156
154
  :param builtins.str compute_cluster_id: The
157
155
  [managed object reference ID][docs-about-morefs] of the compute cluster for
158
156
  the host group.
159
-
160
- [docs-about-morefs]: /docs/providers/vsphere/index.html#use-of-managed-object-references-by-the-vsphere-provider
161
157
  :param builtins.str name: The name of the host group.
162
158
  """
163
159
  __args__ = dict()
@@ -50,7 +50,7 @@ class GetDatastoreClusterResult:
50
50
  @pulumi.getter
51
51
  def datastores(self) -> Sequence[builtins.str]:
52
52
  """
53
- (Optional) The names of the datastores included in the specific
53
+ (Optional) The names of the datastores included in the specific
54
54
  cluster.
55
55
  """
56
56
  return pulumi.get(self, "datastores")
@@ -131,8 +131,6 @@ def get_datastore_stats(capacity: Optional[Mapping[str, builtins.str]] = None,
131
131
  [managed object reference ID][docs-about-morefs] of the datacenter the
132
132
  datastores are located in. For default datacenters, use the `id` attribute
133
133
  from an empty `Datacenter` data source.
134
-
135
- [docs-about-morefs]: /docs/providers/vsphere/index.html#use-of-managed-object-references-by-the-vsphere-provider
136
134
  :param Mapping[str, builtins.str] free_space: A mapping of the free space for each datastore in the
137
135
  datacenter, where the name of the datastore is used as key and the free space
138
136
  as value.
@@ -190,8 +188,6 @@ def get_datastore_stats_output(capacity: Optional[pulumi.Input[Optional[Mapping[
190
188
  [managed object reference ID][docs-about-morefs] of the datacenter the
191
189
  datastores are located in. For default datacenters, use the `id` attribute
192
190
  from an empty `Datacenter` data source.
193
-
194
- [docs-about-morefs]: /docs/providers/vsphere/index.html#use-of-managed-object-references-by-the-vsphere-provider
195
191
  :param Mapping[str, builtins.str] free_space: A mapping of the free space for each datastore in the
196
192
  datacenter, where the name of the datastore is used as key and the free space
197
193
  as value.
@@ -82,8 +82,6 @@ def get_dynamic(filters: Optional[Sequence[builtins.str]] = None,
82
82
  type: Optional[builtins.str] = None,
83
83
  opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetDynamicResult:
84
84
  """
85
- [docs-about-morefs]: /docs/providers/vsphere/index.html#use-of-managed-object-references-by-the-vsphere-provider
86
-
87
85
  The `get_dynamic` data source can be used to get the
88
86
  [managed object reference ID][docs-about-morefs] of any tagged managed object in
89
87
  vCenter Server by providing a list of tag IDs and an optional regular expression
@@ -134,8 +132,6 @@ def get_dynamic_output(filters: Optional[pulumi.Input[Sequence[builtins.str]]] =
134
132
  type: Optional[pulumi.Input[Optional[builtins.str]]] = None,
135
133
  opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetDynamicResult]:
136
134
  """
137
- [docs-about-morefs]: /docs/providers/vsphere/index.html#use-of-managed-object-references-by-the-vsphere-provider
138
-
139
135
  The `get_dynamic` data source can be used to get the
140
136
  [managed object reference ID][docs-about-morefs] of any tagged managed object in
141
137
  vCenter Server by providing a list of tag IDs and an optional regular expression