pulumi-gcp 8.0.0a1__py3-none-any.whl → 8.0.0a2__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-8.0.0a1.dist-info → pulumi_gcp-8.0.0a2.dist-info}/METADATA +1 -1
  42. {pulumi_gcp-8.0.0a1.dist-info → pulumi_gcp-8.0.0a2.dist-info}/RECORD +44 -44
  43. {pulumi_gcp-8.0.0a1.dist-info → pulumi_gcp-8.0.0a2.dist-info}/WHEEL +0 -0
  44. {pulumi_gcp-8.0.0a1.dist-info → pulumi_gcp-8.0.0a2.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
 
@@ -1365,10 +1365,38 @@ class InstanceTemplate(pulumi.CustomResource):
1365
1365
  data source, which will retrieve the latest image on every `pulumi apply`, and will update
1366
1366
  the template to use that specific image:
1367
1367
 
1368
+ ```python
1369
+ import pulumi
1370
+ import pulumi_gcp as gcp
1371
+
1372
+ my_image = gcp.compute.get_image(family="debian-11",
1373
+ project="debian-cloud")
1374
+ instance_template = gcp.compute.InstanceTemplate("instance_template",
1375
+ name_prefix="instance-template-",
1376
+ machine_type="e2-medium",
1377
+ region="us-central1",
1378
+ disks=[{
1379
+ "source_image": my_image.self_link,
1380
+ }])
1381
+ ```
1382
+
1368
1383
  To have instances update to the latest on every scaling event or instance re-creation,
1369
1384
  use the family as the image for the disk, and it will use GCP's default behavior, setting
1370
1385
  the image for the template to the family:
1371
1386
 
1387
+ ```python
1388
+ import pulumi
1389
+ import pulumi_gcp as gcp
1390
+
1391
+ instance_template = gcp.compute.InstanceTemplate("instance_template",
1392
+ name_prefix="instance-template-",
1393
+ machine_type="e2-medium",
1394
+ region="us-central1",
1395
+ disks=[{
1396
+ "source_image": "debian-cloud/debian-11",
1397
+ }])
1398
+ ```
1399
+
1372
1400
  ## Import
1373
1401
 
1374
1402
  Instance templates can be imported using any of these accepted formats:
@@ -1638,10 +1666,38 @@ class InstanceTemplate(pulumi.CustomResource):
1638
1666
  data source, which will retrieve the latest image on every `pulumi apply`, and will update
1639
1667
  the template to use that specific image:
1640
1668
 
1669
+ ```python
1670
+ import pulumi
1671
+ import pulumi_gcp as gcp
1672
+
1673
+ my_image = gcp.compute.get_image(family="debian-11",
1674
+ project="debian-cloud")
1675
+ instance_template = gcp.compute.InstanceTemplate("instance_template",
1676
+ name_prefix="instance-template-",
1677
+ machine_type="e2-medium",
1678
+ region="us-central1",
1679
+ disks=[{
1680
+ "source_image": my_image.self_link,
1681
+ }])
1682
+ ```
1683
+
1641
1684
  To have instances update to the latest on every scaling event or instance re-creation,
1642
1685
  use the family as the image for the disk, and it will use GCP's default behavior, setting
1643
1686
  the image for the template to the family:
1644
1687
 
1688
+ ```python
1689
+ import pulumi
1690
+ import pulumi_gcp as gcp
1691
+
1692
+ instance_template = gcp.compute.InstanceTemplate("instance_template",
1693
+ name_prefix="instance-template-",
1694
+ machine_type="e2-medium",
1695
+ region="us-central1",
1696
+ disks=[{
1697
+ "source_image": "debian-cloud/debian-11",
1698
+ }])
1699
+ ```
1700
+
1645
1701
  ## Import
1646
1702
 
1647
1703
  Instance templates can be imported using any of these accepted formats:
@@ -770,6 +770,18 @@ def get_cluster(location: Optional[str] = None,
770
770
 
771
771
  ## Example Usage
772
772
 
773
+ ```python
774
+ import pulumi
775
+ import pulumi_gcp as gcp
776
+
777
+ my_cluster = gcp.container.get_cluster(name="my-cluster",
778
+ location="us-east1-a")
779
+ pulumi.export("endpoint", my_cluster.endpoint)
780
+ pulumi.export("instanceGroupUrls", my_cluster.node_pools[0].instance_group_urls)
781
+ pulumi.export("nodeConfig", my_cluster.node_configs)
782
+ pulumi.export("nodePools", my_cluster.node_pools)
783
+ ```
784
+
773
785
 
774
786
  :param str location: The location (zone or region) this cluster has been
775
787
  created in. One of `location`, `region`, `zone`, or a provider-level `zone` must
@@ -878,6 +890,18 @@ def get_cluster_output(location: Optional[pulumi.Input[Optional[str]]] = None,
878
890
 
879
891
  ## Example Usage
880
892
 
893
+ ```python
894
+ import pulumi
895
+ import pulumi_gcp as gcp
896
+
897
+ my_cluster = gcp.container.get_cluster(name="my-cluster",
898
+ location="us-east1-a")
899
+ pulumi.export("endpoint", my_cluster.endpoint)
900
+ pulumi.export("instanceGroupUrls", my_cluster.node_pools[0].instance_group_urls)
901
+ pulumi.export("nodeConfig", my_cluster.node_configs)
902
+ pulumi.export("nodePools", my_cluster.node_pools)
903
+ ```
904
+
881
905
 
882
906
  :param str location: The location (zone or region) this cluster has been
883
907
  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.
@@ -110,7 +110,13 @@ def get_client_config(opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableG
110
110
  """
111
111
  ## Example Usage
112
112
 
113
- ### Configure Kubernetes Provider With OAuth2 Access Token
113
+ ```python
114
+ import pulumi
115
+ import pulumi_gcp as gcp
116
+
117
+ current = gcp.organizations.get_client_config()
118
+ pulumi.export("project", current.project)
119
+ ```
114
120
  """
115
121
  __args__ = dict()
116
122
  opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
@@ -130,6 +136,12 @@ def get_client_config_output(opts: Optional[pulumi.InvokeOptions] = None) -> pul
130
136
  """
131
137
  ## Example Usage
132
138
 
133
- ### Configure Kubernetes Provider With OAuth2 Access Token
139
+ ```python
140
+ import pulumi
141
+ import pulumi_gcp as gcp
142
+
143
+ current = gcp.organizations.get_client_config()
144
+ pulumi.export("project", current.project)
145
+ ```
134
146
  """
135
147
  ...
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "resource": true,
3
3
  "name": "gcp",
4
- "version": "8.0.0-alpha.1"
4
+ "version": "8.0.0-alpha.2"
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: 8.0.0a1
3
+ Version: 8.0.0a2
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