pulumi-gcp 8.22.0a1741790977__py3-none-any.whl → 8.23.0__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.
Files changed (124) hide show
  1. pulumi_gcp/__init__.py +64 -0
  2. pulumi_gcp/alloydb/_inputs.py +93 -1
  3. pulumi_gcp/alloydb/outputs.py +128 -2
  4. pulumi_gcp/applicationintegration/client.py +18 -24
  5. pulumi_gcp/backupdisasterrecovery/_inputs.py +3 -3
  6. pulumi_gcp/backupdisasterrecovery/outputs.py +4 -4
  7. pulumi_gcp/bigquery/_inputs.py +20 -0
  8. pulumi_gcp/bigquery/outputs.py +12 -0
  9. pulumi_gcp/bigquery/table.py +61 -0
  10. pulumi_gcp/bigtable/table.py +7 -7
  11. pulumi_gcp/certificatemanager/certificate.py +53 -7
  12. pulumi_gcp/certificatemanager/outputs.py +8 -2
  13. pulumi_gcp/clouddeploy/_inputs.py +20 -0
  14. pulumi_gcp/clouddeploy/outputs.py +15 -1
  15. pulumi_gcp/cloudfunctions/function.py +11 -11
  16. pulumi_gcp/cloudfunctionsv2/function.py +24 -24
  17. pulumi_gcp/cloudidentity/get_group_transitive_memberships.py +41 -2
  18. pulumi_gcp/cloudidentity/outputs.py +18 -38
  19. pulumi_gcp/compute/__init__.py +1 -0
  20. pulumi_gcp/compute/_inputs.py +600 -17
  21. pulumi_gcp/compute/backend_service.py +195 -7
  22. pulumi_gcp/compute/disk.py +108 -0
  23. pulumi_gcp/compute/firewall_policy.py +20 -0
  24. pulumi_gcp/compute/firewall_policy_association.py +28 -2
  25. pulumi_gcp/compute/get_backend_service.py +12 -1
  26. pulumi_gcp/compute/get_disk.py +23 -1
  27. pulumi_gcp/compute/get_region_disk.py +23 -1
  28. pulumi_gcp/compute/get_region_ssl_policy.py +203 -0
  29. pulumi_gcp/compute/outputs.py +623 -23
  30. pulumi_gcp/compute/region_backend_service.py +193 -7
  31. pulumi_gcp/compute/region_disk.py +114 -0
  32. pulumi_gcp/compute/region_network_endpoint_group.py +2 -2
  33. pulumi_gcp/compute/shared_vpc_service_project.py +0 -4
  34. pulumi_gcp/compute/subnetwork.py +256 -1
  35. pulumi_gcp/compute/target_https_proxy.py +7 -7
  36. pulumi_gcp/config/__init__.pyi +2 -0
  37. pulumi_gcp/config/vars.py +4 -0
  38. pulumi_gcp/container/_inputs.py +6 -6
  39. pulumi_gcp/container/get_attached_versions.py +2 -2
  40. pulumi_gcp/container/outputs.py +8 -8
  41. pulumi_gcp/dataform/repository.py +49 -0
  42. pulumi_gcp/dataproc/get_metastore_service.py +26 -4
  43. pulumi_gcp/dataproc/metastore_federation.py +56 -0
  44. pulumi_gcp/dataproc/metastore_service.py +58 -2
  45. pulumi_gcp/datastream/_inputs.py +273 -0
  46. pulumi_gcp/datastream/connection_profile.py +54 -2
  47. pulumi_gcp/datastream/outputs.py +224 -0
  48. pulumi_gcp/eventarc/__init__.py +2 -0
  49. pulumi_gcp/eventarc/_inputs.py +1798 -0
  50. pulumi_gcp/eventarc/channel.py +85 -93
  51. pulumi_gcp/eventarc/google_api_source.py +997 -0
  52. pulumi_gcp/eventarc/outputs.py +1378 -0
  53. pulumi_gcp/eventarc/pipeline.py +1596 -0
  54. pulumi_gcp/firebase/__init__.py +1 -0
  55. pulumi_gcp/firebase/_inputs.py +154 -0
  56. pulumi_gcp/firebase/app_hosting_backend.py +1303 -0
  57. pulumi_gcp/firebase/data_connect_service.py +40 -2
  58. pulumi_gcp/firebase/hosting_version.py +2 -2
  59. pulumi_gcp/firebase/outputs.py +127 -0
  60. pulumi_gcp/iam/__init__.py +2 -0
  61. pulumi_gcp/iam/_inputs.py +51 -18
  62. pulumi_gcp/iam/folders_policy_binding.py +10 -26
  63. pulumi_gcp/iam/oauth_client.py +979 -0
  64. pulumi_gcp/iam/oauth_client_credential.py +641 -0
  65. pulumi_gcp/iam/organizations_policy_binding.py +8 -24
  66. pulumi_gcp/iam/outputs.py +34 -12
  67. pulumi_gcp/iam/principal_access_boundary_policy.py +58 -22
  68. pulumi_gcp/iam/projects_policy_binding.py +8 -24
  69. pulumi_gcp/kms/crypto_key_version.py +14 -7
  70. pulumi_gcp/kms/get_key_rings.py +39 -2
  71. pulumi_gcp/managedkafka/__init__.py +2 -0
  72. pulumi_gcp/managedkafka/_inputs.py +263 -0
  73. pulumi_gcp/managedkafka/connect_cluster.py +795 -0
  74. pulumi_gcp/managedkafka/connector.py +695 -0
  75. pulumi_gcp/managedkafka/outputs.py +248 -0
  76. pulumi_gcp/memorystore/instance.py +7 -7
  77. pulumi_gcp/monitoring/_inputs.py +15 -18
  78. pulumi_gcp/monitoring/alert_policy.py +46 -0
  79. pulumi_gcp/monitoring/outputs.py +10 -12
  80. pulumi_gcp/monitoring/uptime_check_config.py +2 -2
  81. pulumi_gcp/networksecurity/__init__.py +1 -0
  82. pulumi_gcp/networksecurity/_inputs.py +673 -18
  83. pulumi_gcp/networksecurity/backend_authentication_config.py +847 -0
  84. pulumi_gcp/networksecurity/gateway_security_policy.py +0 -7
  85. pulumi_gcp/networksecurity/intercept_deployment.py +178 -94
  86. pulumi_gcp/networksecurity/intercept_deployment_group.py +161 -77
  87. pulumi_gcp/networksecurity/intercept_endpoint_group.py +161 -66
  88. pulumi_gcp/networksecurity/intercept_endpoint_group_association.py +137 -80
  89. pulumi_gcp/networksecurity/mirroring_deployment.py +200 -94
  90. pulumi_gcp/networksecurity/mirroring_deployment_group.py +181 -77
  91. pulumi_gcp/networksecurity/mirroring_endpoint_group.py +185 -80
  92. pulumi_gcp/networksecurity/mirroring_endpoint_group_association.py +165 -105
  93. pulumi_gcp/networksecurity/outputs.py +495 -12
  94. pulumi_gcp/networksecurity/tls_inspection_policy.py +14 -0
  95. pulumi_gcp/networkservices/endpoint_policy.py +12 -0
  96. pulumi_gcp/networkservices/gateway.py +242 -120
  97. pulumi_gcp/networkservices/grpc_route.py +12 -0
  98. pulumi_gcp/networkservices/http_route.py +16 -0
  99. pulumi_gcp/networkservices/mesh.py +16 -0
  100. pulumi_gcp/networkservices/service_binding.py +14 -0
  101. pulumi_gcp/networkservices/tcp_route.py +16 -0
  102. pulumi_gcp/networkservices/tls_route.py +12 -0
  103. pulumi_gcp/projects/__init__.py +2 -0
  104. pulumi_gcp/projects/get_iam_custom_role.py +198 -0
  105. pulumi_gcp/projects/get_iam_custom_roles.py +164 -0
  106. pulumi_gcp/projects/outputs.py +96 -0
  107. pulumi_gcp/provider.py +20 -0
  108. pulumi_gcp/pulumi-plugin.json +1 -1
  109. pulumi_gcp/servicenetworking/peered_dns_domain.py +4 -0
  110. pulumi_gcp/sql/outputs.py +8 -8
  111. pulumi_gcp/storage/_inputs.py +14 -6
  112. pulumi_gcp/storage/insights_report_config.py +121 -20
  113. pulumi_gcp/storage/outputs.py +7 -4
  114. pulumi_gcp/tpu/_inputs.py +21 -1
  115. pulumi_gcp/tpu/outputs.py +13 -1
  116. pulumi_gcp/tpu/v2_vm.py +2 -0
  117. pulumi_gcp/vmwareengine/_inputs.py +6 -0
  118. pulumi_gcp/vmwareengine/outputs.py +8 -0
  119. pulumi_gcp/workflows/workflow.py +75 -7
  120. pulumi_gcp/workstations/workstation_cluster.py +137 -1
  121. {pulumi_gcp-8.22.0a1741790977.dist-info → pulumi_gcp-8.23.0.dist-info}/METADATA +2 -2
  122. {pulumi_gcp-8.22.0a1741790977.dist-info → pulumi_gcp-8.23.0.dist-info}/RECORD +124 -113
  123. {pulumi_gcp-8.22.0a1741790977.dist-info → pulumi_gcp-8.23.0.dist-info}/WHEEL +1 -1
  124. {pulumi_gcp-8.22.0a1741790977.dist-info → pulumi_gcp-8.23.0.dist-info}/top_level.txt +0 -0
