pulumi-vsphere 4.10.0a1710245029__py3-none-any.whl → 4.10.2__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 (64) hide show
  1. pulumi_vsphere/__init__.py +28 -0
  2. pulumi_vsphere/_inputs.py +566 -236
  3. pulumi_vsphere/_utilities.py +35 -0
  4. pulumi_vsphere/compute_cluster.py +747 -1477
  5. pulumi_vsphere/compute_cluster_vm_affinity_rule.py +28 -20
  6. pulumi_vsphere/datacenter.py +33 -40
  7. pulumi_vsphere/datastore_cluster.py +154 -364
  8. pulumi_vsphere/distributed_port_group.py +126 -182
  9. pulumi_vsphere/distributed_virtual_switch.py +301 -819
  10. pulumi_vsphere/entity_permissions.py +56 -35
  11. pulumi_vsphere/file.py +16 -24
  12. pulumi_vsphere/folder.py +7 -28
  13. pulumi_vsphere/get_compute_cluster.py +0 -4
  14. pulumi_vsphere/get_compute_cluster_host_group.py +20 -20
  15. pulumi_vsphere/get_content_library.py +10 -10
  16. pulumi_vsphere/get_content_library_item.py +12 -8
  17. pulumi_vsphere/get_custom_attribute.py +0 -4
  18. pulumi_vsphere/get_datacenter.py +0 -4
  19. pulumi_vsphere/get_datastore.py +9 -13
  20. pulumi_vsphere/get_datastore_cluster.py +0 -4
  21. pulumi_vsphere/get_datastore_stats.py +38 -44
  22. pulumi_vsphere/get_distributed_virtual_switch.py +2 -4
  23. pulumi_vsphere/get_dynamic.py +18 -20
  24. pulumi_vsphere/get_folder.py +10 -6
  25. pulumi_vsphere/get_guest_os_customization.py +8 -47
  26. pulumi_vsphere/get_host.py +0 -4
  27. pulumi_vsphere/get_host_base_images.py +97 -0
  28. pulumi_vsphere/get_host_pci_device.py +8 -14
  29. pulumi_vsphere/get_host_thumbprint.py +12 -16
  30. pulumi_vsphere/get_host_vgpu_profile.py +4 -10
  31. pulumi_vsphere/get_license.py +2 -5
  32. pulumi_vsphere/get_network.py +14 -18
  33. pulumi_vsphere/get_policy.py +0 -4
  34. pulumi_vsphere/get_resource_pool.py +14 -18
  35. pulumi_vsphere/get_role.py +4 -8
  36. pulumi_vsphere/get_tag.py +0 -4
  37. pulumi_vsphere/get_tag_category.py +0 -4
  38. pulumi_vsphere/get_vapp_container.py +0 -4
  39. pulumi_vsphere/get_virtual_machine.py +58 -41
  40. pulumi_vsphere/get_vmfs_disks.py +0 -4
  41. pulumi_vsphere/guest_os_customization.py +50 -0
  42. pulumi_vsphere/ha_vm_override.py +189 -378
  43. pulumi_vsphere/host.py +0 -20
  44. pulumi_vsphere/host_port_group.py +12 -24
  45. pulumi_vsphere/host_virtual_switch.py +140 -287
  46. pulumi_vsphere/license.py +0 -32
  47. pulumi_vsphere/nas_datastore.py +7 -7
  48. pulumi_vsphere/offline_software_depot.py +180 -0
  49. pulumi_vsphere/outputs.py +591 -270
  50. pulumi_vsphere/provider.py +2 -6
  51. pulumi_vsphere/pulumi-plugin.json +2 -1
  52. pulumi_vsphere/resource_pool.py +50 -24
  53. pulumi_vsphere/supervisor.py +962 -0
  54. pulumi_vsphere/virtual_disk.py +14 -20
  55. pulumi_vsphere/virtual_machine.py +580 -809
  56. pulumi_vsphere/virtual_machine_class.py +442 -0
  57. pulumi_vsphere/virtual_machine_snapshot.py +8 -12
  58. pulumi_vsphere/vm_storage_policy.py +74 -86
  59. pulumi_vsphere/vnic.py +61 -77
  60. {pulumi_vsphere-4.10.0a1710245029.dist-info → pulumi_vsphere-4.10.2.dist-info}/METADATA +1 -1
  61. pulumi_vsphere-4.10.2.dist-info/RECORD +86 -0
  62. {pulumi_vsphere-4.10.0a1710245029.dist-info → pulumi_vsphere-4.10.2.dist-info}/WHEEL +1 -1
  63. pulumi_vsphere-4.10.0a1710245029.dist-info/RECORD +0 -82
  64. {pulumi_vsphere-4.10.0a1710245029.dist-info → pulumi_vsphere-4.10.2.dist-info}/top_level.txt +0 -0
