google-cloud-workstations 0.2.1__tar.gz → 0.4.0__tar.gz

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 (55) hide show
  1. {google-cloud-workstations-0.2.1/google_cloud_workstations.egg-info → google-cloud-workstations-0.4.0}/PKG-INFO +1 -1
  2. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations/gapic_version.py +1 -1
  3. {google-cloud-workstations-0.2.1/google/cloud/workstations_v1beta → google-cloud-workstations-0.4.0/google/cloud/workstations_v1}/gapic_version.py +1 -1
  4. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1/services/workstations/async_client.py +15 -10
  5. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1/services/workstations/client.py +15 -10
  6. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1/services/workstations/transports/grpc.py +6 -5
  7. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1/services/workstations/transports/grpc_asyncio.py +6 -5
  8. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1/types/workstations.py +72 -44
  9. {google-cloud-workstations-0.2.1/google/cloud/workstations_v1 → google-cloud-workstations-0.4.0/google/cloud/workstations_v1beta}/gapic_version.py +1 -1
  10. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1beta/services/workstations/async_client.py +13 -8
  11. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1beta/services/workstations/client.py +13 -8
  12. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1beta/services/workstations/transports/grpc.py +4 -3
  13. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1beta/services/workstations/transports/grpc_asyncio.py +4 -3
  14. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1beta/types/workstations.py +149 -41
  15. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0/google_cloud_workstations.egg-info}/PKG-INFO +1 -1
  16. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/tests/unit/gapic/workstations_v1/test_workstations.py +14 -0
  17. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/tests/unit/gapic/workstations_v1beta/test_workstations.py +36 -0
  18. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/LICENSE +0 -0
  19. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/MANIFEST.in +0 -0
  20. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/README.rst +0 -0
  21. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations/__init__.py +0 -0
  22. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations/py.typed +0 -0
  23. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1/__init__.py +0 -0
  24. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1/gapic_metadata.json +0 -0
  25. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1/py.typed +0 -0
  26. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1/services/__init__.py +0 -0
  27. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1/services/workstations/__init__.py +0 -0
  28. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1/services/workstations/pagers.py +0 -0
  29. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1/services/workstations/transports/__init__.py +0 -0
  30. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1/services/workstations/transports/base.py +0 -0
  31. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1/services/workstations/transports/rest.py +0 -0
  32. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1/types/__init__.py +0 -0
  33. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1beta/__init__.py +0 -0
  34. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1beta/gapic_metadata.json +0 -0
  35. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1beta/py.typed +0 -0
  36. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1beta/services/__init__.py +0 -0
  37. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1beta/services/workstations/__init__.py +0 -0
  38. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1beta/services/workstations/pagers.py +0 -0
  39. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1beta/services/workstations/transports/__init__.py +0 -0
  40. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1beta/services/workstations/transports/base.py +0 -0
  41. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1beta/services/workstations/transports/rest.py +0 -0
  42. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google/cloud/workstations_v1beta/types/__init__.py +0 -0
  43. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google_cloud_workstations.egg-info/SOURCES.txt +0 -0
  44. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google_cloud_workstations.egg-info/dependency_links.txt +0 -0
  45. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google_cloud_workstations.egg-info/namespace_packages.txt +0 -0
  46. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google_cloud_workstations.egg-info/not-zip-safe +0 -0
  47. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google_cloud_workstations.egg-info/requires.txt +0 -0
  48. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/google_cloud_workstations.egg-info/top_level.txt +0 -0
  49. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/setup.cfg +0 -0
  50. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/setup.py +0 -0
  51. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/tests/__init__.py +0 -0
  52. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/tests/unit/__init__.py +0 -0
  53. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/tests/unit/gapic/__init__.py +0 -0
  54. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/tests/unit/gapic/workstations_v1/__init__.py +0 -0
  55. {google-cloud-workstations-0.2.1 → google-cloud-workstations-0.4.0}/tests/unit/gapic/workstations_v1beta/__init__.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: google-cloud-workstations
3
- Version: 0.2.1
3
+ Version: 0.4.0
4
4
  Summary: Google Cloud Workstations API client library
5
5
  Home-page: https://github.com/googleapis/google-cloud-python
6
6
  Author: Google LLC
@@ -14,4 +14,4 @@
14
14
  # limitations under the License.
15
15
  #
16
16
 