@@ -24,20 +24,23 @@ class MirroringDeploymentGroupArgs:
24
24
  location: pulumi.Input[str],
25
25
  mirroring_deployment_group_id: pulumi.Input[str],
26
26
  network: pulumi.Input[str],
27
+ description: Optional[pulumi.Input[str]] = None,
27
28
  labels: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
28
29
  project: Optional[pulumi.Input[str]] = None):
29
30
  """
30
31
  The set of arguments for constructing a MirroringDeploymentGroup resource.
31
- :param pulumi.Input[str] location: Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122. See documentation for resource type `networksecurity.googleapis.com/MirroringDeploymentGroup`.
32
- :param pulumi.Input[str] mirroring_deployment_group_id: Required. Id of the requesting object
33
- If auto-generating Id server-side, remove this field and
34
- mirroring_deployment_group_id from the method_signature of Create RPC
32
+ :param pulumi.Input[str] location: The cloud location of the deployment group, currently restricted to `global`.
33
+ :param pulumi.Input[str] mirroring_deployment_group_id: The ID to use for the new deployment group, which will become the final
34
+ component of the deployment group's resource name.
35
35
 
36
36
 
37
37
  - - -
38
- :param pulumi.Input[str] network: Required. Immutable. The network that is being used for the deployment. Format is:
39
- projects/{project}/global/networks/{network}.
40
- :param pulumi.Input[Mapping[str, pulumi.Input[str]]] labels: Optional. Labels as key value pairs
38
+ :param pulumi.Input[str] network: The network that will be used for all child deployments, for example:
39
+ `projects/{project}/global/networks/{network}`.
40
+ See https://google.aip.dev/124.
41
+ :param pulumi.Input[str] description: User-provided description of the deployment group.
42
+ Used as additional context for the deployment group.
43
+ :param pulumi.Input[Mapping[str, pulumi.Input[str]]] labels: Labels are key/value pairs that help to organize and filter resources.
41
44
  **Note**: This field is non-authoritative, and will only manage the labels present in your configuration.
42
45
  Please refer to the field `effective_labels` for all of the labels present on the resource.
43
46
  :param pulumi.Input[str] project: The ID of the project in which the resource belongs.
@@ -46,6 +49,8 @@ class MirroringDeploymentGroupArgs:
46
49
  pulumi.set(__self__, "location", location)
47
50
  pulumi.set(__self__, "mirroring_deployment_group_id", mirroring_deployment_group_id)
48
51
  pulumi.set(__self__, "network", network)
52
+ if description is not None:
53
+ pulumi.set(__self__, "description", description)
49
54
  if labels is not None:
50
55
  pulumi.set(__self__, "labels", labels)
51
56
  if project is not None:
@@ -55,7 +60,7 @@ class MirroringDeploymentGroupArgs:
55
60
  @pulumi.getter
56
61
  def location(self) -> pulumi.Input[str]:
57
62
  """