@@ -63,14 +63,12 @@ def get_datacenter(name: Optional[str] = None,
63
63
 
64
64
  ## Example Usage
65
65
 
66
- <!--Start PulumiCodeChooser -->
67
66
  ```python
68
67
  import pulumi
69
68
  import pulumi_vsphere as vsphere
70
69
 
71
70
  datacenter = vsphere.get_datacenter(name="dc-01")
72
71
  ```
73
- <!--End PulumiCodeChooser -->
74
72
 
75
73
 
76
74
  :param str name: The name of the datacenter. This can be a name or path.
@@ -102,14 +100,12 @@ def get_datacenter_output(name: Optional[pulumi.Input[Optional[str]]] = None,
102
100
 
103
101
  ## Example Usage
104
102
 
105
- <!--Start PulumiCodeChooser -->
106
103
  ```python
107
104
  import pulumi
108
105
  import pulumi_vsphere as vsphere
109
106
 
110
107
  datacenter = vsphere.get_datacenter(name="dc-01")
111
108
  ```
112
- <!--End PulumiCodeChooser -->
113
109
 
114
110
 
115
111
  :param str name: The name of the datacenter. This can be a name or path.
@@ -57,9 +57,9 @@ class GetDatastoreResult:
57
57
  @pulumi.getter
58
58
  def stats(self) -> Optional[Mapping[str, Any]]:
59
59
  """
60
- The disk space usage statistics for the specific datastore. The total
61
- datastore capacity is represented as `capacity` and the free remaining disk is
62
- represented as `free`.
60
+ The disk space usage statistics for the specific datastore. The
61
+ total datastore capacity is represented as `capacity` and the free remaining
62
+ disk is represented as `free`.
63
63
  """
64
64
  return pulumi.get(self, "stats")
65
65
 
@@ -88,7 +88,6 @@ def get_datastore(datacenter_id: Optional[str] = None,
88
88
 
89
89
  ## Example Usage
90
90
 
91
- <!--Start PulumiCodeChooser -->
92
91
  ```python
93
92
  import pulumi
94
93
  import pulumi_vsphere as vsphere
@@ -97,7 +96,6 @@ def get_datastore(datacenter_id: Optional[str] = None,
97
96
  datastore = vsphere.get_datastore(name="datastore-01",
98
97
  datacenter_id=datacenter.id)
99
98
  ```
100
- <!--End PulumiCodeChooser -->
101
99
 
102
100
 
103
101
  :param str datacenter_id: The managed object reference ID
@@ -105,9 +103,9 @@ def get_datastore(datacenter_id: Optional[str] = None,
105
103
  search path used in `name` is an absolute path. For default datacenters, use
106
104
  the `id` attribute from an empty `Datacenter` data source.
107
105
  :param str name: The name of the datastore. This can be a name or path.
108
- :param Mapping[str, Any] stats: The disk space usage statistics for the specific datastore. The total
109
- datastore capacity is represented as `capacity` and the free remaining disk is
110
- represented as `free`.
106
+ :param Mapping[str, Any] stats: The disk space usage statistics for the specific datastore. The
107
+ total datastore capacity is represented as `capacity` and the free remaining
108
+ disk is represented as `free`.
111
109
  """
112
110
  __args__ = dict()
113
111
  __args__['datacenterId'] = datacenter_id
@@ -136,7 +134,6 @@ def get_datastore_output(datacenter_id: Optional[pulumi.Input[Optional[str]]] =
136
134
 
137
135
  ## Example Usage
138
136
 
139
- <!--Start PulumiCodeChooser -->
140
137
  ```python
141
138
  import pulumi
142
139
  import pulumi_vsphere as vsphere
@@ -145,7 +142,6 @@ def get_datastore_output(datacenter_id: Optional[pulumi.Input[Optional[str]]] =
145
142
  datastore = vsphere.get_datastore(name="datastore-01",
146
143
  datacenter_id=datacenter.id)
147
144
  ```
148
- <!--End PulumiCodeChooser -->
149
145
 
150
146
 
151
147
  :param str datacenter_id: The managed object reference ID
@@ -153,8 +149,8 @@ def get_datastore_output(datacenter_id: Optional[pulumi.Input[Optional[str]]] =
153
149
  search path used in `name` is an absolute path. For default datacenters, use
154
150
  the `id` attribute from an empty `Datacenter` data source.
155
151
  :param str name: The name of the datastore. This can be a name or path.
156
- :param Mapping[str, Any] stats: The disk space usage statistics for the specific datastore. The total
157
- datastore capacity is represented as `capacity` and the free remaining disk is
158
- represented as `free`.
152
+ :param Mapping[str, Any] stats: The disk space usage statistics for the specific datastore. The
153
+ total datastore capacity is represented as `capacity` and the free remaining
154
+ disk is represented as `free`.
159
155
  """
160
156
  ...
@@ -73,7 +73,6 @@ def get_datastore_cluster(datacenter_id: Optional[str] = None,
73
73
 
74
74
  ## Example Usage
75
75
 
76
- <!--Start PulumiCodeChooser -->
77
76
  ```python
78
77
  import pulumi
79
78
  import pulumi_vsphere as vsphere
@@ -82,7 +81,6 @@ def get_datastore_cluster(datacenter_id: Optional[str] = None,
82
81
  datastore_cluster = vsphere.get_datastore_cluster(name="datastore-cluster-01",
83
82
  datacenter_id=datacenter.id)
84
83
  ```
85
- <!--End PulumiCodeChooser -->
86
84
 
87
85
 
88
86
  :param str datacenter_id: The managed object reference
@@ -116,7 +114,6 @@ def get_datastore_cluster_output(datacenter_id: Optional[pulumi.Input[Optional[s
116
114
 
117
115
  ## Example Usage
118
116
 
119
- <!--Start PulumiCodeChooser -->
120
117
  ```python
121
118
  import pulumi
122
119
  import pulumi_vsphere as vsphere
@@ -125,7 +122,6 @@ def get_datastore_cluster_output(datacenter_id: Optional[pulumi.Input[Optional[s
125
122
  datastore_cluster = vsphere.get_datastore_cluster(name="datastore-cluster-01",
126
123
  datacenter_id=datacenter.id)
127
124
  ```
128
- <!--End PulumiCodeChooser -->
129
125
 
130
126
 
131
127
  :param str datacenter_id: The managed object reference
@@ -39,8 +39,8 @@ class GetDatastoreStatsResult:
39
39
  @pulumi.getter
40
40
  def capacity(self) -> Optional[Mapping[str, Any]]:
41
41
  """
42
- A mapping of the capacity for all datastore in the datacenter
43
- , where the name of the datastore is used as key and the capacity as value.
42
+ A mapping of the capacity for all datastore in the datacenter,
43
+ where the name of the datastore is used as key and the capacity as value.
44
44
  """
45
45
  return pulumi.get(self, "capacity")
46
46
 
@@ -48,8 +48,8 @@ class GetDatastoreStatsResult:
48
48
  @pulumi.getter(name="datacenterId")
49
49
  def datacenter_id(self) -> str:
50
50
  """
51
- The [managed object reference ID][docs-about-morefs]
52
- of the datacenter the datastores are located in.
51
+ The [managed object reference ID][docs-about-morefs] of the
52
+ datacenter the datastores are located in.
53
53
  """
54
54
  return pulumi.get(self, "datacenter_id")
55
55
 
@@ -58,8 +58,8 @@ class GetDatastoreStatsResult:
58
58
  def free_space(self) -> Optional[Mapping[str, Any]]:
59
59
  """
60
60
  A mapping of the free space for each datastore in the
61
- datacenter, where the name of the datastore is used as key and the free
62
- space as value.
61
+ datacenter, where the name of the datastore is used as key and the free space
62
+ as value.
63
63
  """
64
64
  return pulumi.get(self, "free_space")
65
65
 
@@ -89,13 +89,13 @@ def get_datastore_stats(capacity: Optional[Mapping[str, Any]] = None,
89
89
  free_space: Optional[Mapping[str, Any]] = None,
90
90
  opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetDatastoreStatsResult:
91
91
  """
92
- The `get_datastore_stats` data source can be used to retrieve the usage stats
93
- of all vSphere datastore objects in a datacenter. This can then be used as a
94
- standalone datasource to get information required as input to other data sources.
92
+ The `get_datastore_stats` data source can be used to retrieve the usage
93
+ stats of all vSphere datastore objects in a datacenter. This can then be used as
94
+ a standalone data source to get information required as input to other data
95
+ sources.
95
96
 
96
97
  ## Example Usage
97
98
 
98
- <!--Start PulumiCodeChooser -->
99
99
  ```python
100
100
  import pulumi
101
101
  import pulumi_vsphere as vsphere
@@ -103,36 +103,33 @@ def get_datastore_stats(capacity: Optional[Mapping[str, Any]] = None,
103
103
  datacenter = vsphere.get_datacenter(name="dc-01")
104
104
  datastore_stats = vsphere.get_datastore_stats(datacenter_id=datacenter.id)
105
105
  ```
106
- <!--End PulumiCodeChooser -->
107
106
 
108
- A usefull example of this datasource would be to determine the
109
- datastore with the most free space. For example, in addition to
110
- the above:
107
+ A useful example of this data source would be to determine the datastore with
108
+ the most free space. For example, in addition to the above:
111
109
 
112
110
  Create an `outputs.tf` like that:
113
111
 
114
- <!--Start PulumiCodeChooser -->
115
112
  ```python
116
113
  import pulumi
117
114
 
118
- pulumi.export("maxFreeSpaceName", local["max_free_space_name"])
119
- pulumi.export("maxFreeSpace", local["max_free_space"])
115
+ pulumi.export("maxFreeSpaceName", their_max_free_space_name)
116
+ pulumi.export("maxFreeSpace", their_max_free_space)
120
117
  ```
121
- <!--End PulumiCodeChooser -->
122
118
 
123
119
  and a `locals.tf` like that:
124
120
 
125
121
 
126
- :param Mapping[str, Any] capacity: A mapping of the capacity for all datastore in the datacenter
127
- , where the name of the datastore is used as key and the capacity as value.
128
- :param str datacenter_id: The [managed object reference ID][docs-about-morefs]
129
- of the datacenter the datastores are located in. For default datacenters, use
130
- the `id` attribute from an empty `Datacenter` data source.
122
+ :param Mapping[str, Any] capacity: A mapping of the capacity for all datastore in the datacenter,
123
+ where the name of the datastore is used as key and the capacity as value.
124
+ :param str datacenter_id: The
125
+ [managed object reference ID][docs-about-morefs] of the datacenter the
126
+ datastores are located in. For default datacenters, use the `id` attribute
127
+ from an empty `Datacenter` data source.
131
128
 
132
129
  [docs-about-morefs]: /docs/providers/vsphere/index.html#use-of-managed-object-references-by-the-vsphere-provider
133
130
  :param Mapping[str, Any] free_space: A mapping of the free space for each datastore in the
134
- datacenter, where the name of the datastore is used as key and the free
135
- space as value.
131
+ datacenter, where the name of the datastore is used as key and the free space
132
+ as value.
136
133
  """
137
134
  __args__ = dict()
138
135
  __args__['capacity'] = capacity
@@ -154,13 +151,13 @@ def get_datastore_stats_output(capacity: Optional[pulumi.Input[Optional[Mapping[
154
151
  free_space: Optional[pulumi.Input[Optional[Mapping[str, Any]]]] = None,
155
152
  opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetDatastoreStatsResult]:
156
153
  """
157
- The `get_datastore_stats` data source can be used to retrieve the usage stats
158
- of all vSphere datastore objects in a datacenter. This can then be used as a
159
- standalone datasource to get information required as input to other data sources.
154
+ The `get_datastore_stats` data source can be used to retrieve the usage
155
+ stats of all vSphere datastore objects in a datacenter. This can then be used as
156
+ a standalone data source to get information required as input to other data
157
+ sources.
160
158
 
161
159
  ## Example Usage
162
160
 
163
- <!--Start PulumiCodeChooser -->
164
161
  ```python
165
162
  import pulumi
166
163
  import pulumi_vsphere as vsphere
@@ -168,35 +165,32 @@ def get_datastore_stats_output(capacity: Optional[pulumi.Input[Optional[Mapping[
168
165
  datacenter = vsphere.get_datacenter(name="dc-01")
169
166
  datastore_stats = vsphere.get_datastore_stats(datacenter_id=datacenter.id)
170
167
  ```
171
- <!--End PulumiCodeChooser -->
172
168
 
173
- A usefull example of this datasource would be to determine the
174
- datastore with the most free space. For example, in addition to
175
- the above:
169
+ A useful example of this data source would be to determine the datastore with
170
+ the most free space. For example, in addition to the above:
176
171
 
177
172
  Create an `outputs.tf` like that:
178
173
 
179
- <!--Start PulumiCodeChooser -->
180
174
  ```python
181
175
  import pulumi
182
176
 
183
- pulumi.export("maxFreeSpaceName", local["max_free_space_name"])
184
- pulumi.export("maxFreeSpace", local["max_free_space"])
177
+ pulumi.export("maxFreeSpaceName", their_max_free_space_name)
178
+ pulumi.export("maxFreeSpace", their_max_free_space)
185
179
  ```
186
- <!--End PulumiCodeChooser -->
187
180
 
188
181
  and a `locals.tf` like that:
189
182
 
190
183
 
191
- :param Mapping[str, Any] capacity: A mapping of the capacity for all datastore in the datacenter
192
- , where the name of the datastore is used as key and the capacity as value.
193
- :param str datacenter_id: The [managed object reference ID][docs-about-morefs]
194
- of the datacenter the datastores are located in. For default datacenters, use
195
- the `id` attribute from an empty `Datacenter` data source.
184
+ :param Mapping[str, Any] capacity: A mapping of the capacity for all datastore in the datacenter,
185
+ where the name of the datastore is used as key and the capacity as value.
186
+ :param str datacenter_id: The
187
+ [managed object reference ID][docs-about-morefs] of the datacenter the
188
+ datastores are located in. For default datacenters, use the `id` attribute
189
+ from an empty `Datacenter` data source.
196
190
 
197
191
  [docs-about-morefs]: /docs/providers/vsphere/index.html#use-of-managed-object-references-by-the-vsphere-provider
198
192
  :param Mapping[str, Any] free_space: A mapping of the free space for each datastore in the
199
- datacenter, where the name of the datastore is used as key and the free
200
- space as value.
193
+ datacenter, where the name of the datastore is used as key and the free space
194
+ as value.
201
195
  """
202
196
  ...
@@ -97,7 +97,6 @@ def get_distributed_virtual_switch(datacenter_id: Optional[str] = None,
97
97
  `DistributedPortGroup` resource that uses the first uplink as a
98
98
  primary uplink and the second uplink as a secondary.
99
99
 
100
- <!--Start PulumiCodeChooser -->
101
100
  ```python
102
101
  import pulumi
103
102
  import pulumi_vsphere as vsphere
@@ -106,11 +105,11 @@ def get_distributed_virtual_switch(datacenter_id: Optional[str] = None,
106
105
  vds = vsphere.get_distributed_virtual_switch(name="vds-01",
107
106
  datacenter_id=datacenter.id)
108
107
  dvpg = vsphere.DistributedPortGroup("dvpg",
108
+ name="dvpg-01",
109
109
  distributed_virtual_switch_uuid=vds.id,
110
110
  active_uplinks=[vds.uplinks[0]],
111
111
  standby_uplinks=[vds.uplinks[1]])
112
112
  ```
113
- <!--End PulumiCodeChooser -->
114
113
 
115
114
 
116
115
  :param str datacenter_id: The managed object reference ID
@@ -153,7 +152,6 @@ def get_distributed_virtual_switch_output(datacenter_id: Optional[pulumi.Input[O
153
152
  `DistributedPortGroup` resource that uses the first uplink as a
154
153
  primary uplink and the second uplink as a secondary.
155
154
 
156
- <!--Start PulumiCodeChooser -->
157
155
  ```python
158
156
  import pulumi
159
157
  import pulumi_vsphere as vsphere
@@ -162,11 +160,11 @@ def get_distributed_virtual_switch_output(datacenter_id: Optional[pulumi.Input[O
162
160
  vds = vsphere.get_distributed_virtual_switch(name="vds-01",
163
161
  datacenter_id=datacenter.id)
164
162
  dvpg = vsphere.DistributedPortGroup("dvpg",
163
+ name="dvpg-01",
165
164
  distributed_virtual_switch_uuid=vds.id,
166
165
  active_uplinks=[vds.uplinks[0]],
167
166
  standby_uplinks=[vds.uplinks[1]])
168
167
  ```
169
- <!--End PulumiCodeChooser -->
170
168
 
171
169
 
172
170
  :param str datacenter_id: The managed object reference ID
@@ -78,22 +78,22 @@ def get_dynamic(filters: Optional[Sequence[str]] = None,
78
78
  """
79
79
  [docs-about-morefs]: /docs/providers/vsphere/index.html#use-of-managed-object-references-by-the-vsphere-provider
80
80
 
81
- The `get_dynamic` data source can be used to get the [managed object reference ID][docs-about-morefs]
82
- of any tagged managed object in vCenter Server by providing a list of tag IDs
83
- and an optional regular expression to filter objects by name.
81
+ The `get_dynamic` data source can be used to get the
82
+ [managed object reference ID][docs-about-morefs] of any tagged managed object in
83
+ vCenter Server by providing a list of tag IDs and an optional regular expression
84
+ to filter objects by name.
84
85
 
85
86
  ## Example Usage
86
87
 
87
- <!--Start PulumiCodeChooser -->
88
88
  ```python
89
89
  import pulumi
90
90
  import pulumi_vsphere as vsphere
91
91
 
92
92
  category = vsphere.get_tag_category(name="SomeCategory")
93
93
  tag1 = vsphere.get_tag(name="FirstTag",
94
- category_id=data["vsphere_tag_category"]["cat"]["id"])
94
+ category_id=cat["id"])
95
95
  tag2 = vsphere.get_tag(name="SecondTag",
96
- category_id=data["vsphere_tag_category"]["cat"]["id"])
96
+ category_id=cat["id"])
97
97
  dyn = vsphere.get_dynamic(filters=[
98
98
  tag1.id,
99
99
  tag1.id,
@@ -101,16 +101,15 @@ def get_dynamic(filters: Optional[Sequence[str]] = None,
101
101
  name_regex="ubuntu",
102
102
  type="Datacenter")
103
103
  ```
104
- <!--End PulumiCodeChooser -->
105
104
 
106
105
 
107
106
  :param Sequence[str] filters: A list of tag IDs that must be present on an object to
108
107
  be a match.
109
- :param str name_regex: A regular expression that will be used to match
110
- the object's name.
108
+ :param str name_regex: A regular expression that will be used to match the
109
+ object's name.
111
110
  :param str type: The managed object type the returned object must match.
112
111
  The managed object types can be found in the managed object type section
113
- [here](https://developer.vmware.com/apis/968/vsphere).
112
+ [here](https://developer.broadcom.com/xapis/vsphere-web-services-api/latest/).
114
113
  """
115
114
  __args__ = dict()
116
115
  __args__['filters'] = filters
@@ -134,22 +133,22 @@ def get_dynamic_output(filters: Optional[pulumi.Input[Sequence[str]]] = None,
134
133
  """
135
134
  [docs-about-morefs]: /docs/providers/vsphere/index.html#use-of-managed-object-references-by-the-vsphere-provider
136
135
 
137
- The `get_dynamic` data source can be used to get the [managed object reference ID][docs-about-morefs]
138
- of any tagged managed object in vCenter Server by providing a list of tag IDs
139
- and an optional regular expression to filter objects by name.
136
+ The `get_dynamic` data source can be used to get the
137
+ [managed object reference ID][docs-about-morefs] of any tagged managed object in
138
+ vCenter Server by providing a list of tag IDs and an optional regular expression
139
+ to filter objects by name.
140
140
 
141
141
  ## Example Usage
142
142
 
143
- <!--Start PulumiCodeChooser -->
144
143
  ```python
145
144
  import pulumi
146
145
  import pulumi_vsphere as vsphere
147
146
 
148
147
  category = vsphere.get_tag_category(name="SomeCategory")
149
148
  tag1 = vsphere.get_tag(name="FirstTag",
150
- category_id=data["vsphere_tag_category"]["cat"]["id"])
149
+ category_id=cat["id"])
151
150
  tag2 = vsphere.get_tag(name="SecondTag",
152
- category_id=data["vsphere_tag_category"]["cat"]["id"])
151
+ category_id=cat["id"])
153
152
  dyn = vsphere.get_dynamic(filters=[
154
153
  tag1.id,
155
154
  tag1.id,
@@ -157,15 +156,14 @@ def get_dynamic_output(filters: Optional[pulumi.Input[Sequence[str]]] = None,
157
156
  name_regex="ubuntu",
158
157
  type="Datacenter")
159
158
  ```
160
- <!--End PulumiCodeChooser -->
161
159
 
162
160
 
163
161
  :param Sequence[str] filters: A list of tag IDs that must be present on an object to
164
162
  be a match.
165
- :param str name_regex: A regular expression that will be used to match
166
- the object's name.
163
+ :param str name_regex: A regular expression that will be used to match the
164
+ object's name.
167
165
  :param str type: The managed object type the returned object must match.
168
166
  The managed object types can be found in the managed object type section
169
- [here](https://developer.vmware.com/apis/968/vsphere).
167
+ [here](https://developer.broadcom.com/xapis/vsphere-web-services-api/latest/).
170
168
  """
171
169
  ...
@@ -57,18 +57,20 @@ def get_folder(path: Optional[str] = None,
57
57
  opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetFolderResult:
58
58
  """
59
59
  The `Folder` data source can be used to get the general attributes of a
60
- vSphere inventory folder. Paths are absolute and must include the datacenter.
60
+ vSphere inventory folder. The data source supports creating folders of the 5
61
+ major types - datacenter folders, host and cluster folders, virtual machine
62
+ folders, storage folders, and network folders.
63
+
64
+ Paths are absolute and must include the datacenter.
61
65
 
62
66
  ## Example Usage
63
67
 
64
- <!--Start PulumiCodeChooser -->
65
68
  ```python
66
69
  import pulumi
67
70
  import pulumi_vsphere as vsphere
68
71
 
69
72
  folder = vsphere.get_folder(path="/dc-01/datastore-01/folder-01")
70
73
  ```
71
- <!--End PulumiCodeChooser -->
72
74
 
73
75
 
74
76
  :param str path: The absolute path of the folder. For example, given a
@@ -92,18 +94,20 @@ def get_folder_output(path: Optional[pulumi.Input[str]] = None,
92
94
  opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetFolderResult]:
93
95
  """
94
96
  The `Folder` data source can be used to get the general attributes of a
95
- vSphere inventory folder. Paths are absolute and must include the datacenter.
97
+ vSphere inventory folder. The data source supports creating folders of the 5
98
+ major types - datacenter folders, host and cluster folders, virtual machine
99
+ folders, storage folders, and network folders.
100
+
101
+ Paths are absolute and must include the datacenter.
96
102
 
97
103
  ## Example Usage
98
104
 
99
- <!--Start PulumiCodeChooser -->
100
105
  ```python
101
106
  import pulumi
102
107
  import pulumi_vsphere as vsphere
103
108
 
104
109
  folder = vsphere.get_folder(path="/dc-01/datastore-01/folder-01")
105
110
  ```
106
- <!--End PulumiCodeChooser -->
107
111
 
108
112
 
109
113
  :param str path: The absolute path of the folder. For example, given a
@@ -48,17 +48,11 @@ class GetGuestOsCustomizationResult:
48
48
  @property
49
49
  @pulumi.getter(name="changeVersion")
50
50
  def change_version(self) -> str:
51
- """
52
- The number of last changed version to the customization specification.
53
- """
54
51
  return pulumi.get(self, "change_version")
55
52
 
56
53
  @property
57
54
  @pulumi.getter
58
55
  def description(self) -> str:
59
- """
60
- The description for the customization specification.
61
- """
62
56
  return pulumi.get(self, "description")
63
57
 
64
58
  @property
@@ -72,9 +66,6 @@ class GetGuestOsCustomizationResult:
72
66
  @property
73
67
  @pulumi.getter(name="lastUpdateTime")
74
68
  def last_update_time(self) -> str:
75
- """
76
- The time of last modification to the customization specification.
77
- """
78
69
  return pulumi.get(self, "last_update_time")
79
70
 
80
71
  @property
@@ -85,17 +76,11 @@ class GetGuestOsCustomizationResult:
85
76
  @property
86
77
  @pulumi.getter
87
78
  def specs(self) -> Sequence['outputs.GetGuestOsCustomizationSpecResult']:
88
- """
89
- Container object for the guest operating system properties to be customized. See virtual machine customizations
90
- """
91
79
  return pulumi.get(self, "specs")
92
80
 
93
81
  @property
94
82
  @pulumi.getter
95
83
  def type(self) -> str:
96
- """
97
- The type of customization specification: One among: Windows, Linux.
98
- """
99
84
  return pulumi.get(self, "type")
100
85
 
101
86
 
@@ -117,24 +102,12 @@ class AwaitableGetGuestOsCustomizationResult(GetGuestOsCustomizationResult):
117
102
  def get_guest_os_customization(name: Optional[str] = None,
118
103
  opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetGuestOsCustomizationResult:
119
104
  """
120
- The `GuestOsCustomization` data source can be used to discover the details about a customization specification for a guest operating system.
121
-
122
- Suggested change
123
- > **NOTE:** The name attribute is the unique identifier for the customization specification per vCenter Server instance.
124
-
125
- ## Example Usage
126
-
127
- <!--Start PulumiCodeChooser -->
128
- ```python
129
- import pulumi
130
- import pulumi_vsphere as vsphere
131
-
132
- gosc1 = vsphere.get_guest_os_customization(name="linux-spec")
133
- ```
134
- <!--End PulumiCodeChooser -->
105
+ The `GuestOsCustomization` data source can be used to discover the
106
+ details about a customization specification for a guest operating system.
135
107
 
136
108
 
137
- :param str name: The name of the customization specification is the unique identifier per vCenter Server instance.
109
+ :param str name: The name of the customization specification is the unique
110
+ identifier per vCenter Server instance. ## Attribute Reference
138
111
  """
139
112
  __args__ = dict()
140
113
  __args__['name'] = name
@@ -155,23 +128,11 @@ def get_guest_os_customization(name: Optional[str] = None,
155
128
  def get_guest_os_customization_output(name: Optional[pulumi.Input[str]] = None,
156
129
  opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetGuestOsCustomizationResult]:
157
130
  """
158
- The `GuestOsCustomization` data source can be used to discover the details about a customization specification for a guest operating system.
159
-
160
- Suggested change
161
- > **NOTE:** The name attribute is the unique identifier for the customization specification per vCenter Server instance.
162
-
163
- ## Example Usage
164
-
165
- <!--Start PulumiCodeChooser -->
166
- ```python
167
- import pulumi
168
- import pulumi_vsphere as vsphere
169
-
170
- gosc1 = vsphere.get_guest_os_customization(name="linux-spec")
171
- ```
172
- <!--End PulumiCodeChooser -->
131
+ The `GuestOsCustomization` data source can be used to discover the
132
+ details about a customization specification for a guest operating system.
173
133
 
174
134
 
175
- :param str name: The name of the customization specification is the unique identifier per vCenter Server instance.
135
+ :param str name: The name of the customization specification is the unique
136
+ identifier per vCenter Server instance. ## Attribute Reference
176
137
  """
177
138
  ...
@@ -85,7 +85,6 @@ def get_host(datacenter_id: Optional[str] = None,
85
85
 
86
86
  ## Example Usage
87
87
 
88
- <!--Start PulumiCodeChooser -->
89
88
  ```python
90
89
  import pulumi
91
90
  import pulumi_vsphere as vsphere
@@ -94,7 +93,6 @@ def get_host(datacenter_id: Optional[str] = None,
94
93
  host = vsphere.get_host(name="esxi-01.example.com",
95
94
  datacenter_id=datacenter.id)
96
95
  ```
97
- <!--End PulumiCodeChooser -->
98
96
 
99
97
 
100
98
  :param str datacenter_id: The managed object reference ID
@@ -129,7 +127,6 @@ def get_host_output(datacenter_id: Optional[pulumi.Input[str]] = None,
129
127
 
130
128
  ## Example Usage
131
129
 
132
- <!--Start PulumiCodeChooser -->
133
130
  ```python
134
131
  import pulumi
135
132
  import pulumi_vsphere as vsphere
@@ -138,7 +135,6 @@ def get_host_output(datacenter_id: Optional[pulumi.Input[str]] = None,
138
135
  host = vsphere.get_host(name="esxi-01.example.com",
139
136
  datacenter_id=datacenter.id)
140
137
  ```
141
- <!--End PulumiCodeChooser -->
142
138
 
143
139
 
144
140
  :param str datacenter_id: The managed object reference ID