pulumi-gcp 7.39.0a1724997984__py3-none-any.whl → 7.39.0a1725647091__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 (44) hide show
  1. pulumi_gcp/certificateauthority/get_authority.py +20 -0
  2. pulumi_gcp/certificatemanager/get_certificate_map.py +14 -0
  3. pulumi_gcp/cloudidentity/get_group_lookup.py +18 -0
  4. pulumi_gcp/cloudidentity/get_group_memberships.py +14 -0
  5. pulumi_gcp/cloudidentity/get_groups.py +14 -0
  6. pulumi_gcp/compute/disk_async_replication.py +48 -0
  7. pulumi_gcp/compute/get_backend_bucket.py +14 -0
  8. pulumi_gcp/compute/get_backend_service.py +20 -0
  9. pulumi_gcp/compute/get_certificate.py +20 -0
  10. pulumi_gcp/compute/get_forwarding_rule.py +14 -0
  11. pulumi_gcp/compute/get_forwarding_rules.py +16 -0
  12. pulumi_gcp/compute/get_global_forwarding_rule.py +14 -0
  13. pulumi_gcp/compute/get_hc_vpn_gateway.py +14 -0
  14. pulumi_gcp/compute/get_health_check.py +14 -0
  15. pulumi_gcp/compute/get_lbip_ranges.py +32 -0
  16. pulumi_gcp/compute/get_netblock_ip_ranges.py +52 -0
  17. pulumi_gcp/compute/get_network.py +14 -0
  18. pulumi_gcp/compute/get_networks.py +14 -0
  19. pulumi_gcp/compute/get_region_ssl_certificate.py +20 -0
  20. pulumi_gcp/compute/get_ssl_policy.py +14 -0
  21. pulumi_gcp/compute/get_vpn_gateway.py +14 -0
  22. pulumi_gcp/compute/instance_template.py +56 -0
  23. pulumi_gcp/container/get_cluster.py +24 -0
  24. pulumi_gcp/dataproc/get_metastore_service.py +16 -0
  25. pulumi_gcp/dns/get_record_set.py +20 -0
  26. pulumi_gcp/filestore/get_instance.py +20 -0
  27. pulumi_gcp/iam/get_workload_identity_pool.py +14 -0
  28. pulumi_gcp/iam/get_workload_identity_pool_provider.py +16 -0
  29. pulumi_gcp/iap/get_client.py +18 -0
  30. pulumi_gcp/monitoring/get_secret_version.py +2 -2
  31. pulumi_gcp/organizations/get_active_folder.py +16 -0
  32. pulumi_gcp/organizations/get_client_config.py +14 -2
  33. pulumi_gcp/pulumi-plugin.json +1 -1
  34. pulumi_gcp/redis/get_instance.py +20 -0
  35. pulumi_gcp/secretmanager/get_secret_version.py +2 -2
  36. pulumi_gcp/spanner/get_instance.py +14 -0
  37. pulumi_gcp/tags/get_tag_key.py +30 -0
  38. pulumi_gcp/tags/get_tag_keys.py +26 -0
  39. pulumi_gcp/tags/get_tag_value.py +16 -0
  40. pulumi_gcp/tags/get_tag_values.py +14 -0
  41. {pulumi_gcp-7.39.0a1724997984.dist-info → pulumi_gcp-7.39.0a1725647091.dist-info}/METADATA +1 -1
  42. {pulumi_gcp-7.39.0a1724997984.dist-info → pulumi_gcp-7.39.0a1725647091.dist-info}/RECORD +44 -44
  43. {pulumi_gcp-7.39.0a1724997984.dist-info → pulumi_gcp-7.39.0a1725647091.dist-info}/WHEEL +1 -1
  44. {pulumi_gcp-7.39.0a1724997984.dist-info → pulumi_gcp-7.39.0a1725647091.dist-info}/top_level.txt +0 -0