58
- Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122. See documentation for resource type `networksecurity.googleapis.com/MirroringDeploymentGroup`.
63
+ The cloud location of the deployment group, currently restricted to `global`.
59
64
  """
60
65
  return pulumi.get(self, "location")
61
66
 
@@ -67,9 +72,8 @@ class MirroringDeploymentGroupArgs:
67
72
  @pulumi.getter(name="mirroringDeploymentGroupId")
68
73
  def mirroring_deployment_group_id(self) -> pulumi.Input[str]:
69
74
  """
70
- Required. Id of the requesting object
71
- If auto-generating Id server-side, remove this field and
72
- mirroring_deployment_group_id from the method_signature of Create RPC
75
+ The ID to use for the new deployment group, which will become the final
76
+ component of the deployment group's resource name.
73
77
 
74
78
 
75
79
  - - -
@@ -84,8 +88,9 @@ class MirroringDeploymentGroupArgs:
84
88
  @pulumi.getter
85
89
  def network(self) -> pulumi.Input[str]:
86
90
  """
87
- Required. Immutable. The network that is being used for the deployment. Format is:
88
- projects/{project}/global/networks/{network}.
91
+ The network that will be used for all child deployments, for example:
92
+ `projects/{project}/global/networks/{network}`.
93
+ See https://google.aip.dev/124.
89
94
  """
90
95
  return pulumi.get(self, "network")
91
96
 
@@ -93,11 +98,24 @@ class MirroringDeploymentGroupArgs:
93
98
  def network(self, value: pulumi.Input[str]):
94
99
  pulumi.set(self, "network", value)
95
100
 
101
+ @property
102
+ @pulumi.getter
103
+ def description(self) -> Optional[pulumi.Input[str]]:
104
+ """
105
+ User-provided description of the deployment group.
106
+ Used as additional context for the deployment group.
107
+ """
108
+ return pulumi.get(self, "description")
109
+
110
+ @description.setter
111
+ def description(self, value: Optional[pulumi.Input[str]]):
112
+ pulumi.set(self, "description", value)
113
+
96
114
  @property
97
115
  @pulumi.getter