17
- __version__ = "0.2.1" # {x-release-please-version}
17
+ __version__ = "0.4.0" # {x-release-please-version}
@@ -14,4 +14,4 @@
14
14
  # limitations under the License.
15
15
  #
16
16
 
17
- __version__ = "0.2.1" # {x-release-please-version}
17
+ __version__ = "0.4.0" # {x-release-please-version}
@@ -980,8 +980,8 @@ class WorkstationsAsyncClient:
980
980
  timeout: Union[float, object] = gapic_v1.method.DEFAULT,
981
981
  metadata: Sequence[Tuple[str, str]] = (),
982
982
  ) -> pagers.ListWorkstationConfigsAsyncPager:
983
- r"""Returns all WorkstationConfigs in the specified
984
- cluster.
983
+ r"""Returns all workstation configurations in the
984
+ specified cluster.
985
985
 
986
986
  .. code-block:: python
987
987
 
@@ -1281,7 +1281,9 @@ class WorkstationsAsyncClient:
1281
1281
  on the ``request`` instance; if ``request`` is provided, this
1282
1282
  should not be set.
1283
1283
  workstation_config_id (:class:`str`):
1284
- Required. ID to use for the config.
1284
+ Required. ID to use for the
1285
+ workstation configuration.
1286
+
1285
1287
  This corresponds to the ``workstation_config_id`` field
1286
1288
  on the ``request`` instance; if ``request`` is provided, this
1287
1289
  should not be set.
@@ -1408,7 +1410,8 @@ class WorkstationsAsyncClient:
1408
1410
  should not be set.
1409
1411
  update_mask (:class:`google.protobuf.field_mask_pb2.FieldMask`):
1410
1412
  Required. Mask specifying which
1411
- fields in the config should be updated.
1413
+ fields in the workstation configuration
1414
+ should be updated.
1412
1415
 
1413
1416
  This corresponds to the ``update_mask`` field
1414
1417
  on the ``request`` instance; if ``request`` is provided, this
@@ -1530,8 +1533,8 @@ class WorkstationsAsyncClient:
1530
1533
  The request object. Message for deleting a workstation
1531
1534
  configuration.
1532
1535
  name (:class:`str`):
1533
- Required. Name of the config to
1534
- delete.
1536
+ Required. Name of the workstation
1537
+ configuration to delete.
1535
1538
 
1536
1539
  This corresponds to the ``name`` field
1537
1540
  on the ``request`` instance; if ``request`` is provided, this
@@ -1721,7 +1724,8 @@ class WorkstationsAsyncClient:
1721
1724
  timeout: Union[float, object] = gapic_v1.method.DEFAULT,
1722
1725
  metadata: Sequence[Tuple[str, str]] = (),
1723
1726
  ) -> pagers.ListWorkstationsAsyncPager:
1724
- r"""Returns all Workstations using the specified config.
1727
+ r"""Returns all Workstations using the specified
1728
+ workstation configuration.
1725
1729
 
1726
1730
  .. code-block:: python
1727
1731
 
@@ -1844,8 +1848,8 @@ class WorkstationsAsyncClient:
1844
1848
  timeout: Union[float, object] = gapic_v1.method.DEFAULT,
1845
1849
  metadata: Sequence[Tuple[str, str]] = (),
1846
1850
  ) -> pagers.ListUsableWorkstationsAsyncPager:
1847
- r"""Returns all Workstations using the specified config
1848
- on which the caller has the
1851
+ r"""Returns all workstations using the specified
1852
+ workstation configuration on which the caller has the
1849
1853
  "workstations.workstations.use" permission.
1850
1854
 
1851
1855
  .. code-block:: python
@@ -2146,7 +2150,8 @@ class WorkstationsAsyncClient:
2146
2150
  should not be set.
2147
2151
  update_mask (:class:`google.protobuf.field_mask_pb2.FieldMask`):
2148
2152
  Required. Mask specifying which
2149
- fields in the config should be updated.
2153
+ fields in the workstation configuration
2154
+ should be updated.
2150
2155
 
2151
2156
  This corresponds to the ``update_mask`` field
2152
2157
  on the ``request`` instance; if ``request`` is provided, this
@@ -1234,8 +1234,8 @@ class WorkstationsClient(metaclass=WorkstationsClientMeta):
1234
1234
  timeout: Union[float, object] = gapic_v1.method.DEFAULT,
