pulumi-vsphere 4.10.0a1709017641__py3-none-any.whl → 4.17.0a1763710194__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 (89) hide show
  1. pulumi_vsphere/__init__.py +51 -1
  2. pulumi_vsphere/_inputs.py +2568 -1025
  3. pulumi_vsphere/_utilities.py +50 -10
  4. pulumi_vsphere/compute_cluster.py +1564 -2373
  5. pulumi_vsphere/compute_cluster_host_group.py +191 -55
  6. pulumi_vsphere/compute_cluster_vm_affinity_rule.py +157 -113
  7. pulumi_vsphere/compute_cluster_vm_anti_affinity_rule.py +133 -89
  8. pulumi_vsphere/compute_cluster_vm_dependency_rule.py +314 -106
  9. pulumi_vsphere/compute_cluster_vm_group.py +256 -55
  10. pulumi_vsphere/compute_cluster_vm_host_rule.py +323 -123
  11. pulumi_vsphere/config/__init__.py +2 -1
  12. pulumi_vsphere/config/__init__.pyi +7 -2
  13. pulumi_vsphere/config/vars.py +20 -15
  14. pulumi_vsphere/configuration_profile.py +286 -0
  15. pulumi_vsphere/content_library.py +177 -71
  16. pulumi_vsphere/content_library_item.py +252 -106
  17. pulumi_vsphere/custom_attribute.py +118 -38
  18. pulumi_vsphere/datacenter.py +128 -107
  19. pulumi_vsphere/datastore_cluster.py +636 -731
  20. pulumi_vsphere/datastore_cluster_vm_anti_affinity_rule.py +251 -89
  21. pulumi_vsphere/distributed_port_group.py +1129 -967
  22. pulumi_vsphere/distributed_virtual_switch.py +1971 -2239
  23. pulumi_vsphere/distributed_virtual_switch_pvlan_mapping.py +294 -0
  24. pulumi_vsphere/dpm_host_override.py +222 -72
  25. pulumi_vsphere/drs_vm_override.py +236 -72
  26. pulumi_vsphere/entity_permissions.py +96 -69
  27. pulumi_vsphere/file.py +173 -178
  28. pulumi_vsphere/folder.py +236 -113
  29. pulumi_vsphere/get_compute_cluster.py +34 -23
  30. pulumi_vsphere/get_compute_cluster_host_group.py +52 -41
  31. pulumi_vsphere/get_configuration_profile.py +145 -0
  32. pulumi_vsphere/get_content_library.py +33 -21
  33. pulumi_vsphere/get_content_library_item.py +47 -31
  34. pulumi_vsphere/get_custom_attribute.py +26 -17
  35. pulumi_vsphere/get_datacenter.py +40 -18
  36. pulumi_vsphere/get_datastore.py +60 -24
  37. pulumi_vsphere/get_datastore_cluster.py +47 -22
  38. pulumi_vsphere/get_datastore_stats.py +204 -0
  39. pulumi_vsphere/get_distributed_virtual_switch.py +36 -23
  40. pulumi_vsphere/get_dynamic.py +55 -45
  41. pulumi_vsphere/get_folder.py +163 -25
  42. pulumi_vsphere/get_guest_os_customization.py +68 -37
  43. pulumi_vsphere/get_host.py +34 -23
  44. pulumi_vsphere/get_host_base_images.py +104 -0
  45. pulumi_vsphere/get_host_pci_device.py +78 -35
  46. pulumi_vsphere/get_host_thumbprint.py +58 -38
  47. pulumi_vsphere/get_host_vgpu_profile.py +195 -0
  48. pulumi_vsphere/get_license.py +44 -28
  49. pulumi_vsphere/get_network.py +157 -46
  50. pulumi_vsphere/get_ovf_vm_template.py +184 -301
  51. pulumi_vsphere/get_policy.py +23 -15
  52. pulumi_vsphere/get_resource_pool.py +107 -40
  53. pulumi_vsphere/get_role.py +49 -35
  54. pulumi_vsphere/get_tag.py +34 -23
  55. pulumi_vsphere/get_tag_category.py +32 -21
  56. pulumi_vsphere/get_vapp_container.py +31 -21
  57. pulumi_vsphere/get_virtual_machine.py +499 -287
  58. pulumi_vsphere/get_vmfs_disks.py +42 -29
  59. pulumi_vsphere/guest_os_customization.py +135 -79
  60. pulumi_vsphere/ha_vm_override.py +470 -577
  61. pulumi_vsphere/host.py +515 -262
  62. pulumi_vsphere/host_port_group.py +352 -355
  63. pulumi_vsphere/host_virtual_switch.py +580 -580
  64. pulumi_vsphere/license.py +110 -92
  65. pulumi_vsphere/nas_datastore.py +398 -270
  66. pulumi_vsphere/offline_software_depot.py +190 -0
  67. pulumi_vsphere/outputs.py +1582 -1027
  68. pulumi_vsphere/provider.py +172 -152
  69. pulumi_vsphere/pulumi-plugin.json +2 -1
  70. pulumi_vsphere/resource_pool.py +357 -273
  71. pulumi_vsphere/role.py +79 -47
  72. pulumi_vsphere/storage_drs_vm_override.py +225 -89
  73. pulumi_vsphere/supervisor.py +1064 -0
  74. pulumi_vsphere/tag.py +217 -55
  75. pulumi_vsphere/tag_category.py +158 -72
  76. pulumi_vsphere/vapp_container.py +425 -259
  77. pulumi_vsphere/vapp_entity.py +324 -174
  78. pulumi_vsphere/virtual_disk.py +245 -153
  79. pulumi_vsphere/virtual_machine.py +1696 -1836
  80. pulumi_vsphere/virtual_machine_class.py +448 -0
  81. pulumi_vsphere/virtual_machine_snapshot.py +137 -131
  82. pulumi_vsphere/vm_storage_policy.py +160 -154
  83. pulumi_vsphere/vmfs_datastore.py +460 -186
  84. pulumi_vsphere/vnic.py +249 -231
  85. {pulumi_vsphere-4.10.0a1709017641.dist-info → pulumi_vsphere-4.17.0a1763710194.dist-info}/METADATA +7 -6
  86. pulumi_vsphere-4.17.0a1763710194.dist-info/RECORD +89 -0
  87. {pulumi_vsphere-4.10.0a1709017641.dist-info → pulumi_vsphere-4.17.0a1763710194.dist-info}/WHEEL +1 -1
  88. pulumi_vsphere-4.10.0a1709017641.dist-info/RECORD +0 -80
  89. {pulumi_vsphere-4.10.0a1709017641.dist-info → pulumi_vsphere-4.17.0a1763710194.dist-info}/top_level.txt +0 -0