98
116
  def labels(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
99
117
  """
100
- Optional. Labels as key value pairs
118
+ Labels are key/value pairs that help to organize and filter resources.
101
119
  **Note**: This field is non-authoritative, and will only manage the labels present in your configuration.
102
120
  Please refer to the field `effective_labels` for all of the labels present on the resource.
103
121
  """
@@ -126,6 +144,7 @@ class _MirroringDeploymentGroupState:
126
144
  def __init__(__self__, *,
127
145
  connected_endpoint_groups: Optional[pulumi.Input[Sequence[pulumi.Input['MirroringDeploymentGroupConnectedEndpointGroupArgs']]]] = None,
128
146
  create_time: Optional[pulumi.Input[str]] = None,
147
+ description: Optional[pulumi.Input[str]] = None,
129
148
  effective_labels: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
130
149
  labels: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
131
150
  location: Optional[pulumi.Input[str]] = None,
@@ -139,42 +158,53 @@ class _MirroringDeploymentGroupState:
139
158
  update_time: Optional[pulumi.Input[str]] = None):
140
159
  """
141
160
  Input properties used for looking up and filtering MirroringDeploymentGroup resources.
142
- :param pulumi.Input[Sequence[pulumi.Input['MirroringDeploymentGroupConnectedEndpointGroupArgs']]] connected_endpoint_groups: Output only. The list of Mirroring Endpoint Groups that are connected to this resource.
161
+ :param pulumi.Input[Sequence[pulumi.Input['MirroringDeploymentGroupConnectedEndpointGroupArgs']]] connected_endpoint_groups: The list of endpoint groups that are connected to this resource.
143
162
  Structure is documented below.
144
- :param pulumi.Input[str] create_time: Output only. [Output only] Create time stamp
163
+ :param pulumi.Input[str] create_time: The timestamp when the resource was created.
164
+ See https://google.aip.dev/148#timestamps.
165
+ :param pulumi.Input[str] description: User-provided description of the deployment group.
166
+ Used as additional context for the deployment group.
145
167
  :param pulumi.Input[Mapping[str, pulumi.Input[str]]] effective_labels: All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
146
- :param pulumi.Input[Mapping[str, pulumi.Input[str]]] labels: Optional. Labels as key value pairs
168
+ :param pulumi.Input[Mapping[str, pulumi.Input[str]]] labels: Labels are key/value pairs that help to organize and filter resources.
147
169
  **Note**: This field is non-authoritative, and will only manage the labels present in your configuration.
148
170
  Please refer to the field `effective_labels` for all of the labels present on the resource.
149
- :param pulumi.Input[str] location: Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122. See documentation for resource type `networksecurity.googleapis.com/MirroringDeploymentGroup`.
150
- :param pulumi.Input[str] mirroring_deployment_group_id: Required. Id of the requesting object
151
- If auto-generating Id server-side, remove this field and
152
- mirroring_deployment_group_id from the method_signature of Create RPC
171
+ :param pulumi.Input[str] location: The cloud location of the deployment group, currently restricted to `global`.
172
+ :param pulumi.Input[str] mirroring_deployment_group_id: The ID to use for the new deployment group, which will become the final
173
+ component of the deployment group's resource name.
153
174
 
154
175
 
155
176
  - - -
156
177
  :param pulumi.Input[str] name: (Output)
157
- Output only. A connected mirroring endpoint group.
158
- :param pulumi.Input[str] network: Required. Immutable. The network that is being used for the deployment. Format is:
159
- projects/{project}/global/networks/{network}.
178
+ The connected endpoint group's resource name, for example:
179
+ `projects/123456789/locations/global/mirroringEndpointGroups/my-eg`.
180
+ See https://google.aip.dev/124.
181
+ :param pulumi.Input[str] network: The network that will be used for all child deployments, for example:
182
+ `projects/{project}/global/networks/{network}`.
183
+ See https://google.aip.dev/124.
160
184
  :param pulumi.Input[str] project: The ID of the project in which the resource belongs.
161
185
  If it is not provided, the provider project is used.
162
186
  :param pulumi.Input[Mapping[str, pulumi.Input[str]]] pulumi_labels: The combination of labels configured directly on the resource
163
187
  and default labels configured on the provider.
164
- :param pulumi.Input[bool] reconciling: Output only. Whether reconciling is in progress, recommended per
165
- https://google.aip.dev/128.
166
- :param pulumi.Input[str] state: Output only. Current state of the deployment group.
188
+ :param pulumi.Input[bool] reconciling: The current state of the resource does not match the user's intended state,
189
+ and the system is working to reconcile them. This is part of the normal
190
+ operation (e.g. adding a new deployment to the group)
191
+ See https://google.aip.dev/128.
192
+ :param pulumi.Input[str] state: The current state of the deployment group.
193
+ See https://google.aip.dev/216.
167
194
  Possible values:
168
195
  STATE_UNSPECIFIED
169
196
  ACTIVE
170
197
  CREATING
171
198
  DELETING
172
- :param pulumi.Input[str] update_time: Output only. [Output only] Update time stamp
199
+ :param pulumi.Input[str] update_time: The timestamp when the resource was most recently updated.
200
+ See https://google.aip.dev/148#timestamps.
173
201
  """
174
202
  if connected_endpoint_groups is not None:
175
203
  pulumi.set(__self__, "connected_endpoint_groups", connected_endpoint_groups)
176
204
  if create_time is not None:
177
205
  pulumi.set(__self__, "create_time", create_time)
206
+ if description is not None:
207
+ pulumi.set(__self__, "description", description)
178
208
  if effective_labels is not None:
179
209
  pulumi.set(__self__, "effective_labels", effective_labels)
180
210
  if labels is not None:
@@ -202,7 +232,7 @@ class _MirroringDeploymentGroupState:
202
232
  @pulumi.getter(name="connectedEndpointGroups")
203
233
  def connected_endpoint_groups(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['MirroringDeploymentGroupConnectedEndpointGroupArgs']]]]:
204
234
  """
205
- Output only. The list of Mirroring Endpoint Groups that are connected to this resource.
235
+ The list of endpoint groups that are connected to this resource.
206
236
  Structure is documented below.
207
237
  """
208
238
  return pulumi.get(self, "connected_endpoint_groups")
@@ -215,7 +245,8 @@ class _MirroringDeploymentGroupState:
215
245
  @pulumi.getter(name="createTime")
216
246
  def create_time(self) -> Optional[pulumi.Input[str]]:
217
247
  """
218
- Output only. [Output only] Create time stamp
248
+ The timestamp when the resource was created.
249
+ See https://google.aip.dev/148#timestamps.
219
250
  """
220
251
  return pulumi.get(self, "create_time")
221
252
 
@@ -223,6 +254,19 @@ class _MirroringDeploymentGroupState:
223
254
  def create_time(self, value: Optional[pulumi.Input[str]]):
224
255
  pulumi.set(self, "create_time", value)
225
256
 
257
+ @property
258
+ @pulumi.getter
259
+ def description(self) -> Optional[pulumi.Input[str]]:
260
+ """
261
+ User-provided description of the deployment group.
262
+ Used as additional context for the deployment group.
263
+ """
264
+ return pulumi.get(self, "description")
265
+
266
+ @description.setter
267
+ def description(self, value: Optional[pulumi.Input[str]]):
268
+ pulumi.set(self, "description", value)
269
+
226
270
  @property