1235
1235
  metadata: Sequence[Tuple[str, str]] = (),
1236
1236
  ) -> pagers.ListWorkstationConfigsPager:
1237
- r"""Returns all WorkstationConfigs in the specified
1238
- cluster.
1237
+ r"""Returns all workstation configurations in the
1238
+ specified cluster.
1239
1239
 
1240
1240
  .. code-block:: python
1241
1241
 
@@ -1519,7 +1519,9 @@ class WorkstationsClient(metaclass=WorkstationsClientMeta):
1519
1519
  on the ``request`` instance; if ``request`` is provided, this
1520
1520
  should not be set.
1521
1521
  workstation_config_id (str):
1522
- Required. ID to use for the config.
1522
+ Required. ID to use for the
1523
+ workstation configuration.
1524
+
1523
1525
  This corresponds to the ``workstation_config_id`` field
1524
1526
  on the ``request`` instance; if ``request`` is provided, this
1525
1527
  should not be set.
@@ -1648,7 +1650,8 @@ class WorkstationsClient(metaclass=WorkstationsClientMeta):
1648
1650
  should not be set.
1649
1651
  update_mask (google.protobuf.field_mask_pb2.FieldMask):
1650
1652
  Required. Mask specifying which
1651
- fields in the config should be updated.
1653
+ fields in the workstation configuration
1654
+ should be updated.
1652
1655
 
1653
1656
  This corresponds to the ``update_mask`` field
1654
1657
  on the ``request`` instance; if ``request`` is provided, this
@@ -1772,8 +1775,8 @@ class WorkstationsClient(metaclass=WorkstationsClientMeta):
1772
1775
  The request object. Message for deleting a workstation
1773
1776
  configuration.
1774
1777
  name (str):
1775
- Required. Name of the config to
1776
- delete.
1778
+ Required. Name of the workstation
1779
+ configuration to delete.
1777
1780
 
1778
1781
  This corresponds to the ``name`` field
1779
1782
  on the ``request`` instance; if ``request`` is provided, this
@@ -1956,7 +1959,8 @@ class WorkstationsClient(metaclass=WorkstationsClientMeta):
1956
1959
  timeout: Union[float, object] = gapic_v1.method.DEFAULT,
1957
1960
  metadata: Sequence[Tuple[str, str]] = (),
1958
1961
  ) -> pagers.ListWorkstationsPager:
1959
- r"""Returns all Workstations using the specified config.
1962
+ r"""Returns all Workstations using the specified
1963
+ workstation configuration.
1960
1964
 
1961
1965
  .. code-block:: python
1962
1966
 
@@ -2070,8 +2074,8 @@ class WorkstationsClient(metaclass=WorkstationsClientMeta):
2070
2074
  timeout: Union[float, object] = gapic_v1.method.DEFAULT,
2071
2075
  metadata: Sequence[Tuple[str, str]] = (),
2072
2076
  ) -> pagers.ListUsableWorkstationsPager:
2073
- r"""Returns all Workstations using the specified config
2074
- on which the caller has the
2077
+ r"""Returns all workstations using the specified
2078
+ workstation configuration on which the caller has the
2075
2079
  "workstations.workstations.use" permission.
2076
2080
 
2077
2081
  .. code-block:: python
@@ -2363,7 +2367,8 @@ class WorkstationsClient(metaclass=WorkstationsClientMeta):
2363
2367
  should not be set.
2364
2368
  update_mask (google.protobuf.field_mask_pb2.FieldMask):
2365
2369
  Required. Mask specifying which
2366
- fields in the config should be updated.
2370
+ fields in the workstation configuration
2371
+ should be updated.
2367
2372
 
2368
2373
  This corresponds to the ``update_mask`` field
2369
2374
  on the ``request`` instance; if ``request`` is provided, this
@@ -426,8 +426,8 @@ class WorkstationsGrpcTransport(WorkstationsTransport):
426
426
  ]:
427
427
  r"""Return a callable for the list workstation configs method over gRPC.
428
428
 
429
- Returns all WorkstationConfigs in the specified
430
- cluster.
429
+ Returns all workstation configurations in the
430
+ specified cluster.
431
431
 
432
432
  Returns:
433
433
  Callable[[~.ListWorkstationConfigsRequest],
@@ -599,7 +599,8 @@ class WorkstationsGrpcTransport(WorkstationsTransport):
599
599
  ]:
600
600
  r"""Return a callable for the list workstations method over gRPC.