@@ -124,6 +124,13 @@ def get_vpn_gateway(name: Optional[str] = None,
124
124
 
125
125
  ## Example Usage
126
126
 
127
+ ```python
128
+ import pulumi
129
+ import pulumi_gcp as gcp
130
+
131
+ my_vpn_gateway = gcp.compute.get_vpn_gateway(name="vpn-gateway-us-east1")
132
+ ```
133
+
127
134
 
128
135
  :param str name: The name of the VPN gateway.
129
136
 
@@ -161,6 +168,13 @@ def get_vpn_gateway_output(name: Optional[pulumi.Input[str]] = None,
161
168
 
162
169
  ## Example Usage
163
170
 
171
+ ```python
172
+ import pulumi
173
+ import pulumi_gcp as gcp
174
+
175
+ my_vpn_gateway = gcp.compute.get_vpn_gateway(name="vpn-gateway-us-east1")
176
+ ```
177
+
164
178
 
165
179
  :param str name: The name of the VPN gateway.
166
180
 
@@ -1337,10 +1337,38 @@ class InstanceTemplate(pulumi.CustomResource):
1337
1337
  data source, which will retrieve the latest image on every `pulumi apply`, and will update
1338
1338
  the template to use that specific image:
1339
1339
 
1340
+ ```python
1341
+ import pulumi
1342
+ import pulumi_gcp as gcp
1343
+
1344
+ my_image = gcp.compute.get_image(family="debian-11",
1345
+ project="debian-cloud")
1346
+ instance_template = gcp.compute.InstanceTemplate("instance_template",
1347
+ name_prefix="instance-template-",
1348
+ machine_type="e2-medium",
1349
+ region="us-central1",
1350
+ disks=[{
1351
+ "source_image": my_image.self_link,
1352
+ }])
1353
+ ```
1354
+
1340
1355
  To have instances update to the latest on every scaling event or instance re-creation,
1341
1356
  use the family as the image for the disk, and it will use GCP's default behavior, setting
1342
1357
  the image for the template to the family:
1343
1358
 
1359
+ ```python
1360
+ import pulumi
1361
+ import pulumi_gcp as gcp
1362
+
1363
+ instance_template = gcp.compute.InstanceTemplate("instance_template",
1364
+ name_prefix="instance-template-",
1365
+ machine_type="e2-medium",
1366
+ region="us-central1",
1367
+ disks=[{
1368
+ "source_image": "debian-cloud/debian-11",
1369
+ }])
1370
+ ```
1371
+
1344
1372
  ## Import
1345
1373
 
1346
1374
  Instance templates can be imported using any of these accepted formats:
@@ -1603,10 +1631,38 @@ class InstanceTemplate(pulumi.CustomResource):
1603
1631
  data source, which will retrieve the latest image on every `pulumi apply`, and will update
1604
1632
  the template to use that specific image:
1605
1633
 
1634
+ ```python
1635
+ import pulumi
1636
+ import pulumi_gcp as gcp
1637
+
1638
+ my_image = gcp.compute.get_image(family="debian-11",
1639
+ project="debian-cloud")
1640
+ instance_template = gcp.compute.InstanceTemplate("instance_template",
1641
+ name_prefix="instance-template-",
1642
+ machine_type="e2-medium",
1643
+ region="us-central1",
1644
+ disks=[{
1645
+ "source_image": my_image.self_link,
1646
+ }])
1647
+ ```
1648
+
1606
1649
  To have instances update to the latest on every scaling event or instance re-creation,
1607
1650
  use the family as the image for the disk, and it will use GCP's default behavior, setting
1608
1651
  the image for the template to the family:
1609
1652
 
1653
+ ```python
1654
+ import pulumi
1655
+ import pulumi_gcp as gcp
1656
+
1657
+ instance_template = gcp.compute.InstanceTemplate("instance_template",
1658
+ name_prefix="instance-template-",
1659
+ machine_type="e2-medium",
1660
+ region="us-central1",
1661
+ disks=[{
1662
+ "source_image": "debian-cloud/debian-11",
1663
+ }])
1664
+ ```
1665
+
1610
1666
  ## Import
1611
1667
 
1612
1668
  Instance templates can be imported using any of these accepted formats:
@@ -752,6 +752,18 @@ def get_cluster(location: Optional[str] = None,
752
752
 
753
753
  ## Example Usage
754
754
 
755
+ ```python
756
+ import pulumi
757
+ import pulumi_gcp as gcp
758
+
759
+ my_cluster = gcp.container.get_cluster(name="my-cluster",
760
+ location="us-east1-a")
761
+ pulumi.export("endpoint", my_cluster.endpoint)
762
+ pulumi.export("instanceGroupUrls", my_cluster.node_pools[0].instance_group_urls)
763
+ pulumi.export("nodeConfig", my_cluster.node_configs)
764
+ pulumi.export("nodePools", my_cluster.node_pools)
765
+ ```
766
+
755
767
 
756
768
  :param str location: The location (zone or region) this cluster has been
757
769
  created in. One of `location`, `region`, `zone`, or a provider-level `zone` must
@@ -858,6 +870,18 @@ def get_cluster_output(location: Optional[pulumi.Input[Optional[str]]] = None,
858
870
 
859
871
  ## Example Usage
860
872
 
873
+ ```python
874
+ import pulumi
875
+ import pulumi_gcp as gcp
876
+
877
+ my_cluster = gcp.container.get_cluster(name="my-cluster",
878
+ location="us-east1-a")
879
+ pulumi.export("endpoint", my_cluster.endpoint)
880
+ pulumi.export("instanceGroupUrls", my_cluster.node_pools[0].instance_group_urls)
881
+ pulumi.export("nodeConfig", my_cluster.node_configs)
882
+ pulumi.export("nodePools", my_cluster.node_pools)
883
+ ```
884
+
861
885
 
862
886
  :param str location: The location (zone or region) this cluster has been
863
887
  created in. One of `location`, `region`, `zone`, or a provider-level `zone` must
@@ -284,6 +284,14 @@ def get_metastore_service(location: Optional[str] = None,
284
284
 
285
285
  ## Example Usage
286
286
 
287
+ ```python
288
+ import pulumi
289
+ import pulumi_gcp as gcp
290
+
291
+ foo = gcp.dataproc.get_metastore_service(service_id="foo-bar",
292
+ location="global")
293
+ ```
294
+
287
295
 
288
296
  :param str location: The location where the metastore service resides.
289
297
 
@@ -338,6 +346,14 @@ def get_metastore_service_output(location: Optional[pulumi.Input[str]] = None,
338
346
 
339
347
  ## Example Usage
340
348
 
349
+ ```python
350
+ import pulumi
351
+ import pulumi_gcp as gcp
352
+
353
+ foo = gcp.dataproc.get_metastore_service(service_id="foo-bar",
354
+ location="global")
355
+ ```
356
+
341
357
 
342
358
  :param str location: The location where the metastore service resides.
343
359
 
@@ -123,6 +123,16 @@ def get_record_set(managed_zone: Optional[str] = None,
123
123
 
124
124
  ## Example Usage
125
125
 
126
+ ```python
127
+ import pulumi
128
+ import pulumi_gcp as gcp
129
+
130
+ sample = gcp.dns.get_managed_zone(name="sample-zone")
131
+ rs = gcp.dns.get_record_set(managed_zone=sample.name,
132
+ name=f"my-record.{sample.dns_name}",
133
+ type="A")
134
+ ```
135
+
126
136
 
127
137
  :param str managed_zone: The Name of the zone.
128
138
  :param str name: The DNS name for the resource.
@@ -162,6 +172,16 @@ def get_record_set_output(managed_zone: Optional[pulumi.Input[str]] = None,
162
172
 
163
173
  ## Example Usage
164
174
 
175
+ ```python
176
+ import pulumi
177
+ import pulumi_gcp as gcp
178
+
179
+ sample = gcp.dns.get_managed_zone(name="sample-zone")
180
+ rs = gcp.dns.get_record_set(managed_zone=sample.name,
181
+ name=f"my-record.{sample.dns_name}",
182
+ type="A")
183
+ ```
184
+
165
185
 
166
186
  :param str managed_zone: The Name of the zone.
167
187
  :param str name: The DNS name for the resource.
@@ -194,6 +194,16 @@ def get_instance(location: Optional[str] = None,
194
194
 
195
195
  ## Example Usage
196
196
 
197
+ ```python
198
+ import pulumi
199
+ import pulumi_gcp as gcp
200
+
201
+ my_instance = gcp.filestore.get_instance(name="my-filestore-instance")
202
+ pulumi.export("instanceIpAddresses", my_instance.networks.ip_addresses)
203
+ pulumi.export("instanceConnectMode", my_instance.networks.connect_mode)
204
+ pulumi.export("instanceFileShareName", my_instance.file_shares.name)
205
+ ```
206
+
197
207
 
198
208
  :param str location: The name of the location of the instance. This
199
209
  can be a region for ENTERPRISE tier instances. If it is not provided,
@@ -240,6 +250,16 @@ def get_instance_output(location: Optional[pulumi.Input[Optional[str]]] = None,
240
250
 
241
251
  ## Example Usage
242
252
 
253
+ ```python
254
+ import pulumi
255
+ import pulumi_gcp as gcp
256
+
257
+ my_instance = gcp.filestore.get_instance(name="my-filestore-instance")
258
+ pulumi.export("instanceIpAddresses", my_instance.networks.ip_addresses)
259
+ pulumi.export("instanceConnectMode", my_instance.networks.connect_mode)
260
+ pulumi.export("instanceFileShareName", my_instance.file_shares.name)
261
+ ```
262
+
243
263
 
244
264
  :param str location: The name of the location of the instance. This
245
265
  can be a region for ENTERPRISE tier instances. If it is not provided,
@@ -120,6 +120,13 @@ def get_workload_identity_pool(project: Optional[str] = None,
120
120
  > **Note:** The following resource requires the Beta IAM role `roles/iam.workloadIdentityPoolAdmin` in order to succeed. `OWNER` and `EDITOR` roles do not include the necessary permissions.
121
121
  ## Example Usage
122
122
 
123
+ ```python
124
+ import pulumi
125
+ import pulumi_gcp as gcp
126
+
127
+ foo = gcp.iam.get_workload_identity_pool(workload_identity_pool_id="foo-pool")
128
+ ```
129
+
123
130
 
124
131
  :param str project: The project in which the resource belongs. If it
125
132
  is not provided, the provider project is used.
@@ -154,6 +161,13 @@ def get_workload_identity_pool_output(project: Optional[pulumi.Input[Optional[st
154
161
  > **Note:** The following resource requires the Beta IAM role `roles/iam.workloadIdentityPoolAdmin` in order to succeed. `OWNER` and `EDITOR` roles do not include the necessary permissions.
155
162
  ## Example Usage
156
163
 
164
+ ```python
165
+ import pulumi
166
+ import pulumi_gcp as gcp
167
+
168
+ foo = gcp.iam.get_workload_identity_pool(workload_identity_pool_id="foo-pool")
169
+ ```
170
+
157
171
 
158
172
  :param str project: The project in which the resource belongs. If it
159
173
  is not provided, the provider project is used.
@@ -176,6 +176,14 @@ def get_workload_identity_pool_provider(project: Optional[str] = None,
176
176
 
177
177
  ## Example Usage
178
178
 
179
+ ```python
180
+ import pulumi
181
+ import pulumi_gcp as gcp
182
+
183
+ foo = gcp.iam.get_workload_identity_pool_provider(workload_identity_pool_id="foo-pool",
184
+ workload_identity_pool_provider_id="bar-provider")
185
+ ```
186
+
179
187
 
180
188
  :param str project: The project in which the resource belongs. If it
181
189
  is not provided, the provider project is used.
@@ -220,6 +228,14 @@ def get_workload_identity_pool_provider_output(project: Optional[pulumi.Input[Op
220
228
 
221
229
  ## Example Usage
222
230
 
231
+ ```python
232
+ import pulumi
233
+ import pulumi_gcp as gcp
234
+
235
+ foo = gcp.iam.get_workload_identity_pool_provider(workload_identity_pool_id="foo-pool",
236
+ workload_identity_pool_provider_id="bar-provider")
237
+ ```
238
+
223
239
 
224
240
  :param str project: The project in which the resource belongs. If it
225
241
  is not provided, the provider project is used.
@@ -93,6 +93,15 @@ def get_client(brand: Optional[str] = None,
93
93
 
94
94
  ## Example Usage
95
95
 
96
+ ```python
97
+ import pulumi
98
+ import pulumi_gcp as gcp
99
+
100
+ project = gcp.organizations.get_project(project_id="foobar")
101
+ project_client = gcp.iap.get_client(brand=f"projects/{project.number}/brands/[BRAND_NUMBER]",
102
+ client_id=apps["googleusercontent"]["com"])
103
+ ```
104
+
96
105
 
97
106
  :param str brand: The name of the brand.
98
107
  :param str client_id: The client_id of the brand.
@@ -120,6 +129,15 @@ def get_client_output(brand: Optional[pulumi.Input[str]] = None,
120
129
 
121
130
  ## Example Usage
122
131
 
132
+ ```python
133
+ import pulumi
134
+ import pulumi_gcp as gcp
135
+
136
+ project = gcp.organizations.get_project(project_id="foobar")
137
+ project_client = gcp.iap.get_client(brand=f"projects/{project.number}/brands/[BRAND_NUMBER]",
138
+ client_id=apps["googleusercontent"]["com"])
139
+ ```
140
+
123
141
 
124
142
  :param str brand: The name of the brand.
125
143
  :param str client_id: The client_id of the brand.
@@ -144,7 +144,7 @@ def get_secret_version(project: Optional[str] = None,
144
144
  version: Optional[str] = None,
145
145
  opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetSecretVersionResult:
146
146
  """
147
- Get the value and metadata from a Secret Manager secret version. For more information see the official documentation datasource.
147
+ Get the value and metadata from a Secret Manager secret version. For more information see the [official documentation](https://cloud.google.com/secret-manager/docs/) and [API](https://cloud.google.com/secret-manager/docs/reference/rest/v1/projects.secrets.versions). If you don't need the metadata (i.e., if you want to use a more limited role to access the secret version only), see also the secretmanager_get_secret_version_access datasource.
148
148
 
149
149
  ## Example Usage
150
150
 
@@ -188,7 +188,7 @@ def get_secret_version_output(project: Optional[pulumi.Input[Optional[str]]] = N
188
188
  version: Optional[pulumi.Input[Optional[str]]] = None,
189
189
  opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetSecretVersionResult]:
190
190
  """
191
- Get the value and metadata from a Secret Manager secret version. For more information see the official documentation datasource.
191
+ Get the value and metadata from a Secret Manager secret version. For more information see the [official documentation](https://cloud.google.com/secret-manager/docs/) and [API](https://cloud.google.com/secret-manager/docs/reference/rest/v1/projects.secrets.versions). If you don't need the metadata (i.e., if you want to use a more limited role to access the secret version only), see also the secretmanager_get_secret_version_access datasource.
192
192
 
193
193
  ## Example Usage
194
194
 
@@ -97,6 +97,14 @@ def get_active_folder(api_method: Optional[str] = None,
97
97
 
98
98
  ## Example Usage
99
99
 
100
+ ```python
101
+ import pulumi
102
+ import pulumi_gcp as gcp
103
+
104
+ department1 = gcp.organizations.get_active_folder(display_name="Department 1",
105
+ parent="organizations/1234567")
106
+ ```
107
+
100
108
 
101
109
  :param str api_method: The API method to use to search for the folder. Valid values are `LIST` and `SEARCH`. Default Value is `LIST`. `LIST` is [strongly consistent](https://cloud.google.com/resource-manager/reference/rest/v3/folders/list#:~:text=list()%20provides%20a-,strongly%20consistent,-view%20of%20the) and requires `resourcemanager.folders.list` on the parent folder, while `SEARCH` is [eventually consistent](https://cloud.google.com/resource-manager/reference/rest/v3/folders/search#:~:text=eventually%20consistent) and only returns folders that the user has `resourcemanager.folders.get` permission on.
102
110
  :param str display_name: The folder's display name.
@@ -127,6 +135,14 @@ def get_active_folder_output(api_method: Optional[pulumi.Input[Optional[str]]] =
127
135
 
128
136
  ## Example Usage
129
137
 
138
+ ```python
139
+ import pulumi
140
+ import pulumi_gcp as gcp
141
+
142
+ department1 = gcp.organizations.get_active_folder(display_name="Department 1",
143
+ parent="organizations/1234567")
144
+ ```
145
+
130
146
 
131
147
  :param str api_method: The API method to use to search for the folder. Valid values are `LIST` and `SEARCH`. Default Value is `LIST`. `LIST` is [strongly consistent](https://cloud.google.com/resource-manager/reference/rest/v3/folders/list#:~:text=list()%20provides%20a-,strongly%20consistent,-view%20of%20the) and requires `resourcemanager.folders.list` on the parent folder, while `SEARCH` is [eventually consistent](https://cloud.google.com/resource-manager/reference/rest/v3/folders/search#:~:text=eventually%20consistent) and only returns folders that the user has `resourcemanager.folders.get` permission on.
132
148
  :param str display_name: The folder's display name.
@@ -98,7 +98,13 @@ def get_client_config(opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableG
98
98
  """
99
99
  ## Example Usage
100
100
 
101
- ### Configure Kubernetes Provider With OAuth2 Access Token
101
+ ```python
102
+ import pulumi
103
+ import pulumi_gcp as gcp
104
+
105
+ current = gcp.organizations.get_client_config()
106
+ pulumi.export("project", current.project)
107
+ ```
102
108
  """
103
109
  __args__ = dict()
104
110
  opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
@@ -117,6 +123,12 @@ def get_client_config_output(opts: Optional[pulumi.InvokeOptions] = None) -> pul
117
123
  """
118
124
  ## Example Usage
119
125
 
120
- ### Configure Kubernetes Provider With OAuth2 Access Token
126
+ ```python
127
+ import pulumi
128
+ import pulumi_gcp as gcp
129
+
130
+ current = gcp.organizations.get_client_config()
131
+ pulumi.export("project", current.project)
132
+ ```
121
133
  """
122
134
  ...
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "resource": true,
3
3
  "name": "gcp",
4
- "version": "7.39.0-alpha.1724997984"
4
+ "version": "7.39.0-alpha.1725647091"
5
5
  }
@@ -383,6 +383,16 @@ def get_instance(name: Optional[str] = None,
383
383
 
384
384
  ## Example Usage
385
385
 
386
+ ```python
387
+ import pulumi
388
+ import pulumi_gcp as gcp
389
+
390
+ my_instance = gcp.redis.get_instance(name="my-redis-instance")
391
+ pulumi.export("instanceMemorySizeGb", my_instance.memory_size_gb)
392
+ pulumi.export("instanceConnectMode", my_instance.connect_mode)
393
+ pulumi.export("instanceAuthorizedNetwork", my_instance.authorized_network)
394
+ ```
395
+
386
396
 
387
397
  :param str name: The name of a Redis instance.
388
398
 
@@ -449,6 +459,16 @@ def get_instance_output(name: Optional[pulumi.Input[str]] = None,
449
459
 
450
460
  ## Example Usage
451
461
 
462
+ ```python
463
+ import pulumi
464
+ import pulumi_gcp as gcp
465
+
466
+ my_instance = gcp.redis.get_instance(name="my-redis-instance")
467
+ pulumi.export("instanceMemorySizeGb", my_instance.memory_size_gb)
468
+ pulumi.export("instanceConnectMode", my_instance.connect_mode)
469
+ pulumi.export("instanceAuthorizedNetwork", my_instance.authorized_network)
470
+ ```
471
+
452
472
 
453
473
  :param str name: The name of a Redis instance.
454
474
 
@@ -142,7 +142,7 @@ def get_secret_version(project: Optional[str] = None,
142
142
  version: Optional[str] = None,
143
143
  opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetSecretVersionResult:
144
144
  """
145
- Get the value and metadata from a Secret Manager secret version. For more information see the official documentation datasource.
145
+ Get the value and metadata from a Secret Manager secret version. For more information see the [official documentation](https://cloud.google.com/secret-manager/docs/) and [API](https://cloud.google.com/secret-manager/docs/reference/rest/v1/projects.secrets.versions). If you don't need the metadata (i.e., if you want to use a more limited role to access the secret version only), see also the secretmanager_get_secret_version_access datasource.
146
146
 
147
147
  ## Example Usage
148
148
 
@@ -185,7 +185,7 @@ def get_secret_version_output(project: Optional[pulumi.Input[Optional[str]]] = N
185
185
  version: Optional[pulumi.Input[Optional[str]]] = None,
186
186
  opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetSecretVersionResult]:
187
187
  """
188
- Get the value and metadata from a Secret Manager secret version. For more information see the official documentation datasource.
188
+ Get the value and metadata from a Secret Manager secret version. For more information see the [official documentation](https://cloud.google.com/secret-manager/docs/) and [API](https://cloud.google.com/secret-manager/docs/reference/rest/v1/projects.secrets.versions). If you don't need the metadata (i.e., if you want to use a more limited role to access the secret version only), see also the secretmanager_get_secret_version_access datasource.
189
189
 
190
190
  ## Example Usage
191
191
 
@@ -168,6 +168,13 @@ def get_instance(config: Optional[str] = None,
168
168
 
169
169
  ## Example Usage
170
170
 
171
+ ```python
172
+ import pulumi
173
+ import pulumi_gcp as gcp
174
+
175
+ foo = gcp.spanner.get_instance(name="bar")
176
+ ```
177
+
171
178
 
172
179
  :param str name: The name of the spanner instance.
173
180
 
@@ -210,6 +217,13 @@ def get_instance_output(config: Optional[pulumi.Input[Optional[str]]] = None,
210
217
 
211
218
  ## Example Usage
212
219
 
220
+ ```python
221
+ import pulumi
222
+ import pulumi_gcp as gcp
223
+
224
+ foo = gcp.spanner.get_instance(name="bar")
225
+ ```
226
+
213
227
 
214
228
  :param str name: The name of the spanner instance.
215
229
 
@@ -134,6 +134,21 @@ def get_tag_key(parent: Optional[str] = None,
134
134
 
135
135
  ## Example Usage
136
136
 
137
+ ```python
138
+ import pulumi
139
+ import pulumi_gcp as gcp
140
+
141
+ environment_tag_key = gcp.tags.get_tag_key(parent="organizations/12345",
142
+ short_name="environment")
143
+ ```
144
+ ```python
145
+ import pulumi
146
+ import pulumi_gcp as gcp
147
+
148
+ environment_tag_key = gcp.tags.get_tag_key(parent="projects/abc",
149
+ short_name="environment")
150
+ ```
151
+
137
152
 
138
153
  :param str parent: The resource name of the parent organization or project. It can be in format `organizations/{org_id}` or `projects/{project_id_or_number}`.
139
154
  :param str short_name: The tag key's short_name.
@@ -164,6 +179,21 @@ def get_tag_key_output(parent: Optional[pulumi.Input[str]] = None,
164
179
 
165
180
  ## Example Usage
166
181
 
182
+ ```python
183
+ import pulumi
184
+ import pulumi_gcp as gcp
185
+
186
+ environment_tag_key = gcp.tags.get_tag_key(parent="organizations/12345",
187
+ short_name="environment")
188
+ ```
189
+ ```python
190
+ import pulumi
191
+ import pulumi_gcp as gcp
192
+
193
+ environment_tag_key = gcp.tags.get_tag_key(parent="projects/abc",
194
+ short_name="environment")
195
+ ```
196
+
167
197
 
168
198
  :param str parent: The resource name of the parent organization or project. It can be in format `organizations/{org_id}` or `projects/{project_id_or_number}`.
169
199
  :param str short_name: The tag key's short_name.
@@ -78,6 +78,19 @@ def get_tag_keys(parent: Optional[str] = None,
78
78
 
79
79
  ## Example Usage
80
80
 
81
+ ```python
82
+ import pulumi
83
+ import pulumi_gcp as gcp
84
+
85
+ environment_tag_key = gcp.tags.get_tag_keys(parent="organizations/12345")
86
+ ```
87
+ ```python
88
+ import pulumi
89
+ import pulumi_gcp as gcp
90
+
91
+ environment_tag_key = gcp.tags.get_tag_keys(parent="projects/abc")
92
+ ```
93
+
81
94
 
82
95
  :param str parent: The resource name of the parent organization or project. It can be in format `organizations/{org_id}` or `projects/{project_id_or_number}`.
83
96
  """
@@ -100,6 +113,19 @@ def get_tag_keys_output(parent: Optional[pulumi.Input[str]] = None,
100
113
 
101
114
  ## Example Usage
102
115
 
116
+ ```python
117
+ import pulumi
118
+ import pulumi_gcp as gcp
119
+
120
+ environment_tag_key = gcp.tags.get_tag_keys(parent="organizations/12345")
121
+ ```
122
+ ```python
123
+ import pulumi
124
+ import pulumi_gcp as gcp
125
+
126
+ environment_tag_key = gcp.tags.get_tag_keys(parent="projects/abc")
127
+ ```
128
+
103
129
 
104
130
  :param str parent: The resource name of the parent organization or project. It can be in format `organizations/{org_id}` or `projects/{project_id_or_number}`.
105
131
  """
@@ -134,6 +134,14 @@ def get_tag_value(parent: Optional[str] = None,
134
134
 
135
135
  ## Example Usage
136
136
 
137
+ ```python
138
+ import pulumi
139
+ import pulumi_gcp as gcp
140
+
141
+ environment_prod_tag_value = gcp.tags.get_tag_value(parent="tagKeys/56789",
142
+ short_name="production")
143
+ ```
144
+
137
145
 
138
146
  :param str parent: The resource name of the parent tagKey in format `tagKey/{name}`.
139
147
  :param str short_name: The tag value's short_name.
@@ -164,6 +172,14 @@ def get_tag_value_output(parent: Optional[pulumi.Input[str]] = None,
164
172
 
165
173
  ## Example Usage
166
174
 
175
+ ```python
176
+ import pulumi
177
+ import pulumi_gcp as gcp
178
+
179
+ environment_prod_tag_value = gcp.tags.get_tag_value(parent="tagKeys/56789",
180
+ short_name="production")
181
+ ```
182
+
167
183
 
168
184
  :param str parent: The resource name of the parent tagKey in format `tagKey/{name}`.
169
185
  :param str short_name: The tag value's short_name.
@@ -78,6 +78,13 @@ def get_tag_values(parent: Optional[str] = None,
78
78
 
79
79
  ## Example Usage
80
80
 
81
+ ```python
82
+ import pulumi
83
+ import pulumi_gcp as gcp
84
+
85
+ environment_tag_values = gcp.tags.get_tag_values(parent="tagKeys/56789")
86
+ ```
87
+
81
88
 
82
89
  :param str parent: The resource name of the parent tagKey in format `tagKey/{name}`.
83
90
  """
@@ -100,6 +107,13 @@ def get_tag_values_output(parent: Optional[pulumi.Input[str]] = None,
100
107
 
101
108
  ## Example Usage
102
109
 
110
+ ```python
111
+ import pulumi
112
+ import pulumi_gcp as gcp
113
+
114
+ environment_tag_values = gcp.tags.get_tag_values(parent="tagKeys/56789")
115
+ ```
116
+
103
117
 
104
118
  :param str parent: The resource name of the parent tagKey in format `tagKey/{name}`.
105
119
  """
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: pulumi_gcp
3
- Version: 7.39.0a1724997984
3
+ Version: 7.39.0a1725647091
4
4
  Summary: A Pulumi package for creating and managing Google Cloud Platform resources.
5
5
  License: Apache-2.0
6
6
  Project-URL: Homepage, https://pulumi.io