@@ -1,12 +1,17 @@
1
1
  # coding=utf-8
2
- # *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
2
+ # *** WARNING: this file was generated by pulumi-language-python. ***
3
3
  # *** Do not edit by hand unless you're certain you know what you are doing! ***
4
4
 
5
- import copy
5
+ import builtins as _builtins
6
6
  import warnings
7
+ import sys
7
8
  import pulumi
8
9
  import pulumi.runtime
9
10
  from typing import Any, Mapping, Optional, Sequence, Union, overload
11
+ if sys.version_info >= (3, 11):
12
+ from typing import NotRequired, TypedDict, TypeAlias
13
+ else:
14
+ from typing_extensions import NotRequired, TypedDict, TypeAlias
10
15
  from . import _utilities
11
16
 
12
17
  __all__ = [
@@ -44,53 +49,56 @@ class GetLicenseResult:
44
49
  raise TypeError("Expected argument 'used' to be a int")
45
50
  pulumi.set(__self__, "used", used)
46
51
 
47
- @property
52
+ @_builtins.property
48
53
  @pulumi.getter(name="editionKey")
49
- def edition_key(self) -> str:
54
+ def edition_key(self) -> _builtins.str:
50
55
  """
51
56
  The product edition of the license key.
52
57
  """
53
58
  return pulumi.get(self, "edition_key")
54
59
 
55
- @property
60
+ @_builtins.property
56
61
  @pulumi.getter
57
- def id(self) -> str:
62
+ def id(self) -> _builtins.str:
63
+ """
64
+ The license key ID.
65
+ """
58
66
  return pulumi.get(self, "id")
59
67
 
60
- @property
68
+ @_builtins.property
61
69
  @pulumi.getter
62
- def labels(self) -> Mapping[str, str]:
70
+ def labels(self) -> Mapping[str, _builtins.str]:
63
71
  """
64
- A map of key/value pairs attached as labels (tags) to the license key.
72
+ A map of labels applied to the license key.
65
73
  """
66
74
  return pulumi.get(self, "labels")
67
75
 
68
- @property
76
+ @_builtins.property
69
77
  @pulumi.getter(name="licenseKey")
70
- def license_key(self) -> str:
78
+ def license_key(self) -> _builtins.str:
71
79
  return pulumi.get(self, "license_key")
72
80
 
73
- @property
81
+ @_builtins.property
74
82
  @pulumi.getter
75
- def name(self) -> str:
83
+ def name(self) -> _builtins.str:
76
84
  """
77
85
  The display name for the license.
78
86
  """
79
87
  return pulumi.get(self, "name")
80
88
 
81
- @property
89
+ @_builtins.property
82
90
  @pulumi.getter
83
- def total(self) -> int:
91
+ def total(self) -> _builtins.int:
84
92
  """
85
- Total number of units (example: CPUs) contained in the license.
93
+ The total number of units contained in the license key.
86
94
  """
87
95
  return pulumi.get(self, "total")
88
96
 
89
- @property
97
+ @_builtins.property
90
98
  @pulumi.getter
91
- def used(self) -> int:
99
+ def used(self) -> _builtins.int:
92
100
  """
93
- The number of units (example: CPUs) assigned to this license.
101
+ The number of units assigned to this license key.
94
102
  """
95
103
  return pulumi.get(self, "used")
96
104
 
@@ -110,7 +118,7 @@ class AwaitableGetLicenseResult(GetLicenseResult):
110
118
  used=self.used)