601
601
 
602
- Returns all Workstations using the specified config.
602
+ Returns all Workstations using the specified
603
+ workstation configuration.
603
604
 
604
605
  Returns:
605
606
  Callable[[~.ListWorkstationsRequest],
@@ -628,8 +629,8 @@ class WorkstationsGrpcTransport(WorkstationsTransport):
628
629
  ]:
629
630
  r"""Return a callable for the list usable workstations method over gRPC.
630
631
 
631
- Returns all Workstations using the specified config
632
- on which the caller has the
632
+ Returns all workstations using the specified
633
+ workstation configuration on which the caller has the
633
634
  "workstations.workstations.use" permission.
634
635
 
635
636
  Returns:
@@ -436,8 +436,8 @@ class WorkstationsGrpcAsyncIOTransport(WorkstationsTransport):
436
436
  ]:
437
437
  r"""Return a callable for the list workstation configs method over gRPC.
438
438
 
439
- Returns all WorkstationConfigs in the specified
440
- cluster.
439
+ Returns all workstation configurations in the
440
+ specified cluster.
441
441
 
442
442
  Returns:
443
443
  Callable[[~.ListWorkstationConfigsRequest],
@@ -615,7 +615,8 @@ class WorkstationsGrpcAsyncIOTransport(WorkstationsTransport):
615
615
  ]:
616
616
  r"""Return a callable for the list workstations method over gRPC.
617
617
 
618
- Returns all Workstations using the specified config.
618
+ Returns all Workstations using the specified
619
+ workstation configuration.
619
620
 
620
621
  Returns:
621
622
  Callable[[~.ListWorkstationsRequest],
@@ -644,8 +645,8 @@ class WorkstationsGrpcAsyncIOTransport(WorkstationsTransport):
644
645
  ]:
645
646
  r"""Return a callable for the list usable workstations method over gRPC.
646
647
 
647
- Returns all Workstations using the specified config
648
- on which the caller has the
648
+ Returns all workstations using the specified
649
+ workstation configuration on which the caller has the
649
650
  "workstations.workstations.use" permission.
650
651
 
651
652
  Returns:
@@ -93,8 +93,8 @@ class WorkstationCluster(proto.Message):
93
93
  soft-deleted.
94
94
  etag (str):
95
95
  Checksum computed by the server. May be sent
96
- on update and delete requests to ensure that the
97
- client has an up-to-date value before
96
+ on update and delete requests to make sure that
97
+ the client has an up-to-date value before
98
98
  proceeding.
99
99
  network (str):
100
100
  Immutable. Name of the Compute Engine network
@@ -105,6 +105,13 @@ class WorkstationCluster(proto.Message):
105
105
  subnetwork in which instances associated with
106
106
  this cluster will be created. Must be part of
107
107
  the subnetwork specified for this cluster.
108
+ control_plane_ip (str):
109
+ Output only. The private IP address of the
110
+ control plane for this cluster. Workstation VMs
111
+ need access to this IP address to work with the
112
+ service, so make sure that your firewall rules
113
+ allow egress from the workstation VMs to this
114
+ address.
108
115
  private_cluster_config (google.cloud.workstations_v1.types.WorkstationCluster.PrivateClusterConfig):
109
116
  Configuration for private cluster.
110
117
  degraded (bool):
@@ -217,6 +224,10 @@ class WorkstationCluster(proto.Message):
217
224
  proto.STRING,
218
225
  number=11,
219
226
  )