227
271
  @pulumi.getter(name="effectiveLabels")
228
272
  def effective_labels(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
@@ -239,7 +283,7 @@ class _MirroringDeploymentGroupState:
239
283
  @pulumi.getter
240
284
  def labels(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
241
285
  """
242
- Optional. Labels as key value pairs
286
+ Labels are key/value pairs that help to organize and filter resources.
243
287
  **Note**: This field is non-authoritative, and will only manage the labels present in your configuration.
244
288
  Please refer to the field `effective_labels` for all of the labels present on the resource.
245
289
  """
@@ -253,7 +297,7 @@ class _MirroringDeploymentGroupState:
253
297
  @pulumi.getter
254
298
  def location(self) -> Optional[pulumi.Input[str]]:
255
299
  """
256
- Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122. See documentation for resource type `networksecurity.googleapis.com/MirroringDeploymentGroup`.
300
+ The cloud location of the deployment group, currently restricted to `global`.
257
301
  """
258
302
  return pulumi.get(self, "location")
259
303
 
@@ -265,9 +309,8 @@ class _MirroringDeploymentGroupState:
265
309
  @pulumi.getter(name="mirroringDeploymentGroupId")
266
310
  def mirroring_deployment_group_id(self) -> Optional[pulumi.Input[str]]:
267
311
  """
268
- Required. Id of the requesting object
269
- If auto-generating Id server-side, remove this field and
270
- mirroring_deployment_group_id from the method_signature of Create RPC
312
+ The ID to use for the new deployment group, which will become the final
313
+ component of the deployment group's resource name.
271
314
 
272
315
 
273
316
  - - -
@@ -283,7 +326,9 @@ class _MirroringDeploymentGroupState:
283
326
  def name(self) -> Optional[pulumi.Input[str]]:
284
327
  """
285
328
  (Output)
286
- Output only. A connected mirroring endpoint group.
329
+ The connected endpoint group's resource name, for example:
330
+ `projects/123456789/locations/global/mirroringEndpointGroups/my-eg`.
331
+ See https://google.aip.dev/124.
287
332
  """
288
333
  return pulumi.get(self, "name")
289
334
 
@@ -295,8 +340,9 @@ class _MirroringDeploymentGroupState:
295
340
  @pulumi.getter
296
341
  def network(self) -> Optional[pulumi.Input[str]]:
297
342
  """
298
- Required. Immutable. The network that is being used for the deployment. Format is:
299
- projects/{project}/global/networks/{network}.
343
+ The network that will be used for all child deployments, for example:
344
+ `projects/{project}/global/networks/{network}`.
345
+ See https://google.aip.dev/124.
300
346
  """
301
347
  return pulumi.get(self, "network")
302
348
 
@@ -334,8 +380,10 @@ class _MirroringDeploymentGroupState:
334
380
  @pulumi.getter
335
381
  def reconciling(self) -> Optional[pulumi.Input[bool]]:
336
382
  """
337
- Output only. Whether reconciling is in progress, recommended per
338
- https://google.aip.dev/128.
383
+ The current state of the resource does not match the user's intended state,
384
+ and the system is working to reconcile them. This is part of the normal
385
+ operation (e.g. adding a new deployment to the group)
386
+ See https://google.aip.dev/128.
339
387
  """
340
388
  return pulumi.get(self, "reconciling")
341
389
 
@@ -347,7 +395,8 @@ class _MirroringDeploymentGroupState:
347
395
  @pulumi.getter
348
396
  def state(self) -> Optional[pulumi.Input[str]]:
349
397
  """
350
- Output only. Current state of the deployment group.
398
+ The current state of the deployment group.
399
+ See https://google.aip.dev/216.
351
400
  Possible values:
352
401
  STATE_UNSPECIFIED
353
402
  ACTIVE
@@ -364,7 +413,8 @@ class _MirroringDeploymentGroupState:
364
413
  @pulumi.getter(name="updateTime")
365
414
  def update_time(self) -> Optional[pulumi.Input[str]]:
366
415
  """
367
- Output only. [Output only] Update time stamp
416
+ The timestamp when the resource was most recently updated.
417
+ See https://google.aip.dev/148#timestamps.
368
418
  """
369
419
  return pulumi.get(self, "update_time")
370
420
 
@@ -378,6 +428,7 @@ class MirroringDeploymentGroup(pulumi.CustomResource):
378
428
  def __init__(__self__,
379
429
  resource_name: str,
380
430
  opts: Optional[pulumi.ResourceOptions] = None,
431
+ description: Optional[pulumi.Input[str]] = None,
381
432
  labels: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
382
433
  location: Optional[pulumi.Input[str]] = None,
383
434
  mirroring_deployment_group_id: Optional[pulumi.Input[str]] = None,
@@ -385,6 +436,16 @@ class MirroringDeploymentGroup(pulumi.CustomResource):
385
436
  project: Optional[pulumi.Input[str]] = None,
386
437
  __props__=None):
387
438
  """
439
+ A deployment group aggregates many zonal mirroring backends (deployments)
440
+ into a single global mirroring service. Consumers can connect this service
441
+ using an endpoint group.
442
+
443
+ To get more information about MirroringDeploymentGroup, see:
444
+
445
+ * [API documentation](https://cloud.google.com/network-security-integration/docs/reference/rest/v1/projects.locations.mirroringDeploymentGroups)
446
+ * How-to Guides
447
+ * [Mirroring deployment group overview](https://cloud.google.com/network-security-integration/docs/out-of-band/deployment-groups-overview)
448
+
388
449
  ## Example Usage
389
450
 
390
451
  ### Network Security Mirroring Deployment Group Basic
@@ -400,6 +461,7 @@ class MirroringDeploymentGroup(pulumi.CustomResource):
400
461
  mirroring_deployment_group_id="example-dg",
401
462
  location="global",
402
463
  network=network.id,
464
+ description="some description",
403
465
  labels={
404
466
  "foo": "bar",
405
467
  })
@@ -431,18 +493,20 @@ class MirroringDeploymentGroup(pulumi.CustomResource):
431
493
 
432
494
  :param str resource_name: The name of the resource.
433
495
  :param pulumi.ResourceOptions opts: Options for the resource.
434
- :param pulumi.Input[Mapping[str, pulumi.Input[str]]] labels: Optional. Labels as key value pairs
496
+ :param pulumi.Input[str] description: User-provided description of the deployment group.
497
+ Used as additional context for the deployment group.
498
+ :param pulumi.Input[Mapping[str, pulumi.Input[str]]] labels: Labels are key/value pairs that help to organize and filter resources.
435
499
  **Note**: This field is non-authoritative, and will only manage the labels present in your configuration.
436
500
  Please refer to the field `effective_labels` for all of the labels present on the resource.
437
- :param pulumi.Input[str] location: Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122. See documentation for resource type `networksecurity.googleapis.com/MirroringDeploymentGroup`.
438
- :param pulumi.Input[str] mirroring_deployment_group_id: Required. Id of the requesting object
439
- If auto-generating Id server-side, remove this field and
440
- mirroring_deployment_group_id from the method_signature of Create RPC
501
+ :param pulumi.Input[str] location: The cloud location of the deployment group, currently restricted to `global`.
502
+ :param pulumi.Input[str] mirroring_deployment_group_id: The ID to use for the new deployment group, which will become the final
503
+ component of the deployment group's resource name.
441
504
 
442
505
 
443
506
  - - -
444
- :param pulumi.Input[str] network: Required. Immutable. The network that is being used for the deployment. Format is:
445
- projects/{project}/global/networks/{network}.
507
+ :param pulumi.Input[str] network: The network that will be used for all child deployments, for example:
508
+ `projects/{project}/global/networks/{network}`.
509
+ See https://google.aip.dev/124.
446
510
  :param pulumi.Input[str] project: The ID of the project in which the resource belongs.
447
511
  If it is not provided, the provider project is used.
448
512
  """
@@ -453,6 +517,16 @@ class MirroringDeploymentGroup(pulumi.CustomResource):
453
517
  args: MirroringDeploymentGroupArgs,
454
518
  opts: Optional[pulumi.ResourceOptions] = None):
455
519
  """
520
+ A deployment group aggregates many zonal mirroring backends (deployments)
521
+ into a single global mirroring service. Consumers can connect this service
522
+ using an endpoint group.
523
+
524
+ To get more information about MirroringDeploymentGroup, see:
525
+
526
+ * [API documentation](https://cloud.google.com/network-security-integration/docs/reference/rest/v1/projects.locations.mirroringDeploymentGroups)
527
+ * How-to Guides
528
+ * [Mirroring deployment group overview](https://cloud.google.com/network-security-integration/docs/out-of-band/deployment-groups-overview)
529
+
456
530
  ## Example Usage
457
531
 
458
532
  ### Network Security Mirroring Deployment Group Basic
@@ -468,6 +542,7 @@ class MirroringDeploymentGroup(pulumi.CustomResource):
468
542
  mirroring_deployment_group_id="example-dg",
469
543
  location="global",
470
544
  network=network.id,
545
+ description="some description",
471
546
  labels={
472
547
  "foo": "bar",
473
548
  })
@@ -512,6 +587,7 @@ class MirroringDeploymentGroup(pulumi.CustomResource):
512
587
  def _internal_init(__self__,
513
588
  resource_name: str,
514
589
  opts: Optional[pulumi.ResourceOptions] = None,
590
+ description: Optional[pulumi.Input[str]] = None,
515
591
  labels: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
516
592
  location: Optional[pulumi.Input[str]] = None,
517
593
  mirroring_deployment_group_id: Optional[pulumi.Input[str]] = None,
@@ -526,6 +602,7 @@ class MirroringDeploymentGroup(pulumi.CustomResource):
526
602
  raise TypeError('__props__ is only valid when passed in combination with a valid opts.id to get an existing resource')
527
603
  __props__ = MirroringDeploymentGroupArgs.__new__(MirroringDeploymentGroupArgs)
528
604
 
605
+ __props__.__dict__["description"] = description
529
606
  __props__.__dict__["labels"] = labels
530
607
  if location is None and not opts.urn:
531
608
  raise TypeError("Missing required property 'location'")
@@ -559,6 +636,7 @@ class MirroringDeploymentGroup(pulumi.CustomResource):
559
636
  opts: Optional[pulumi.ResourceOptions] = None,
560
637
  connected_endpoint_groups: Optional[pulumi.Input[Sequence[pulumi.Input[Union['MirroringDeploymentGroupConnectedEndpointGroupArgs', 'MirroringDeploymentGroupConnectedEndpointGroupArgsDict']]]]] = None,
561
638
  create_time: Optional[pulumi.Input[str]] = None,
639
+ description: Optional[pulumi.Input[str]] = None,
562
640
  effective_labels: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
563
641
  labels: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
564
642
  location: Optional[pulumi.Input[str]] = None,
@@ -577,37 +655,46 @@ class MirroringDeploymentGroup(pulumi.CustomResource):
577
655
  :param str resource_name: The unique name of the resulting resource.
578
656
  :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
579
657
  :param pulumi.ResourceOptions opts: Options for the resource.
580
- :param pulumi.Input[Sequence[pulumi.Input[Union['MirroringDeploymentGroupConnectedEndpointGroupArgs', 'MirroringDeploymentGroupConnectedEndpointGroupArgsDict']]]] connected_endpoint_groups: Output only. The list of Mirroring Endpoint Groups that are connected to this resource.
658
+ :param pulumi.Input[Sequence[pulumi.Input[Union['MirroringDeploymentGroupConnectedEndpointGroupArgs', 'MirroringDeploymentGroupConnectedEndpointGroupArgsDict']]]] connected_endpoint_groups: The list of endpoint groups that are connected to this resource.
581
659
  Structure is documented below.
582
- :param pulumi.Input[str] create_time: Output only. [Output only] Create time stamp
660
+ :param pulumi.Input[str] create_time: The timestamp when the resource was created.
661
+ See https://google.aip.dev/148#timestamps.
662
+ :param pulumi.Input[str] description: User-provided description of the deployment group.
663
+ Used as additional context for the deployment group.
583
664
  :param pulumi.Input[Mapping[str, pulumi.Input[str]]] effective_labels: All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
584
- :param pulumi.Input[Mapping[str, pulumi.Input[str]]] labels: Optional. Labels as key value pairs
665
+ :param pulumi.Input[Mapping[str, pulumi.Input[str]]] labels: Labels are key/value pairs that help to organize and filter resources.
585
666
  **Note**: This field is non-authoritative, and will only manage the labels present in your configuration.
586
667
  Please refer to the field `effective_labels` for all of the labels present on the resource.
587
- :param pulumi.Input[str] location: Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122. See documentation for resource type `networksecurity.googleapis.com/MirroringDeploymentGroup`.
588
- :param pulumi.Input[str] mirroring_deployment_group_id: Required. Id of the requesting object
589
- If auto-generating Id server-side, remove this field and
590
- mirroring_deployment_group_id from the method_signature of Create RPC
668
+ :param pulumi.Input[str] location: The cloud location of the deployment group, currently restricted to `global`.
669
+ :param pulumi.Input[str] mirroring_deployment_group_id: The ID to use for the new deployment group, which will become the final
670
+ component of the deployment group's resource name.
591
671
 
592
672
 
593
673
  - - -
594
674
  :param pulumi.Input[str] name: (Output)
595
- Output only. A connected mirroring endpoint group.
596
- :param pulumi.Input[str] network: Required. Immutable. The network that is being used for the deployment. Format is:
597
- projects/{project}/global/networks/{network}.
675
+ The connected endpoint group's resource name, for example:
676
+ `projects/123456789/locations/global/mirroringEndpointGroups/my-eg`.
677
+ See https://google.aip.dev/124.
678
+ :param pulumi.Input[str] network: The network that will be used for all child deployments, for example:
679
+ `projects/{project}/global/networks/{network}`.
680
+ See https://google.aip.dev/124.
598
681
  :param pulumi.Input[str] project: The ID of the project in which the resource belongs.
599
682
  If it is not provided, the provider project is used.
600
683
  :param pulumi.Input[Mapping[str, pulumi.Input[str]]] pulumi_labels: The combination of labels configured directly on the resource
601
684
  and default labels configured on the provider.
602
- :param pulumi.Input[bool] reconciling: Output only. Whether reconciling is in progress, recommended per
603
- https://google.aip.dev/128.
604
- :param pulumi.Input[str] state: Output only. Current state of the deployment group.
685
+ :param pulumi.Input[bool] reconciling: The current state of the resource does not match the user's intended state,
686
+ and the system is working to reconcile them. This is part of the normal
687
+ operation (e.g. adding a new deployment to the group)
688
+ See https://google.aip.dev/128.
689
+ :param pulumi.Input[str] state: The current state of the deployment group.
690
+ See https://google.aip.dev/216.
605
691
  Possible values:
606
692
  STATE_UNSPECIFIED
607
693
  ACTIVE
608
694
  CREATING
609
695
  DELETING
610
- :param pulumi.Input[str] update_time: Output only. [Output only] Update time stamp
696
+ :param pulumi.Input[str] update_time: The timestamp when the resource was most recently updated.
697
+ See https://google.aip.dev/148#timestamps.
611
698
  """
612
699
  opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
613
700
 
@@ -615,6 +702,7 @@ class MirroringDeploymentGroup(pulumi.CustomResource):
615
702
 
616
703
  __props__.__dict__["connected_endpoint_groups"] = connected_endpoint_groups
617
704
  __props__.__dict__["create_time"] = create_time
705
+ __props__.__dict__["description"] = description
618
706
  __props__.__dict__["effective_labels"] = effective_labels
619
707
  __props__.__dict__["labels"] = labels
620
708
  __props__.__dict__["location"] = location
@@ -632,7 +720,7 @@ class MirroringDeploymentGroup(pulumi.CustomResource):
632
720
  @pulumi.getter(name="connectedEndpointGroups")
633
721
  def connected_endpoint_groups(self) -> pulumi.Output[Sequence['outputs.MirroringDeploymentGroupConnectedEndpointGroup']]:
634
722
  """
635
- Output only. The list of Mirroring Endpoint Groups that are connected to this resource.
723
+ The list of endpoint groups that are connected to this resource.
636
724
  Structure is documented below.
637
725
  """
638
726
  return pulumi.get(self, "connected_endpoint_groups")
@@ -641,10 +729,20 @@ class MirroringDeploymentGroup(pulumi.CustomResource):
641
729
  @pulumi.getter(name="createTime")
642
730
  def create_time(self) -> pulumi.Output[str]:
643
731
  """
644
- Output only. [Output only] Create time stamp
732
+ The timestamp when the resource was created.
733
+ See https://google.aip.dev/148#timestamps.
645
734
  """
646
735
  return pulumi.get(self, "create_time")
647
736
 
737
+ @property
738
+ @pulumi.getter
739
+ def description(self) -> pulumi.Output[Optional[str]]:
740
+ """
741
+ User-provided description of the deployment group.
742
+ Used as additional context for the deployment group.
743
+ """
744
+ return pulumi.get(self, "description")
745
+
648
746
  @property
649
747
  @pulumi.getter(name="effectiveLabels")
650
748
  def effective_labels(self) -> pulumi.Output[Mapping[str, str]]:
@@ -657,7 +755,7 @@ class MirroringDeploymentGroup(pulumi.CustomResource):
657
755
  @pulumi.getter
658
756
  def labels(self) -> pulumi.Output[Optional[Mapping[str, str]]]:
659
757
  """
660
- Optional. Labels as key value pairs
758
+ Labels are key/value pairs that help to organize and filter resources.
661
759
  **Note**: This field is non-authoritative, and will only manage the labels present in your configuration.
662
760
  Please refer to the field `effective_labels` for all of the labels present on the resource.
663
761
  """
@@ -667,7 +765,7 @@ class MirroringDeploymentGroup(pulumi.CustomResource):
667
765
  @pulumi.getter
668
766
  def location(self) -> pulumi.Output[str]:
669
767
  """
670
- Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122. See documentation for resource type `networksecurity.googleapis.com/MirroringDeploymentGroup`.
768
+ The cloud location of the deployment group, currently restricted to `global`.
671
769
  """
672
770
  return pulumi.get(self, "location")
673
771
 
@@ -675,9 +773,8 @@ class MirroringDeploymentGroup(pulumi.CustomResource):
675
773
  @pulumi.getter(name="mirroringDeploymentGroupId")
676
774
  def mirroring_deployment_group_id(self) -> pulumi.Output[str]:
677
775
  """
678
- Required. Id of the requesting object
679
- If auto-generating Id server-side, remove this field and
680
- mirroring_deployment_group_id from the method_signature of Create RPC
776
+ The ID to use for the new deployment group, which will become the final
777
+ component of the deployment group's resource name.
681
778
 
682
779
 
683
780
  - - -
@@ -689,7 +786,9 @@ class MirroringDeploymentGroup(pulumi.CustomResource):
689
786
  def name(self) -> pulumi.Output[str]:
690
787
  """
691
788
  (Output)
692
- Output only. A connected mirroring endpoint group.
789
+ The connected endpoint group's resource name, for example:
790
+ `projects/123456789/locations/global/mirroringEndpointGroups/my-eg`.
791
+ See https://google.aip.dev/124.
693
792
  """
694
793
  return pulumi.get(self, "name")
695
794
 
@@ -697,8 +796,9 @@ class MirroringDeploymentGroup(pulumi.CustomResource):
697
796
  @pulumi.getter
698
797
  def network(self) -> pulumi.Output[str]:
699
798
  """
700
- Required. Immutable. The network that is being used for the deployment. Format is:
701
- projects/{project}/global/networks/{network}.
799
+ The network that will be used for all child deployments, for example:
800
+ `projects/{project}/global/networks/{network}`.
801
+ See https://google.aip.dev/124.
702
802
  """
703
803
  return pulumi.get(self, "network")
704
804
 
@@ -724,8 +824,10 @@ class MirroringDeploymentGroup(pulumi.CustomResource):
724
824
  @pulumi.getter
725
825
  def reconciling(self) -> pulumi.Output[bool]:
726
826
  """
727
- Output only. Whether reconciling is in progress, recommended per
728
- https://google.aip.dev/128.
827
+ The current state of the resource does not match the user's intended state,
828
+ and the system is working to reconcile them. This is part of the normal
829
+ operation (e.g. adding a new deployment to the group)
830
+ See https://google.aip.dev/128.
729
831
  """
730
832
  return pulumi.get(self, "reconciling")
731
833
 
@@ -733,7 +835,8 @@ class MirroringDeploymentGroup(pulumi.CustomResource):
733
835
  @pulumi.getter
734
836
  def state(self) -> pulumi.Output[str]:
735
837
  """
736
- Output only. Current state of the deployment group.
838
+ The current state of the deployment group.
839
+ See https://google.aip.dev/216.
737
840
  Possible values:
738
841
  STATE_UNSPECIFIED
739
842
  ACTIVE
@@ -746,7 +849,8 @@ class MirroringDeploymentGroup(pulumi.CustomResource):
746
849
  @pulumi.getter(name="updateTime")
747
850
  def update_time(self) -> pulumi.Output[str]:
748
851
  """
749
- Output only. [Output only] Update time stamp
852
+ The timestamp when the resource was most recently updated.
853
+ See https://google.aip.dev/148#timestamps.
750
854
  """
751
855
  return pulumi.get(self, "update_time")
752
856