111
119
 
112
120
 
113
- def get_license(license_key: Optional[str] = None,
121
+ def get_license(license_key: Optional[_builtins.str] = None,
114
122
  opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetLicenseResult:
115
123
  """
116
124
  The `License` data source can be used to get the general attributes of
@@ -126,7 +134,7 @@ def get_license(license_key: Optional[str] = None,
126
134
  ```
127
135
 
128
136
 
129
- :param str license_key: The license key.
137
+ :param _builtins.str license_key: The license key value.
130
138
  """
131
139
  __args__ = dict()
132
140
  __args__['licenseKey'] = license_key
@@ -141,11 +149,8 @@ def get_license(license_key: Optional[str] = None,
141
149
  name=pulumi.get(__ret__, 'name'),
142
150
  total=pulumi.get(__ret__, 'total'),
143
151
  used=pulumi.get(__ret__, 'used'))
144
-
145
-
146
- @_utilities.lift_output_func(get_license)
147
- def get_license_output(license_key: Optional[pulumi.Input[str]] = None,
148
- opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetLicenseResult]:
152
+ def get_license_output(license_key: Optional[pulumi.Input[_builtins.str]] = None,
153
+ opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetLicenseResult]:
149
154
  """
150
155
  The `License` data source can be used to get the general attributes of
151
156
  a license keys from a vCenter Server instance.
@@ -160,6 +165,17 @@ def get_license_output(license_key: Optional[pulumi.Input[str]] = None,
160
165
  ```
161
166
 
162
167
 
163
- :param str license_key: The license key.
168
+ :param _builtins.str license_key: The license key value.
164
169
  """
165
- ...
170
+ __args__ = dict()
171
+ __args__['licenseKey'] = license_key
172
+ opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
173
+ __ret__ = pulumi.runtime.invoke_output('vsphere:index/getLicense:getLicense', __args__, opts=opts, typ=GetLicenseResult)
174
+ return __ret__.apply(lambda __response__: GetLicenseResult(
175
+ edition_key=pulumi.get(__response__, 'edition_key'),
176
+ id=pulumi.get(__response__, 'id'),
177
+ labels=pulumi.get(__response__, 'labels'),
178
+ license_key=pulumi.get(__response__, 'license_key'),
179
+ name=pulumi.get(__response__, 'name'),
180
+ total=pulumi.get(__response__, 'total'),
181
+ used=pulumi.get(__response__, 'used')))
@@ -1,13 +1,20 @@
1
1
  # coding=utf-8
2
- # *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
2
+ # *** WARNING: this file was generated by pulumi-language-python. ***
3
3
  # *** Do not edit by hand unless you're certain you know what you are doing! ***
4
4
 
5
- import copy
5
+ import builtins as _builtins
6
6
  import warnings
7
+ import sys
7
8
  import pulumi
8
9
  import pulumi.runtime
9
10
  from typing import Any, Mapping, Optional, Sequence, Union, overload
11
+ if sys.version_info >= (3, 11):
12
+ from typing import NotRequired, TypedDict, TypeAlias
13
+ else:
14
+ from typing_extensions import NotRequired, TypedDict, TypeAlias
10
15
  from . import _utilities
16
+ from . import outputs
17
+ from ._inputs import *
11
18
 
12
19
  __all__ = [
13
20
  'GetNetworkResult',
@@ -21,49 +28,76 @@ class GetNetworkResult:
21
28
  """
22
29
  A collection of values returned by getNetwork.
23
30
  """
24
- def __init__(__self__, datacenter_id=None, distributed_virtual_switch_uuid=None, id=None, name=None, type=None):
31
+ def __init__(__self__, datacenter_id=None, distributed_virtual_switch_uuid=None, filters=None, id=None, name=None, retry_interval=None, retry_timeout=None, type=None, vpc_id=None):
25
32
  if datacenter_id and not isinstance(datacenter_id, str):
26
33
  raise TypeError("Expected argument 'datacenter_id' to be a str")
27
34
  pulumi.set(__self__, "datacenter_id", datacenter_id)
28
35
  if distributed_virtual_switch_uuid and not isinstance(distributed_virtual_switch_uuid, str):
29
36
  raise TypeError("Expected argument 'distributed_virtual_switch_uuid' to be a str")
30
37
  pulumi.set(__self__, "distributed_virtual_switch_uuid", distributed_virtual_switch_uuid)
38
+ if filters and not isinstance(filters, list):
39
+ raise TypeError("Expected argument 'filters' to be a list")
40
+ pulumi.set(__self__, "filters", filters)
31
41
  if id and not isinstance(id, str):
32
42
  raise TypeError("Expected argument 'id' to be a str")
33
43
  pulumi.set(__self__, "id", id)
34
44
  if name and not isinstance(name, str):
35
45
  raise TypeError("Expected argument 'name' to be a str")
36
46
  pulumi.set(__self__, "name", name)
47
+ if retry_interval and not isinstance(retry_interval, int):
48
+ raise TypeError("Expected argument 'retry_interval' to be a int")
49
+ pulumi.set(__self__, "retry_interval", retry_interval)
50
+ if retry_timeout and not isinstance(retry_timeout, int):
51
+ raise TypeError("Expected argument 'retry_timeout' to be a int")
52
+ pulumi.set(__self__, "retry_timeout", retry_timeout)
37
53
  if type and not isinstance(type, str):
38
54
  raise TypeError("Expected argument 'type' to be a str")
39
55
  pulumi.set(__self__, "type", type)
56
+ if vpc_id and not isinstance(vpc_id, str):
57
+ raise TypeError("Expected argument 'vpc_id' to be a str")
58
+ pulumi.set(__self__, "vpc_id", vpc_id)
40
59
 
41
- @property
60
+ @_builtins.property
42
61
  @pulumi.getter(name="datacenterId")
43
- def datacenter_id(self) -> Optional[str]:
62
+ def datacenter_id(self) -> Optional[_builtins.str]:
44
63
  return pulumi.get(self, "datacenter_id")
45
64
 
46
- @property
65
+ @_builtins.property
47
66
  @pulumi.getter(name="distributedVirtualSwitchUuid")
48
- def distributed_virtual_switch_uuid(self) -> Optional[str]:
67
+ def distributed_virtual_switch_uuid(self) -> Optional[_builtins.str]:
49
68
  return pulumi.get(self, "distributed_virtual_switch_uuid")
50
69
 
51
- @property
70
+ @_builtins.property
52
71
  @pulumi.getter
53
- def id(self) -> str:
72
+ def filters(self) -> Optional[Sequence['outputs.GetNetworkFilterResult']]:
73
+ return pulumi.get(self, "filters")
74
+
75
+ @_builtins.property
76
+ @pulumi.getter
77
+ def id(self) -> _builtins.str:
54
78
  """
55
79
  The provider-assigned unique ID for this managed resource.
56
80
  """
57
81
  return pulumi.get(self, "id")
58
82
 
59
- @property
83
+ @_builtins.property
60
84
  @pulumi.getter
61
- def name(self) -> str:
85
+ def name(self) -> _builtins.str:
62
86
  return pulumi.get(self, "name")
63
87
 
64
- @property
88
+ @_builtins.property
89
+ @pulumi.getter(name="retryInterval")
90
+ def retry_interval(self) -> Optional[_builtins.int]:
91
+ return pulumi.get(self, "retry_interval")
92
+
93
+ @_builtins.property
94
+ @pulumi.getter(name="retryTimeout")
95
+ def retry_timeout(self) -> Optional[_builtins.int]:
96
+ return pulumi.get(self, "retry_timeout")
97
+
98
+ @_builtins.property
65
99
  @pulumi.getter
66
- def type(self) -> str:
100
+ def type(self) -> _builtins.str:
67
101
  """
68
102
  The managed object type for the discovered network. This will be one
69
103
  of `DistributedVirtualPortgroup` for distributed port groups, `Network` for
@@ -72,6 +106,11 @@ class GetNetworkResult:
72
106
  """
73
107
  return pulumi.get(self, "type")
74
108
 
109
+ @_builtins.property
110
+ @pulumi.getter(name="vpcId")
111
+ def vpc_id(self) -> Optional[_builtins.str]:
112
+ return pulumi.get(self, "vpc_id")
113
+
75
114
 
76
115
  class AwaitableGetNetworkResult(GetNetworkResult):
77
116
  # pylint: disable=using-constant-test
@@ -81,21 +120,29 @@ class AwaitableGetNetworkResult(GetNetworkResult):
81
120
  return GetNetworkResult(
82
121
  datacenter_id=self.datacenter_id,
83
122
  distributed_virtual_switch_uuid=self.distributed_virtual_switch_uuid,
123
+ filters=self.filters,
84
124
  id=self.id,
85
125
  name=self.name,
86
- type=self.type)
126
+ retry_interval=self.retry_interval,
127
+ retry_timeout=self.retry_timeout,
128
+ type=self.type,
129
+ vpc_id=self.vpc_id)
87
130
 
88
131
 
89
- def get_network(datacenter_id: Optional[str] = None,
90
- distributed_virtual_switch_uuid: Optional[str] = None,
91
- name: Optional[str] = None,
132
+ def get_network(datacenter_id: Optional[_builtins.str] = None,
133
+ distributed_virtual_switch_uuid: Optional[_builtins.str] = None,
134
+ filters: Optional[Sequence[Union['GetNetworkFilterArgs', 'GetNetworkFilterArgsDict']]] = None,
135
+ name: Optional[_builtins.str] = None,
136
+ retry_interval: Optional[_builtins.int] = None,
137
+ retry_timeout: Optional[_builtins.int] = None,
138
+ vpc_id: Optional[_builtins.str] = None,
92
139
  opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetNetworkResult:
93
140
  """
94
- The `get_network` data source can be used to discover the ID of a network
95
- in vSphere. This can be any network that can be used as the backing for a
96
- network interface for `VirtualMachine` or any other vSphere resource
97
- that requires a network. This includes standard (host-based) port groups,
98
- distributed port groups, or opaque networks such as those managed by NSX.
141
+ The `get_network` data source can be used to discover the ID of a network in
142
+ vSphere. This can be any network that can be used as the backing for a network
143
+ interface for `VirtualMachine` or any other vSphere resource that
144
+ requires a network. This includes standard (host-based) port groups, distributed
145
+ port groups, or opaque networks such as those managed by NSX.
99
146
 
100
147
  ## Example Usage
101
148
 
@@ -108,43 +155,70 @@ def get_network(datacenter_id: Optional[str] = None,
108
155
  datacenter_id=datacenter.id)
109
156
  ```
110
157
 
158
+ ### Additional Examples
159
+
160
+ ```python
161
+ import pulumi
162
+ import pulumi_vsphere as vsphere
163
+
164
+ datacenter = vsphere.get_datacenter(name="dc-01")
165
+ my_port_group = vsphere.get_network(datacenter_id=datacenter.id,
166
+ name="VM Network",
167
+ filters=[{
168
+ "network_type": "Network",
169
+ }])
170
+ ```
171
+
111
172
 
112
- :param str datacenter_id: The managed object reference ID
173
+ :param _builtins.str datacenter_id: The managed object reference ID
113
174
  of the datacenter the network is located in. This can be omitted if the
114
175
  search path used in `name` is an absolute path. For default datacenters,
115
176
  use the `id` attribute from an empty `Datacenter` data source.
116
- :param str distributed_virtual_switch_uuid: For distributed port group type
177
+ :param _builtins.str distributed_virtual_switch_uuid: For distributed port group type
117
178
  network objects, the ID of the distributed virtual switch for which the port
118
- group belongs. It is useful to differentiate port groups with same name
119
- using the distributed virtual switch ID.
120
- :param str name: The name of the network. This can be a name or path.
179
+ group belongs. It is useful to differentiate port groups with same name using
180
+ the distributed virtual switch ID.
181
+ :param Sequence[Union['GetNetworkFilterArgs', 'GetNetworkFilterArgsDict']] filters: Apply a filter for the discovered network.
182
+ :param _builtins.str name: The name of the network. This can be a name or path.
183
+ :param _builtins.int retry_interval: The interval in milliseconds to retry the read operation if `retry_timeout` is set. Default: 500.
184
+ :param _builtins.int retry_timeout: The timeout duration in seconds for the data source to retry read operations.
185
+ :param _builtins.str vpc_id: Select a VPC scope for retrieval of VPC subnets.
121
186
  """
122
187
  __args__ = dict()
123
188
  __args__['datacenterId'] = datacenter_id
124
189
  __args__['distributedVirtualSwitchUuid'] = distributed_virtual_switch_uuid
190
+ __args__['filters'] = filters
125
191
  __args__['name'] = name
192
+ __args__['retryInterval'] = retry_interval
193
+ __args__['retryTimeout'] = retry_timeout
194
+ __args__['vpcId'] = vpc_id
126
195
  opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
127
196
  __ret__ = pulumi.runtime.invoke('vsphere:index/getNetwork:getNetwork', __args__, opts=opts, typ=GetNetworkResult).value
128
197
 
129
198
  return AwaitableGetNetworkResult(
130
199
  datacenter_id=pulumi.get(__ret__, 'datacenter_id'),
131
200
  distributed_virtual_switch_uuid=pulumi.get(__ret__, 'distributed_virtual_switch_uuid'),
201
+ filters=pulumi.get(__ret__, 'filters'),
132
202
  id=pulumi.get(__ret__, 'id'),
133
203
  name=pulumi.get(__ret__, 'name'),
134
- type=pulumi.get(__ret__, 'type'))
135
-
136
-
137
- @_utilities.lift_output_func(get_network)
138
- def get_network_output(datacenter_id: Optional[pulumi.Input[Optional[str]]] = None,
139
- distributed_virtual_switch_uuid: Optional[pulumi.Input[Optional[str]]] = None,
140
- name: Optional[pulumi.Input[str]] = None,
141
- opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetNetworkResult]:
204
+ retry_interval=pulumi.get(__ret__, 'retry_interval'),
205
+ retry_timeout=pulumi.get(__ret__, 'retry_timeout'),
206
+ type=pulumi.get(__ret__, 'type'),
207
+ vpc_id=pulumi.get(__ret__, 'vpc_id'))
208
+ def get_network_output(datacenter_id: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
209
+ distributed_virtual_switch_uuid: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
210
+ filters: Optional[pulumi.Input[Optional[Sequence[Union['GetNetworkFilterArgs', 'GetNetworkFilterArgsDict']]]]] = None,
211
+ name: Optional[pulumi.Input[_builtins.str]] = None,
212
+ retry_interval: Optional[pulumi.Input[Optional[_builtins.int]]] = None,
213
+ retry_timeout: Optional[pulumi.Input[Optional[_builtins.int]]] = None,
214
+ vpc_id: Optional[pulumi.Input[Optional[_builtins.str]]] = None,
215
+ opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetNetworkResult]:
142
216
  """
143
- The `get_network` data source can be used to discover the ID of a network
144
- in vSphere. This can be any network that can be used as the backing for a
145
- network interface for `VirtualMachine` or any other vSphere resource
146
- that requires a network. This includes standard (host-based) port groups,
147
- distributed port groups, or opaque networks such as those managed by NSX.
217
+ The `get_network` data source can be used to discover the ID of a network in
218
+ vSphere. This can be any network that can be used as the backing for a network
219
+ interface for `VirtualMachine` or any other vSphere resource that
220
+ requires a network. This includes standard (host-based) port groups, distributed
221
+ port groups, or opaque networks such as those managed by NSX.
148
222
 
149
223
  ## Example Usage
150
224
 
@@ -157,15 +231,52 @@ def get_network_output(datacenter_id: Optional[pulumi.Input[Optional[str]]] = No
157
231
  datacenter_id=datacenter.id)
158
232
  ```
159
233
 
234
+ ### Additional Examples
160
235
 
161
- :param str datacenter_id: The managed object reference ID
236
+ ```python
237
+ import pulumi
238
+ import pulumi_vsphere as vsphere
239
+
240
+ datacenter = vsphere.get_datacenter(name="dc-01")
241
+ my_port_group = vsphere.get_network(datacenter_id=datacenter.id,
242
+ name="VM Network",
243
+ filters=[{
244
+ "network_type": "Network",
245
+ }])
246
+ ```
247
+
248
+
249
+ :param _builtins.str datacenter_id: The managed object reference ID
162
250
  of the datacenter the network is located in. This can be omitted if the
163
251
  search path used in `name` is an absolute path. For default datacenters,
164
252
  use the `id` attribute from an empty `Datacenter` data source.
165
- :param str distributed_virtual_switch_uuid: For distributed port group type
253
+ :param _builtins.str distributed_virtual_switch_uuid: For distributed port group type
166
254
  network objects, the ID of the distributed virtual switch for which the port
167
- group belongs. It is useful to differentiate port groups with same name
168
- using the distributed virtual switch ID.
169
- :param str name: The name of the network. This can be a name or path.
255
+ group belongs. It is useful to differentiate port groups with same name using
256
+ the distributed virtual switch ID.
257
+ :param Sequence[Union['GetNetworkFilterArgs', 'GetNetworkFilterArgsDict']] filters: Apply a filter for the discovered network.
258
+ :param _builtins.str name: The name of the network. This can be a name or path.
259
+ :param _builtins.int retry_interval: The interval in milliseconds to retry the read operation if `retry_timeout` is set. Default: 500.
260
+ :param _builtins.int retry_timeout: The timeout duration in seconds for the data source to retry read operations.
261
+ :param _builtins.str vpc_id: Select a VPC scope for retrieval of VPC subnets.
170
262
  """
171
- ...
263
+ __args__ = dict()
264
+ __args__['datacenterId'] = datacenter_id
265
+ __args__['distributedVirtualSwitchUuid'] = distributed_virtual_switch_uuid
266
+ __args__['filters'] = filters
267
+ __args__['name'] = name
268
+ __args__['retryInterval'] = retry_interval
269
+ __args__['retryTimeout'] = retry_timeout
270
+ __args__['vpcId'] = vpc_id
271
+ opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
272
+ __ret__ = pulumi.runtime.invoke_output('vsphere:index/getNetwork:getNetwork', __args__, opts=opts, typ=GetNetworkResult)
273
+ return __ret__.apply(lambda __response__: GetNetworkResult(
274
+ datacenter_id=pulumi.get(__response__, 'datacenter_id'),
275
+ distributed_virtual_switch_uuid=pulumi.get(__response__, 'distributed_virtual_switch_uuid'),
276
+ filters=pulumi.get(__response__, 'filters'),
277
+ id=pulumi.get(__response__, 'id'),
278
+ name=pulumi.get(__response__, 'name'),
279
+ retry_interval=pulumi.get(__response__, 'retry_interval'),
280
+ retry_timeout=pulumi.get(__response__, 'retry_timeout'),
281
+ type=pulumi.get(__response__, 'type'),
282
+ vpc_id=pulumi.get(__response__, 'vpc_id')))