227
+ control_plane_ip: str = proto.Field(
228
+ proto.STRING,
229
+ number=16,
230
+ )
220
231
  private_cluster_config: PrivateClusterConfig = proto.Field(
221
232
  proto.MESSAGE,
222
233
  number=12,
@@ -267,8 +278,8 @@ class WorkstationConfig(proto.Message):
267
278
  soft-deleted.
268
279
  etag (str):
269
280
  Checksum computed by the server. May be sent
270
- on update and delete requests to ensure that the
271
- client has an up-to-date value before
281
+ on update and delete requests to make sure that
282
+ the client has an up-to-date value before
272
283
  proceeding.
273
284
  idle_timeout (google.protobuf.duration_pb2.Duration):
274
285
  How long to wait before automatically
@@ -292,9 +303,9 @@ class WorkstationConfig(proto.Message):
292
303
  workstation using this configuration when that
293
304
  workstation is started.
294
305
  encryption_key (google.cloud.workstations_v1.types.WorkstationConfig.CustomerEncryptionKey):
295
- Encrypts resources of this workstation
296
- configuration using a customer-managed
297
- encryption key.
306
+ Immutable. Encrypts resources of this
307
+ workstation configuration using a
308
+ customer-managed encryption key.
298
309
  If specified, the boot disk of the Compute
299
310
  Engine instance and the persistent disk are
300
311
  encrypted using this encryption key. If this
@@ -311,6 +322,9 @@ class WorkstationConfig(proto.Message):
311
322
  If the encryption key is revoked, the
312
323
  workstation session will automatically be
313
324
  stopped within 7 hours.
325
+
326
+ Immutable after the workstation configuration is
327
+ created.
314
328
  degraded (bool):
315
329
  Output only. Whether this resource is degraded, in which
316
330
  case it may require user action to restore full
@@ -340,19 +354,23 @@ class WorkstationConfig(proto.Message):
340
354
  machine_type (str):
341
355
  The name of a Compute Engine machine type.
342
356
  service_account (str):
343
- Email address of the service account that
344
- will be used on VM instances used to support
345
- this config. If not set, VMs will run with a
346
- Google-managed service account. This service
347
- account must have permission to pull the
348
- specified container image, otherwise the image
349
- must be publicly accessible.
357
+ Email address of the service account used on
358
+ VM instances used to support this configuration.
359
+ If not set, VMs run with a Google-managed
360
+ service account. This service account must have
361
+ permission to pull the specified container
362
+ image; otherwise, the image must be publicly
363
+ accessible.
350
364
  tags (MutableSequence[str]):
351
365
  Network tags to add to the Compute Engine
352
366
  machines backing the Workstations.
353
367
  pool_size (int):
354
368
  Number of instances to pool for faster
355
- workstation starup.
369
+ workstation startup.
370
+ pooled_instances (int):
371
+ Output only. Number of instances currently
372
+ available in the pool for faster workstation
373
+ startup.
356
374
  disable_public_ip_addresses (bool):
357
375
  Whether instances have no public IP address.
358
376
  enable_nested_virtualization (bool):
@@ -424,6 +442,10 @@ class WorkstationConfig(proto.Message):
424
442
  proto.INT32,
425
443
  number=5,
426
444
  )
445
+ pooled_instances: int = proto.Field(
446
+ proto.INT32,
447
+ number=12,
448
+ )
427
449
  disable_public_ip_addresses: bool = proto.Field(
428
450
  proto.BOOL,
429
451
  number=6,
@@ -551,8 +573,8 @@ class WorkstationConfig(proto.Message):
551
573
  Attributes:
552
574
  image (str):
553
575
  Docker image defining the container. This
554
- image must be accessible by the config's service
555
- account.
576
+ image must be accessible by the service account
577
+ specified in the workstation configuration.
556
578
  command (MutableSequence[str]):
557
579
  If set, overrides the default ENTRYPOINT
558
580
  specified by the image.
@@ -560,7 +582,7 @@ class WorkstationConfig(proto.Message):
560
582
  Arguments passed to the entrypoint.
561
583
  env (MutableMapping[str, str]):
562
584
  Environment variables passed to the
563
- container.
585
+ container's entrypoint.
564
586
  working_dir (str):
565
587
  If set, overrides the default DIR specified
566
588
  by the image.
@@ -601,13 +623,14 @@ class WorkstationConfig(proto.Message):
601
623
 
602
624
  Attributes:
603
625
  kms_key (str):
604
- The name of the Google Cloud KMS encryption key. For
605
- example,
626
+ Immutable. The name of the Google Cloud KMS encryption key.
627
+ For example,
606
628
  ``projects/PROJECT_ID/locations/REGION/keyRings/KEY_RING/cryptoKeys/KEY_NAME``.
607
629
  kms_key_service_account (str):
608
- The service account to use with the specified KMS key. We
609
- recommend that you use a separate service account and follow
610
- KMS best practices. For more information, see `Separation of
630
+ Immutable. The service account to use with the specified KMS
631
+ key. We recommend that you use a separate service account
632
+ and follow KMS best practices. For more information, see
633
+ `Separation of
611
634
  duties <https://cloud.google.com/kms/docs/separation-of-duties>`__
612
635
  and ``gcloud kms keys add-iam-policy-binding``
613
636
  ```--member`` <https://cloud.google.com/sdk/gcloud/reference/kms/keys/add-iam-policy-binding#--member>`__.
@@ -741,8 +764,8 @@ class Workstation(proto.Message):
741
764
  soft-deleted.
742
765
  etag (str):
743
766
  Checksum computed by the server. May be sent
744
- on update and delete requests to ensure that the
745
- client has an up-to-date value before
767
+ on update and delete requests to make sure that
768
+ the client has an up-to-date value before
746
769
  proceeding.
747
770
  state (google.cloud.workstations_v1.types.Workstation.State):
748
771
  Output only. Current state of the
@@ -997,7 +1020,7 @@ class DeleteWorkstationClusterRequest(proto.Message):
997
1020
  etag (str):
998
1021
  If set, the request will be rejected if the
999
1022
  latest version of the workstation cluster on the
1000
- server does not have this etag.
1023
+ server does not have this ETag.
1001
1024
  force (bool):
1002
1025
  If set, any workstation configurations and
1003
1026
  workstations in the workstation cluster are also
@@ -1165,7 +1188,8 @@ class CreateWorkstationConfigRequest(proto.Message):
1165
1188
  parent (str):
1166
1189
  Required. Parent resource name.
1167
1190
  workstation_config_id (str):
1168
- Required. ID to use for the config.
1191
+ Required. ID to use for the workstation
1192
+ configuration.
1169
1193
  workstation_config (google.cloud.workstations_v1.types.WorkstationConfig):
1170
1194
  Required. Config to create.
1171
1195
  validate_only (bool):
@@ -1200,13 +1224,14 @@ class UpdateWorkstationConfigRequest(proto.Message):
1200
1224
  Required. Config to update.
1201
1225
  update_mask (google.protobuf.field_mask_pb2.FieldMask):
1202
1226
  Required. Mask specifying which fields in the
1203
- config should be updated.
1227
+ workstation configuration should be updated.
1204
1228
  validate_only (bool):
1205
1229
  If set, validate the request and preview the
1206
1230
  review, but do not actually apply it.
1207
1231
  allow_missing (bool):
1208
- If set, and the config is not found, a new config will be
1209
- created. In this situation, update_mask is ignored.
1232
+ If set and the workstation configuration is not found, a new
1233
+ workstation configuration will be created. In this
1234
+ situation, update_mask is ignored.
1210
1235
  """
1211
1236
 
1212
1237
  workstation_config: "WorkstationConfig" = proto.Field(
@@ -1234,18 +1259,20 @@ class DeleteWorkstationConfigRequest(proto.Message):
1234
1259
 
1235
1260
  Attributes:
1236
1261
  name (str):
1237
- Required. Name of the config to delete.
1262
+ Required. Name of the workstation
1263
+ configuration to delete.
1238
1264
  validate_only (bool):
1239
1265
  If set, validate the request and preview the
1240
1266
  review, but do not actually apply it.
1241
1267
  etag (str):
1242
- If set, the request will be rejected if the
1243
- latest version of the config on the server does
1244
- not have this etag.
1268
+ If set, the request is rejected if the latest
1269
+ version of the workstation configuration on the
1270
+ server does not have this ETag.
1245
1271
  force (bool):
1246
- If set, any Workstations in the config will
1247
- also be deleted. Otherwise, the request will
1248
- work only if the config has no workstations.
1272
+ If set, any workstations in the workstation
1273
+ configuration are also deleted. Otherwise, the
1274
+ request works only if the workstation
1275
+ configuration has no workstations.
1249
1276
  """
1250
1277
 
1251
1278
  name: str = proto.Field(
@@ -1442,13 +1469,14 @@ class UpdateWorkstationRequest(proto.Message):
1442
1469
  Required. Workstation to update.
1443
1470
  update_mask (google.protobuf.field_mask_pb2.FieldMask):
1444
1471
  Required. Mask specifying which fields in the
1445
- config should be updated.
1472
+ workstation configuration should be updated.
1446
1473
  validate_only (bool):
1447
1474
  If set, validate the request and preview the
1448
1475
  review, but do not actually apply it.
1449
1476
  allow_missing (bool):
1450
- If set, and the config is not found, a new config will be
1451
- created. In this situation, update_mask is ignored.
1477
+ If set and the workstation configuration is not found, a new
1478
+ workstation configuration is created. In this situation,
1479
+ update_mask is ignored.
1452
1480
  """
1453
1481
 
1454
1482
  workstation: "Workstation" = proto.Field(
@@ -1483,7 +1511,7 @@ class DeleteWorkstationRequest(proto.Message):
1483
1511
  etag (str):
1484
1512
  If set, the request will be rejected if the
1485
1513
  latest version of the workstation on the server
1486
- does not have this etag.
1514
+ does not have this ETag.
1487
1515
  """
1488
1516
 
1489
1517
  name: str = proto.Field(
@@ -1512,7 +1540,7 @@ class StartWorkstationRequest(proto.Message):
1512
1540
  etag (str):
1513
1541
  If set, the request will be rejected if the
1514
1542
  latest version of the workstation on the server
1515
- does not have this etag.
1543
+ does not have this ETag.
1516
1544
  """
1517
1545
 
1518
1546
  name: str = proto.Field(
@@ -1541,7 +1569,7 @@ class StopWorkstationRequest(proto.Message):
1541
1569
  etag (str):
1542
1570
  If set, the request will be rejected if the
1543
1571
  latest version of the workstation on the server
1544
- does not have this etag.
1572
+ does not have this ETag.
1545
1573
  """
1546
1574
 
1547
1575
  name: str = proto.Field(
@@ -1614,7 +1642,7 @@ class GenerateAccessTokenResponse(proto.Message):
1614
1642
  access_token (str):
1615
1643
  The generated bearer access token. To use this token,
1616
1644
  include it in an Authorization header of an HTTP request
1617
- sent to the associated workstation's hostname, for example,
1645
+ sent to the associated workstation's hostname—for example,
1618
1646
  ``Authorization: Bearer <access_token>``.
1619
1647
  expire_time (google.protobuf.timestamp_pb2.Timestamp):
1620
1648
  Time at which the generated token will
@@ -14,4 +14,4 @@
14
14
  # limitations under the License.
15
15
  #
16
16
 
17
- __version__ = "0.2.1" # {x-release-please-version}
17
+ __version__ = "0.4.0" # {x-release-please-version}
@@ -1281,7 +1281,9 @@ class WorkstationsAsyncClient:
1281
1281
  on the ``request`` instance; if ``request`` is provided, this
1282
1282
  should not be set.
1283
1283
  workstation_config_id (:class:`str`):
1284
- Required. ID to use for the config.
1284
+ Required. ID to use for the
1285
+ workstation configuration.
1286
+
1285
1287
  This corresponds to the ``workstation_config_id`` field
1286
1288
  on the ``request`` instance; if ``request`` is provided, this
1287
1289
  should not be set.
@@ -1408,7 +1410,8 @@ class WorkstationsAsyncClient:
1408
1410
  should not be set.
1409
1411
  update_mask (:class:`google.protobuf.field_mask_pb2.FieldMask`):
1410
1412
  Required. Mask specifying which
1411
- fields in the config should be updated.
1413
+ fields in the workstation configuration
1414
+ should be updated.
1412
1415
 
1413
1416
  This corresponds to the ``update_mask`` field
1414
1417
  on the ``request`` instance; if ``request`` is provided, this
@@ -1530,8 +1533,8 @@ class WorkstationsAsyncClient:
1530
1533
  The request object. Message for deleting a workstation
1531
1534
  configuration.
1532
1535
  name (:class:`str`):
1533
- Required. Name of the config to
1534
- delete.
1536
+ Required. Name of the workstation
1537
+ configuration to delete.
1535
1538
 
1536
1539
  This corresponds to the ``name`` field
1537
1540
  on the ``request`` instance; if ``request`` is provided, this
@@ -1721,7 +1724,8 @@ class WorkstationsAsyncClient:
1721
1724
  timeout: Union[float, object] = gapic_v1.method.DEFAULT,
1722
1725
  metadata: Sequence[Tuple[str, str]] = (),
1723
1726
  ) -> pagers.ListWorkstationsAsyncPager:
1724
- r"""Returns all Workstations using the specified config.
1727
+ r"""Returns all Workstations using the specified
1728
+ workstation configuration.
1725
1729
 
1726
1730
  .. code-block:: python
1727
1731
 
@@ -1844,8 +1848,8 @@ class WorkstationsAsyncClient:
1844
1848
  timeout: Union[float, object] = gapic_v1.method.DEFAULT,
1845
1849
  metadata: Sequence[Tuple[str, str]] = (),
1846
1850
  ) -> pagers.ListUsableWorkstationsAsyncPager:
1847
- r"""Returns all Workstations using the specified config
1848
- on which the caller has the
1851
+ r"""Returns all workstations using the specified
1852
+ workstation configuration on which the caller has the
1849
1853
  "workstations.workstations.use" permission.
1850
1854
 
1851
1855
  .. code-block:: python
@@ -2146,7 +2150,8 @@ class WorkstationsAsyncClient:
2146
2150
  should not be set.
2147
2151
  update_mask (:class:`google.protobuf.field_mask_pb2.FieldMask`):
2148
2152
  Required. Mask specifying which
2149
- fields in the config should be updated.
2153
+ fields in the workstation configuration
2154
+ should be updated.
2150
2155
 
2151
2156
  This corresponds to the ``update_mask`` field
2152
2157
  on the ``request`` instance; if ``request`` is provided, this
@@ -1519,7 +1519,9 @@ class WorkstationsClient(metaclass=WorkstationsClientMeta):
1519
1519
  on the ``request`` instance; if ``request`` is provided, this
1520
1520
  should not be set.
1521
1521
  workstation_config_id (str):
1522
- Required. ID to use for the config.
1522
+ Required. ID to use for the
1523
+ workstation configuration.
1524
+
1523
1525
  This corresponds to the ``workstation_config_id`` field
1524
1526
  on the ``request`` instance; if ``request`` is provided, this
1525
1527
  should not be set.
@@ -1648,7 +1650,8 @@ class WorkstationsClient(metaclass=WorkstationsClientMeta):
1648
1650
  should not be set.
1649
1651
  update_mask (google.protobuf.field_mask_pb2.FieldMask):
1650
1652
  Required. Mask specifying which
1651
- fields in the config should be updated.
1653
+ fields in the workstation configuration
1654
+ should be updated.
1652
1655
 
1653
1656
  This corresponds to the ``update_mask`` field
1654
1657
  on the ``request`` instance; if ``request`` is provided, this
@@ -1772,8 +1775,8 @@ class WorkstationsClient(metaclass=WorkstationsClientMeta):
1772
1775
  The request object. Message for deleting a workstation
1773
1776
  configuration.
1774
1777
  name (str):
1775
- Required. Name of the config to
1776
- delete.
1778
+ Required. Name of the workstation
1779
+ configuration to delete.
1777
1780
 
1778
1781
  This corresponds to the ``name`` field
1779
1782
  on the ``request`` instance; if ``request`` is provided, this
@@ -1956,7 +1959,8 @@ class WorkstationsClient(metaclass=WorkstationsClientMeta):
1956
1959
  timeout: Union[float, object] = gapic_v1.method.DEFAULT,
1957
1960
  metadata: Sequence[Tuple[str, str]] = (),
1958
1961
  ) -> pagers.ListWorkstationsPager:
1959
- r"""Returns all Workstations using the specified config.
1962
+ r"""Returns all Workstations using the specified
1963
+ workstation configuration.
1960
1964
 
1961
1965
  .. code-block:: python
1962
1966
 
@@ -2070,8 +2074,8 @@ class WorkstationsClient(metaclass=WorkstationsClientMeta):
2070
2074
  timeout: Union[float, object] = gapic_v1.method.DEFAULT,
2071
2075
  metadata: Sequence[Tuple[str, str]] = (),
2072
2076
  ) -> pagers.ListUsableWorkstationsPager:
2073
- r"""Returns all Workstations using the specified config
2074
- on which the caller has the
2077
+ r"""Returns all workstations using the specified
2078
+ workstation configuration on which the caller has the
2075
2079
  "workstations.workstations.use" permission.
2076
2080
 
2077
2081
  .. code-block:: python
@@ -2363,7 +2367,8 @@ class WorkstationsClient(metaclass=WorkstationsClientMeta):
2363
2367
  should not be set.
2364
2368
  update_mask (google.protobuf.field_mask_pb2.FieldMask):
2365
2369
  Required. Mask specifying which
2366
- fields in the config should be updated.
2370
+ fields in the workstation configuration
2371
+ should be updated.
2367
2372
 
2368
2373
  This corresponds to the ``update_mask`` field
2369
2374
  on the ``request`` instance; if ``request`` is provided, this