google-apis-workstations_v1beta 0.13.0 → 0.15.0

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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: ddbba4de95302002642d5362ab163b19cfdcd5c96657d964229d535e88c054d0
4
- data.tar.gz: ee46f81d156dcee82288a2b640410fa69828bb3cfd958959d97600e5164993fb
3
+ metadata.gz: c41e9faf788b09f95c6ff17acef839257771dfb09e6a2d05b80b2af048a8ff31
4
+ data.tar.gz: 467affcf50fe7ec34c8499e4ac7941d30628a681a9fae1cd32c3d6db610372b9
5
5
  SHA512:
6
- metadata.gz: d95610de59b50657b96b25a6e03f0697fed370db0919cec403b183dc15c76cec669ee51bfb349df970f00547e465cd4a7f29a9d4fb2d712d07dded162d74d80d
7
- data.tar.gz: 1e5e14c38159172823eefa9abbce3894a545cc8f093d57fdbe0469b1f6edf8338b8cad7dd0718d0c5df3d77ae758b23abf87eb2b4f94f224b24112818ceb5c81
6
+ metadata.gz: 045fc2bbac97e9dcf08396d9d3f3ccc0f901fce93d5828608d3eb8548ecf4d48f677264999161323746ae4e94410c3a7ab76df36b5ac8804612500bc0d4009c3
7
+ data.tar.gz: e05e8d3a6c12b2040a6863ca344bcbba8776aa3a622693c60d074ada9dfc094aed28ce965d21cc2314ac40a43910302d9e2a798094066abfbbb8eeab331b0203
data/CHANGELOG.md CHANGED
@@ -1,5 +1,13 @@
1
1
  # Release history for google-apis-workstations_v1beta
2
2
 
3
+ ### v0.15.0 (2023-08-13)
4
+
5
+ * Regenerated from discovery document revision 20230802
6
+
7
+ ### v0.14.0 (2023-06-25)
8
+
9
+ * Regenerated from discovery document revision 20230619
10
+
3
11
  ### v0.13.0 (2023-06-11)
4
12
 
5
13
  * Regenerated from discovery document revision 20230531
@@ -26,13 +26,13 @@ module Google
26
26
  class Accelerator
27
27
  include Google::Apis::Core::Hashable
28
28
 
29
- # Number of accelerator cards exposed to the instance.
29
+ # Optional. Number of accelerator cards exposed to the instance.
30
30
  # Corresponds to the JSON property `count`
31
31
  # @return [Fixnum]
32
32
  attr_accessor :count
33
33
 
34
- # Type of accelerator resource to attach to the instance, for example, "nvidia-
35
- # tesla-p100".
34
+ # Optional. Type of accelerator resource to attach to the instance, for example,
35
+ # `"nvidia-tesla-p100"`.
36
36
  # Corresponds to the JSON property `type`
37
37
  # @return [String]
38
38
  attr_accessor :type
@@ -212,39 +212,39 @@ module Google
212
212
  class Container
213
213
  include Google::Apis::Core::Hashable
214
214
 
215
- # Arguments passed to the entrypoint.
215
+ # Optional. Arguments passed to the entrypoint.
216
216
  # Corresponds to the JSON property `args`
217
217
  # @return [Array<String>]
218
218
  attr_accessor :args
219
219
 
220
- # If set, overrides the default ENTRYPOINT specified by the image.
220
+ # Optional. If set, overrides the default ENTRYPOINT specified by the image.
221
221
  # Corresponds to the JSON property `command`
222
222
  # @return [Array<String>]
223
223
  attr_accessor :command
224
224
 
225
- # Environment variables passed to the container's entrypoint.
225
+ # Optional. Environment variables passed to the container's entrypoint.
226
226
  # Corresponds to the JSON property `env`
227
227
  # @return [Hash<String,String>]
228
228
  attr_accessor :env
229
229
 
230
- # A Docker container image that defines a custom environment. Cloud Workstations
231
- # provides a number of [preconfigured images](https://cloud.google.com/
232
- # workstations/docs/preconfigured-base-images), but you can create your own [
230
+ # Optional. A Docker container image that defines a custom environment. Cloud
231
+ # Workstations provides a number of [preconfigured images](https://cloud.google.
232
+ # com/workstations/docs/preconfigured-base-images), but you can create your own [
233
233
  # custom container images](https://cloud.google.com/workstations/docs/custom-
234
234
  # container-images). If using a private image, the `host.gceInstance.
235
235
  # serviceAccount` field must be specified in the workstation configuration and
236
236
  # must have permission to pull the specified image. Otherwise, the image must be
237
- # publicly accessible.s
237
+ # publicly accessible.
238
238
  # Corresponds to the JSON property `image`
239
239
  # @return [String]
240
240
  attr_accessor :image
241
241
 
242
- # If set, overrides the USER specified in the image with the given uid.
242
+ # Optional. If set, overrides the USER specified in the image with the given uid.
243
243
  # Corresponds to the JSON property `runAsUser`
244
244
  # @return [Fixnum]
245
245
  attr_accessor :run_as_user
246
246
 
247
- # If set, overrides the default DIR specified by the image.
247
+ # Optional. If set, overrides the default DIR specified by the image.
248
248
  # Corresponds to the JSON property `workingDir`
249
249
  # @return [String]
250
250
  attr_accessor :working_dir
@@ -272,8 +272,8 @@ module Google
272
272
  class CustomerEncryptionKey
273
273
  include Google::Apis::Core::Hashable
274
274
 
275
- # Immutable. The name of the Google Cloud KMS encryption key. For example, `
276
- # projects/PROJECT_ID/locations/REGION/keyRings/KEY_RING/cryptoKeys/KEY_NAME`.
275
+ # Immutable. The name of the Google Cloud KMS encryption key. For example, `"
276
+ # projects/PROJECT_ID/locations/REGION/keyRings/KEY_RING/cryptoKeys/KEY_NAME"`.
277
277
  # The key must be in the same region as the workstation configuration.
278
278
  # Corresponds to the JSON property `kmsKey`
279
279
  # @return [String]
@@ -358,7 +358,7 @@ module Google
358
358
  class GceConfidentialInstanceConfig
359
359
  include Google::Apis::Core::Hashable
360
360
 
361
- # Whether the instance has confidential compute enabled.
361
+ # Optional. Whether the instance has confidential compute enabled.
362
362
  # Corresponds to the JSON property `enableConfidentialCompute`
363
363
  # @return [Boolean]
364
364
  attr_accessor :enable_confidential_compute
@@ -378,13 +378,14 @@ module Google
378
378
  class GceInstance
379
379
  include Google::Apis::Core::Hashable
380
380
 
381
- # A list of the type and count of accelerator cards attached to the instance.
381
+ # Optional. A list of the type and count of accelerator cards attached to the
382
+ # instance.
382
383
  # Corresponds to the JSON property `accelerators`
383
384
  # @return [Array<Google::Apis::WorkstationsV1beta::Accelerator>]
384
385
  attr_accessor :accelerators
385
386
 
386
- # The size of the boot disk for the VM in gigabytes (GB). The minimum boot disk
387
- # size is `30` GB. Defaults to `50` GB.
387
+ # Optional. The size of the boot disk for the VM in gigabytes (GB). The minimum
388
+ # boot disk size is `30` GB. Defaults to `50` GB.
388
389
  # Corresponds to the JSON property `bootDiskSizeGb`
389
390
  # @return [Fixnum]
390
391
  attr_accessor :boot_disk_size_gb
@@ -394,27 +395,56 @@ module Google
394
395
  # @return [Google::Apis::WorkstationsV1beta::GceConfidentialInstanceConfig]
395
396
  attr_accessor :confidential_instance_config
396
397
 
397
- # When set to true, disables public IP addresses for VMs. If you disable public
398
- # IP addresses, you must set up Private Google Access or Cloud NAT on your
399
- # network. If you use Private Google Access and you use `private.googleapis.com`
400
- # or `restricted.googleapis.com` for Container Registry and Artifact Registry,
401
- # make sure that you set up DNS records for domains `*.gcr.io` and `*.pkg.dev`.
402
- # Defaults to false (VMs have public IP addresses).
398
+ # Optional. When set to true, disables public IP addresses for VMs. If you
399
+ # disable public IP addresses, you must set up Private Google Access or Cloud
400
+ # NAT on your network. If you use Private Google Access and you use `private.
401
+ # googleapis.com` or `restricted.googleapis.com` for Container Registry and
402
+ # Artifact Registry, make sure that you set up DNS records for domains `*.gcr.io`
403
+ # and `*.pkg.dev`. Defaults to false (VMs have public IP addresses).
403
404
  # Corresponds to the JSON property `disablePublicIpAddresses`
404
405
  # @return [Boolean]
405
406
  attr_accessor :disable_public_ip_addresses
406
407
  alias_method :disable_public_ip_addresses?, :disable_public_ip_addresses
407
408
 
408
- # The type of machine to use for VM instances—for example, `e2-standard-4`. For
409
- # more information about machine types that Cloud Workstations supports, see the
410
- # list of [available machine types](https://cloud.google.com/workstations/docs/
411
- # available-machine-types).
409
+ # Optional. Whether to enable nested virtualization on Cloud Workstations VMs
410
+ # created under this workstation configuration. Nested virtualization lets you
411
+ # run virtual machine (VM) instances inside your workstation. Before enabling
412
+ # nested virtualization, consider the following important considerations. Cloud
413
+ # Workstations instances are subject to the [same restrictions as Compute Engine
414
+ # instances](https://cloud.google.com/compute/docs/instances/nested-
415
+ # virtualization/overview#restrictions): * **Organization policy**: projects,
416
+ # folders, or organizations may be restricted from creating nested VMs if the **
417
+ # Disable VM nested virtualization** constraint is enforced in the organization
418
+ # policy. For more information, see the Compute Engine section, [Checking
419
+ # whether nested virtualization is allowed](https://cloud.google.com/compute/
420
+ # docs/instances/nested-virtualization/managing-constraint#
421
+ # checking_whether_nested_virtualization_is_allowed). * **Performance**: nested
422
+ # VMs might experience a 10% or greater decrease in performance for workloads
423
+ # that are CPU-bound and possibly greater than a 10% decrease for workloads that
424
+ # are input/output bound. * **Machine Type**: nested virtualization can only be
425
+ # enabled on workstation configurations that specify a machine_type in the N1 or
426
+ # N2 machine series. * **GPUs**: nested virtualization may not be enabled on
427
+ # workstation configurations with accelerators. * **Operating System**: Because [
428
+ # Container-Optimized OS](https://cloud.google.com/compute/docs/images/os-
429
+ # details#container-optimized_os_cos) does not support nested virtualization,
430
+ # when nested virtualization is enabled, the underlying Compute Engine VM
431
+ # instances boot from an [Ubuntu LTS](https://cloud.google.com/compute/docs/
432
+ # images/os-details#ubuntu_lts) image.
433
+ # Corresponds to the JSON property `enableNestedVirtualization`
434
+ # @return [Boolean]
435
+ attr_accessor :enable_nested_virtualization
436
+ alias_method :enable_nested_virtualization?, :enable_nested_virtualization
437
+
438
+ # Optional. The type of machine to use for VM instances—for example, `"e2-
439
+ # standard-4"`. For more information about machine types that Cloud Workstations
440
+ # supports, see the list of [available machine types](https://cloud.google.com/
441
+ # workstations/docs/available-machine-types).
412
442
  # Corresponds to the JSON property `machineType`
413
443
  # @return [String]
414
444
  attr_accessor :machine_type
415
445
 
416
- # The number of VMs that the system should keep idle so that new workstations
417
- # can be started quickly for new users. Defaults to `0` in the API.
446
+ # Optional. The number of VMs that the system should keep idle so that new
447
+ # workstations can be started quickly for new users. Defaults to `0` in the API.
418
448
  # Corresponds to the JSON property `poolSize`
419
449
  # @return [Fixnum]
420
450
  attr_accessor :pool_size
@@ -425,17 +455,17 @@ module Google
425
455
  # @return [Fixnum]
426
456
  attr_accessor :pooled_instances
427
457
 
428
- # The email address of the service account for Cloud Workstations VMs created
429
- # with this configuration. When specified, be sure that the service account has `
430
- # logginglogEntries.create` permission on the project so it can write logs out
431
- # to Cloud Logging. If using a custom container image, the service account must
432
- # have permissions to pull the specified image. If you as the administrator want
433
- # to be able to `ssh` into the underlying VM, you need to set this value to a
434
- # service account for which you have the `iam.serviceAccounts.actAs` permission.
435
- # Conversely, if you don't want anyone to be able to `ssh` into the underlying
436
- # VM, use a service account where no one has that permission. If not set, VMs
437
- # run with a service account provided by the Cloud Workstations service, and the
438
- # image must be publicly accessible.
458
+ # Optional. The email address of the service account for Cloud Workstations VMs
459
+ # created with this configuration. When specified, be sure that the service
460
+ # account has `logginglogEntries.create` permission on the project so it can
461
+ # write logs out to Cloud Logging. If using a custom container image, the
462
+ # service account must have permissions to pull the specified image. If you as
463
+ # the administrator want to be able to `ssh` into the underlying VM, you need to
464
+ # set this value to a service account for which you have the `iam.
465
+ # serviceAccounts.actAs` permission. Conversely, if you don't want anyone to be
466
+ # able to `ssh` into the underlying VM, use a service account where no one has
467
+ # that permission. If not set, VMs run with a service account provided by the
468
+ # Cloud Workstations service, and the image must be publicly accessible.
439
469
  # Corresponds to the JSON property `serviceAccount`
440
470
  # @return [String]
441
471
  attr_accessor :service_account
@@ -445,10 +475,10 @@ module Google
445
475
  # @return [Google::Apis::WorkstationsV1beta::GceShieldedInstanceConfig]
446
476
  attr_accessor :shielded_instance_config
447
477
 
448
- # Network tags to add to the Compute Engine machines backing the workstations.
449
- # This option applies [network tags](https://cloud.google.com/vpc/docs/add-
450
- # remove-network-tags) to VMs created with this configuration. These network
451
- # tags enable the creation of [firewall rules](https://cloud.google.com/
478
+ # Optional. Network tags to add to the Compute Engine VMs backing the
479
+ # workstations. This option applies [network tags](https://cloud.google.com/vpc/
480
+ # docs/add-remove-network-tags) to VMs created with this configuration. These
481
+ # network tags enable the creation of [firewall rules](https://cloud.google.com/
452
482
  # workstations/docs/configure-firewall-rules).
453
483
  # Corresponds to the JSON property `tags`
454
484
  # @return [Array<String>]
@@ -464,6 +494,7 @@ module Google
464
494
  @boot_disk_size_gb = args[:boot_disk_size_gb] if args.key?(:boot_disk_size_gb)
465
495
  @confidential_instance_config = args[:confidential_instance_config] if args.key?(:confidential_instance_config)
466
496
  @disable_public_ip_addresses = args[:disable_public_ip_addresses] if args.key?(:disable_public_ip_addresses)
497
+ @enable_nested_virtualization = args[:enable_nested_virtualization] if args.key?(:enable_nested_virtualization)
467
498
  @machine_type = args[:machine_type] if args.key?(:machine_type)
468
499
  @pool_size = args[:pool_size] if args.key?(:pool_size)
469
500
  @pooled_instances = args[:pooled_instances] if args.key?(:pooled_instances)
@@ -474,7 +505,7 @@ module Google
474
505
  end
475
506
 
476
507
  # A PersistentDirectory backed by a Compute Engine regional persistent disk. The
477
- # `persistentDirectories[]` field is repeated, but it may contain only one entry.
508
+ # persistent_directories field is repeated, but it may contain only one entry.
478
509
  # It creates a [persistent disk](https://cloud.google.com/compute/docs/disks/
479
510
  # persistent-disks) that mounts to the workstation VM at `/home` when the
480
511
  # session starts and detaches when the session ends. If this field is empty,
@@ -483,35 +514,35 @@ module Google
483
514
  class GceRegionalPersistentDisk
484
515
  include Google::Apis::Core::Hashable
485
516
 
486
- # The [type of the persistent disk](https://cloud.google.com/compute/docs/disks#
487
- # disk-types) for the home directory. Defaults to `pd-standard`.
517
+ # Optional. The [type of the persistent disk](https://cloud.google.com/compute/
518
+ # docs/disks#disk-types) for the home directory. Defaults to `"pd-standard"`.
488
519
  # Corresponds to the JSON property `diskType`
489
520
  # @return [String]
490
521
  attr_accessor :disk_type
491
522
 
492
- # Type of file system that the disk should be formatted with. The workstation
493
- # image must support this file system type. Must be empty if source_snapshot is
494
- # set. Defaults to `ext4`.
523
+ # Optional. Type of file system that the disk should be formatted with. The
524
+ # workstation image must support this file system type. Must be empty if
525
+ # source_snapshot is set. Defaults to `"ext4"`.
495
526
  # Corresponds to the JSON property `fsType`
496
527
  # @return [String]
497
528
  attr_accessor :fs_type
498
529
 
499
- # Whether the persistent disk should be deleted when the workstation is deleted.
500
- # Valid values are `DELETE` and `RETAIN`. Defaults to `DELETE`.
530
+ # Optional. Whether the persistent disk should be deleted when the workstation
531
+ # is deleted. Valid values are `DELETE` and `RETAIN`. Defaults to `DELETE`.
501
532
  # Corresponds to the JSON property `reclaimPolicy`
502
533
  # @return [String]
503
534
  attr_accessor :reclaim_policy
504
535
 
505
- # The GB capacity of a persistent home directory for each workstation created
506
- # with this configuration. Must be empty if `source_snapshot` is set. Valid
507
- # values are `10`, `50`, `100`, `200`, `500`, or `1000`. Defaults to `200`. If
508
- # less than `200` GB, the `diskType` must be `pd-balanced` or `pd-ssd`.
536
+ # Optional. The GB capacity of a persistent home directory for each workstation
537
+ # created with this configuration. Must be empty if source_snapshot is set.
538
+ # Valid values are `10`, `50`, `100`, `200`, `500`, or `1000`. Defaults to `200`.
539
+ # If less than `200` GB, the disk_type must be `"pd-balanced"` or `"pd-ssd"`.
509
540
  # Corresponds to the JSON property `sizeGb`
510
541
  # @return [Fixnum]
511
542
  attr_accessor :size_gb
512
543
 
513
- # Name of the snapshot to use as the source for the disk. If set, size_gb and
514
- # fs_type must be empty.
544
+ # Optional. Name of the snapshot to use as the source for the disk. If set,
545
+ # size_gb and fs_type must be empty.
515
546
  # Corresponds to the JSON property `sourceSnapshot`
516
547
  # @return [String]
517
548
  attr_accessor :source_snapshot
@@ -534,19 +565,19 @@ module Google
534
565
  class GceShieldedInstanceConfig
535
566
  include Google::Apis::Core::Hashable
536
567
 
537
- # Whether the instance has integrity monitoring enabled.
568
+ # Optional. Whether the instance has integrity monitoring enabled.
538
569
  # Corresponds to the JSON property `enableIntegrityMonitoring`
539
570
  # @return [Boolean]
540
571
  attr_accessor :enable_integrity_monitoring
541
572
  alias_method :enable_integrity_monitoring?, :enable_integrity_monitoring
542
573
 
543
- # Whether the instance has Secure Boot enabled.
574
+ # Optional. Whether the instance has Secure Boot enabled.
544
575
  # Corresponds to the JSON property `enableSecureBoot`
545
576
  # @return [Boolean]
546
577
  attr_accessor :enable_secure_boot
547
578
  alias_method :enable_secure_boot?, :enable_secure_boot
548
579
 
549
- # Whether the instance has the vTPM enabled.
580
+ # Optional. Whether the instance has the vTPM enabled.
550
581
  # Corresponds to the JSON property `enableVtpm`
551
582
  # @return [Boolean]
552
583
  attr_accessor :enable_vtpm
@@ -812,13 +843,13 @@ module Google
812
843
  class ListWorkstationsResponse
813
844
  include Google::Apis::Core::Hashable
814
845
 
815
- # Token to retrieve the next page of results, or empty if there are no more
816
- # results in the list.
846
+ # Optional. Token to retrieve the next page of results, or empty if there are no
847
+ # more results in the list.
817
848
  # Corresponds to the JSON property `nextPageToken`
818
849
  # @return [String]
819
850
  attr_accessor :next_page_token
820
851
 
821
- # Unreachable resources.
852
+ # Optional. Unreachable resources.
822
853
  # Corresponds to the JSON property `unreachable`
823
854
  # @return [Array<String>]
824
855
  attr_accessor :unreachable
@@ -877,13 +908,13 @@ module Google
877
908
  # @return [String]
878
909
  attr_accessor :name
879
910
 
880
- # The normal response of the operation in case of success. If the original
881
- # method returns no data on success, such as `Delete`, the response is `google.
882
- # protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`,
883
- # the response should be the resource. For other methods, the response should
884
- # have the type `XxxResponse`, where `Xxx` is the original method name. For
885
- # example, if the original method name is `TakeSnapshot()`, the inferred
886
- # response type is `TakeSnapshotResponse`.
911
+ # The normal, successful response of the operation. If the original method
912
+ # returns no data on success, such as `Delete`, the response is `google.protobuf.
913
+ # Empty`. If the original method is standard `Get`/`Create`/`Update`, the
914
+ # response should be the resource. For other methods, the response should have
915
+ # the type `XxxResponse`, where `Xxx` is the original method name. For example,
916
+ # if the original method name is `TakeSnapshot()`, the inferred response type is
917
+ # `TakeSnapshotResponse`.
887
918
  # Corresponds to the JSON property `response`
888
919
  # @return [Hash<String,Object>]
889
920
  attr_accessor :response
@@ -964,7 +995,7 @@ module Google
964
995
  include Google::Apis::Core::Hashable
965
996
 
966
997
  # A PersistentDirectory backed by a Compute Engine regional persistent disk. The
967
- # `persistentDirectories[]` field is repeated, but it may contain only one entry.
998
+ # persistent_directories field is repeated, but it may contain only one entry.
968
999
  # It creates a [persistent disk](https://cloud.google.com/compute/docs/disks/
969
1000
  # persistent-disks) that mounts to the workstation VM at `/home` when the
970
1001
  # session starts and detaches when the session ends. If this field is empty,
@@ -974,7 +1005,7 @@ module Google
974
1005
  # @return [Google::Apis::WorkstationsV1beta::GceRegionalPersistentDisk]
975
1006
  attr_accessor :gce_pd
976
1007
 
977
- # Location of this directory in the running workstation.
1008
+ # Optional. Location of this directory in the running workstation.
978
1009
  # Corresponds to the JSON property `mountPath`
979
1010
  # @return [String]
980
1011
  attr_accessor :mount_path
@@ -1001,22 +1032,22 @@ module Google
1001
1032
  # evaluates to `true`. A condition can add constraints based on attributes of
1002
1033
  # the request, the resource, or both. To learn which resources support
1003
1034
  # conditions in their IAM policies, see the [IAM documentation](https://cloud.
1004
- # google.com/iam/help/conditions/resource-policies). **JSON example:** ` "
1035
+ # google.com/iam/help/conditions/resource-policies). **JSON example:** ``` ` "
1005
1036
  # bindings": [ ` "role": "roles/resourcemanager.organizationAdmin", "members": [
1006
1037
  # "user:mike@example.com", "group:admins@example.com", "domain:google.com", "
1007
1038
  # serviceAccount:my-project-id@appspot.gserviceaccount.com" ] `, ` "role": "
1008
1039
  # roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com"
1009
1040
  # ], "condition": ` "title": "expirable access", "description": "Does not grant
1010
1041
  # access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:
1011
- # 00:00.000Z')", ` ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:**
1012
- # bindings: - members: - user:mike@example.com - group:admins@example.com -
1013
- # domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com
1014
- # role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.
1015
- # com role: roles/resourcemanager.organizationViewer condition: title: expirable
1016
- # access description: Does not grant access after Sep 2020 expression: request.
1017
- # time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 For
1018
- # a description of IAM and its features, see the [IAM documentation](https://
1019
- # cloud.google.com/iam/docs/).
1042
+ # 00:00.000Z')", ` ` ], "etag": "BwWWja0YfJA=", "version": 3 ` ``` **YAML
1043
+ # example:** ``` bindings: - members: - user:mike@example.com - group:admins@
1044
+ # example.com - domain:google.com - serviceAccount:my-project-id@appspot.
1045
+ # gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: -
1046
+ # user:eve@example.com role: roles/resourcemanager.organizationViewer condition:
1047
+ # title: expirable access description: Does not grant access after Sep 2020
1048
+ # expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag:
1049
+ # BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the
1050
+ # [IAM documentation](https://cloud.google.com/iam/docs/).
1020
1051
  class Policy
1021
1052
  include Google::Apis::Core::Hashable
1022
1053
 
@@ -1085,21 +1116,22 @@ module Google
1085
1116
  end
1086
1117
  end
1087
1118
 
1088
- # Configuration options for private clusters.
1119
+ # Configuration options for private workstation clusters.
1089
1120
  class PrivateClusterConfig
1090
1121
  include Google::Apis::Core::Hashable
1091
1122
 
1092
- # Additional projects that are allowed to attach to the workstation cluster's
1093
- # service attachment. By default, the workstation cluster's project and the VPC
1094
- # host project (if different) are allowed.
1123
+ # Optional. Additional projects that are allowed to attach to the workstation
1124
+ # cluster's service attachment. By default, the workstation cluster's project
1125
+ # and the VPC host project (if different) are allowed.
1095
1126
  # Corresponds to the JSON property `allowedProjects`
1096
1127
  # @return [Array<String>]
1097
1128
  attr_accessor :allowed_projects
1098
1129
 
1099
1130
  # Output only. Hostname for the workstation cluster. This field will be
1100
1131
  # populated only when private endpoint is enabled. To access workstations in the
1101
- # cluster, create a new DNS zone mapping this domain name to an internal IP
1102
- # address and a forwarding rule mapping that address to the service attachment.
1132
+ # workstation cluster, create a new DNS zone mapping this domain name to an
1133
+ # internal IP address and a forwarding rule mapping that address to the service
1134
+ # attachment.
1103
1135
  # Corresponds to the JSON property `clusterHostname`
1104
1136
  # @return [String]
1105
1137
  attr_accessor :cluster_hostname
@@ -1112,9 +1144,9 @@ module Google
1112
1144
 
1113
1145
  # Output only. Service attachment URI for the workstation cluster. The service
1114
1146
  # attachemnt is created when private endpoint is enabled. To access workstations
1115
- # in the cluster, configure access to the managed service using [Private Service
1116
- # Connect](https://cloud.google.com/vpc/docs/configure-private-service-connect-
1117
- # services).
1147
+ # in the workstation cluster, configure access to the managed service using [
1148
+ # Private Service Connect](https://cloud.google.com/vpc/docs/configure-private-
1149
+ # service-connect-services).
1118
1150
  # Corresponds to the JSON property `serviceAttachmentUri`
1119
1151
  # @return [String]
1120
1152
  attr_accessor :service_attachment_uri
@@ -1136,12 +1168,12 @@ module Google
1136
1168
  class ReadinessCheck
1137
1169
  include Google::Apis::Core::Hashable
1138
1170
 
1139
- # Path to which the request should be sent.
1171
+ # Optional. Path to which the request should be sent.
1140
1172
  # Corresponds to the JSON property `path`
1141
1173
  # @return [String]
1142
1174
  attr_accessor :path
1143
1175
 
1144
- # Port to which the request should be sent.
1176
+ # Optional. Port to which the request should be sent.
1145
1177
  # Corresponds to the JSON property `port`
1146
1178
  # @return [Fixnum]
1147
1179
  attr_accessor :port
@@ -1172,22 +1204,22 @@ module Google
1172
1204
  # evaluates to `true`. A condition can add constraints based on attributes of
1173
1205
  # the request, the resource, or both. To learn which resources support
1174
1206
  # conditions in their IAM policies, see the [IAM documentation](https://cloud.
1175
- # google.com/iam/help/conditions/resource-policies). **JSON example:** ` "
1207
+ # google.com/iam/help/conditions/resource-policies). **JSON example:** ``` ` "
1176
1208
  # bindings": [ ` "role": "roles/resourcemanager.organizationAdmin", "members": [
1177
1209
  # "user:mike@example.com", "group:admins@example.com", "domain:google.com", "
1178
1210
  # serviceAccount:my-project-id@appspot.gserviceaccount.com" ] `, ` "role": "
1179
1211
  # roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com"
1180
1212
  # ], "condition": ` "title": "expirable access", "description": "Does not grant
1181
1213
  # access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:
1182
- # 00:00.000Z')", ` ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:**
1183
- # bindings: - members: - user:mike@example.com - group:admins@example.com -
1184
- # domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com
1185
- # role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.
1186
- # com role: roles/resourcemanager.organizationViewer condition: title: expirable
1187
- # access description: Does not grant access after Sep 2020 expression: request.
1188
- # time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 For
1189
- # a description of IAM and its features, see the [IAM documentation](https://
1190
- # cloud.google.com/iam/docs/).
1214
+ # 00:00.000Z')", ` ` ], "etag": "BwWWja0YfJA=", "version": 3 ` ``` **YAML
1215
+ # example:** ``` bindings: - members: - user:mike@example.com - group:admins@
1216
+ # example.com - domain:google.com - serviceAccount:my-project-id@appspot.
1217
+ # gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: -
1218
+ # user:eve@example.com role: roles/resourcemanager.organizationViewer condition:
1219
+ # title: expirable access description: Does not grant access after Sep 2020
1220
+ # expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag:
1221
+ # BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the
1222
+ # [IAM documentation](https://cloud.google.com/iam/docs/).
1191
1223
  # Corresponds to the JSON property `policy`
1192
1224
  # @return [Google::Apis::WorkstationsV1beta::Policy]
1193
1225
  attr_accessor :policy
@@ -1214,14 +1246,14 @@ module Google
1214
1246
  class StartWorkstationRequest
1215
1247
  include Google::Apis::Core::Hashable
1216
1248
 
1217
- # If set, the request will be rejected if the latest version of the workstation
1218
- # on the server does not have this ETag.
1249
+ # Optional. If set, the request will be rejected if the latest version of the
1250
+ # workstation on the server does not have this ETag.
1219
1251
  # Corresponds to the JSON property `etag`
1220
1252
  # @return [String]
1221
1253
  attr_accessor :etag
1222
1254
 
1223
- # If set, validate the request and preview the review, but do not actually apply
1224
- # it.
1255
+ # Optional. If set, validate the request and preview the review, but do not
1256
+ # actually apply it.
1225
1257
  # Corresponds to the JSON property `validateOnly`
1226
1258
  # @return [Boolean]
1227
1259
  attr_accessor :validate_only
@@ -1281,14 +1313,14 @@ module Google
1281
1313
  class StopWorkstationRequest
1282
1314
  include Google::Apis::Core::Hashable
1283
1315
 
1284
- # If set, the request will be rejected if the latest version of the workstation
1285
- # on the server does not have this ETag.
1316
+ # Optional. If set, the request will be rejected if the latest version of the
1317
+ # workstation on the server does not have this ETag.
1286
1318
  # Corresponds to the JSON property `etag`
1287
1319
  # @return [String]
1288
1320
  attr_accessor :etag
1289
1321
 
1290
- # If set, validate the request and preview the review, but do not actually apply
1291
- # it.
1322
+ # Optional. If set, validate the request and preview the review, but do not
1323
+ # actually apply it.
1292
1324
  # Corresponds to the JSON property `validateOnly`
1293
1325
  # @return [Boolean]
1294
1326
  attr_accessor :validate_only
@@ -1349,33 +1381,35 @@ module Google
1349
1381
  class Workstation
1350
1382
  include Google::Apis::Core::Hashable
1351
1383
 
1352
- # Client-specified annotations.
1384
+ # Optional. Client-specified annotations.
1353
1385
  # Corresponds to the JSON property `annotations`
1354
1386
  # @return [Hash<String,String>]
1355
1387
  attr_accessor :annotations
1356
1388
 
1357
- # Output only. Time when this resource was created.
1389
+ # Output only. Time when this workstation was created.
1358
1390
  # Corresponds to the JSON property `createTime`
1359
1391
  # @return [String]
1360
1392
  attr_accessor :create_time
1361
1393
 
1362
- # Output only. Time when this resource was soft-deleted.
1394
+ # Output only. Time when this workstation was soft-deleted.
1363
1395
  # Corresponds to the JSON property `deleteTime`
1364
1396
  # @return [String]
1365
1397
  attr_accessor :delete_time
1366
1398
 
1367
- # Human-readable name for this resource.
1399
+ # Optional. Human-readable name for this workstation.
1368
1400
  # Corresponds to the JSON property `displayName`
1369
1401
  # @return [String]
1370
1402
  attr_accessor :display_name
1371
1403
 
1372
- # Environment variables passed to the workstation container's entrypoint.
1404
+ # Optional. Environment variables passed to the workstation container's
1405
+ # entrypoint.
1373
1406
  # Corresponds to the JSON property `env`
1374
1407
  # @return [Hash<String,String>]
1375
1408
  attr_accessor :env
1376
1409
 
1377
- # Checksum computed by the server. May be sent on update and delete requests to
1378
- # make sure that the client has an up-to-date value before proceeding.
1410
+ # Optional. Checksum computed by the server. May be sent on update and delete
1411
+ # requests to make sure that the client has an up-to-date value before
1412
+ # proceeding.
1379
1413
  # Corresponds to the JSON property `etag`
1380
1414
  # @return [String]
1381
1415
  attr_accessor :etag
@@ -1388,18 +1422,19 @@ module Google
1388
1422
  # @return [String]
1389
1423
  attr_accessor :host
1390
1424
 
1391
- # Client-specified labels that are applied to the resource and that are also
1392
- # propagated to the underlying Compute Engine resources.
1425
+ # Optional. [Labels](https://cloud.google.com/workstations/docs/label-resources)
1426
+ # that are applied to the workstation and that are also propagated to the
1427
+ # underlying Compute Engine resources.
1393
1428
  # Corresponds to the JSON property `labels`
1394
1429
  # @return [Hash<String,String>]
1395
1430
  attr_accessor :labels
1396
1431
 
1397
- # Full name of this resource.
1432
+ # Full name of this workstation.
1398
1433
  # Corresponds to the JSON property `name`
1399
1434
  # @return [String]
1400
1435
  attr_accessor :name
1401
1436
 
1402
- # Output only. Indicates whether this resource is currently being updated to
1437
+ # Output only. Indicates whether this workstation is currently being updated to
1403
1438
  # match its intended state.
1404
1439
  # Corresponds to the JSON property `reconciling`
1405
1440
  # @return [Boolean]
@@ -1411,12 +1446,12 @@ module Google
1411
1446
  # @return [String]
1412
1447
  attr_accessor :state
1413
1448
 
1414
- # Output only. A system-assigned unique identifier for this resource.
1449
+ # Output only. A system-assigned unique identifier for this workstation.
1415
1450
  # Corresponds to the JSON property `uid`
1416
1451
  # @return [String]
1417
1452
  attr_accessor :uid
1418
1453
 
1419
- # Output only. Time when this resource was most recently updated.
1454
+ # Output only. Time when this workstation was most recently updated.
1420
1455
  # Corresponds to the JSON property `updateTime`
1421
1456
  # @return [String]
1422
1457
  attr_accessor :update_time
@@ -1443,100 +1478,103 @@ module Google
1443
1478
  end
1444
1479
  end
1445
1480
 
1446
- # A grouping of workstation configurations and the associated workstations in
1447
- # that region.
1481
+ # A workstation cluster resource in the Cloud Workstations API. Defines a group
1482
+ # of workstations in a particular region and the VPC network they're attached to.
1448
1483
  class WorkstationCluster
1449
1484
  include Google::Apis::Core::Hashable
1450
1485
 
1451
- # Client-specified annotations.
1486
+ # Optional. Client-specified annotations.
1452
1487
  # Corresponds to the JSON property `annotations`
1453
1488
  # @return [Hash<String,String>]
1454
1489
  attr_accessor :annotations
1455
1490
 
1456
- # Output only. Status conditions describing the current resource state.
1491
+ # Output only. Status conditions describing the workstation cluster's current
1492
+ # state.
1457
1493
  # Corresponds to the JSON property `conditions`
1458
1494
  # @return [Array<Google::Apis::WorkstationsV1beta::Status>]
1459
1495
  attr_accessor :conditions
1460
1496
 
1461
- # Output only. The private IP address of the control plane for this cluster.
1462
- # Workstation VMs need access to this IP address to work with the service, so
1463
- # make sure that your firewall rules allow egress from the workstation VMs to
1464
- # this address.
1497
+ # Output only. The private IP address of the control plane for this workstation
1498
+ # cluster. Workstation VMs need access to this IP address to work with the
1499
+ # service, so make sure that your firewall rules allow egress from the
1500
+ # workstation VMs to this address.
1465
1501
  # Corresponds to the JSON property `controlPlaneIp`
1466
1502
  # @return [String]
1467
1503
  attr_accessor :control_plane_ip
1468
1504
 
1469
- # Output only. Time when this resource was created.
1505
+ # Output only. Time when this workstation cluster was created.
1470
1506
  # Corresponds to the JSON property `createTime`
1471
1507
  # @return [String]
1472
1508
  attr_accessor :create_time
1473
1509
 
1474
- # Output only. Whether this resource is in degraded mode, in which case it may
1475
- # require user action to restore full functionality. Details can be found in the
1476
- # `conditions` field.
1510
+ # Output only. Whether this workstation cluster is in degraded mode, in which
1511
+ # case it may require user action to restore full functionality. Details can be
1512
+ # found in conditions.
1477
1513
  # Corresponds to the JSON property `degraded`
1478
1514
  # @return [Boolean]
1479
1515
  attr_accessor :degraded
1480
1516
  alias_method :degraded?, :degraded
1481
1517
 
1482
- # Output only. Time when this resource was soft-deleted.
1518
+ # Output only. Time when this workstation cluster was soft-deleted.
1483
1519
  # Corresponds to the JSON property `deleteTime`
1484
1520
  # @return [String]
1485
1521
  attr_accessor :delete_time
1486
1522
 
1487
- # Human-readable name for this resource.
1523
+ # Optional. Human-readable name for this workstation cluster.
1488
1524
  # Corresponds to the JSON property `displayName`
1489
1525
  # @return [String]
1490
1526
  attr_accessor :display_name
1491
1527
 
1492
- # Checksum computed by the server. May be sent on update and delete requests to
1493
- # make sure that the client has an up-to-date value before proceeding.
1528
+ # Optional. Checksum computed by the server. May be sent on update and delete
1529
+ # requests to make sure that the client has an up-to-date value before
1530
+ # proceeding.
1494
1531
  # Corresponds to the JSON property `etag`
1495
1532
  # @return [String]
1496
1533
  attr_accessor :etag
1497
1534
 
1498
- # Client-specified labels that are applied to the resource and that are also
1499
- # propagated to the underlying Compute Engine resources.
1535
+ # Optional. [Labels](https://cloud.google.com/workstations/docs/label-resources)
1536
+ # that are applied to the workstation cluster and that are also propagated to
1537
+ # the underlying Compute Engine resources.
1500
1538
  # Corresponds to the JSON property `labels`
1501
1539
  # @return [Hash<String,String>]
1502
1540
  attr_accessor :labels
1503
1541
 
1504
- # Full name of this resource.
1542
+ # Full name of this workstation cluster.
1505
1543
  # Corresponds to the JSON property `name`
1506
1544
  # @return [String]
1507
1545
  attr_accessor :name
1508
1546
 
1509
1547
  # Immutable. Name of the Compute Engine network in which instances associated
1510
- # with this cluster will be created.
1548
+ # with this workstation cluster will be created.
1511
1549
  # Corresponds to the JSON property `network`
1512
1550
  # @return [String]
1513
1551
  attr_accessor :network
1514
1552
 
1515
- # Configuration options for private clusters.
1553
+ # Configuration options for private workstation clusters.
1516
1554
  # Corresponds to the JSON property `privateClusterConfig`
1517
1555
  # @return [Google::Apis::WorkstationsV1beta::PrivateClusterConfig]
1518
1556
  attr_accessor :private_cluster_config
1519
1557
 
1520
- # Output only. Indicates whether this resource is currently being updated to
1521
- # match its intended state.
1558
+ # Output only. Indicates whether this workstation cluster is currently being
1559
+ # updated to match its intended state.
1522
1560
  # Corresponds to the JSON property `reconciling`
1523
1561
  # @return [Boolean]
1524
1562
  attr_accessor :reconciling
1525
1563
  alias_method :reconciling?, :reconciling
1526
1564
 
1527
1565
  # Immutable. Name of the Compute Engine subnetwork in which instances associated
1528
- # with this cluster will be created. Must be part of the subnetwork specified
1529
- # for this cluster.
1566
+ # with this workstation cluster will be created. Must be part of the subnetwork
1567
+ # specified for this workstation cluster.
1530
1568
  # Corresponds to the JSON property `subnetwork`
1531
1569
  # @return [String]
1532
1570
  attr_accessor :subnetwork
1533
1571
 
1534
- # Output only. A system-assigned unique identifier for this resource.
1572
+ # Output only. A system-assigned unique identifier for this workstation cluster.
1535
1573
  # Corresponds to the JSON property `uid`
1536
1574
  # @return [String]
1537
1575
  attr_accessor :uid
1538
1576
 
1539
- # Output only. Time when this resource was most recently updated.
1577
+ # Output only. Time when this workstation cluster was most recently updated.
1540
1578
  # Corresponds to the JSON property `updateTime`
1541
1579
  # @return [String]
1542
1580
  attr_accessor :update_time
@@ -1566,13 +1604,17 @@ module Google
1566
1604
  end
1567
1605
  end
1568
1606
 
1569
- # A set of configuration options that describe how a workstation runs.
1570
- # Workstation configurations are intended to be shared across multiple
1571
- # workstations.
1607
+ # A workstation configuration resource in the Cloud Workstations API.
1608
+ # Workstation configurations act as templates for workstations. The workstation
1609
+ # configuration defines details such as the workstation virtual machine (VM)
1610
+ # instance type, persistent storage, container image defining environment, which
1611
+ # IDE or Code Editor to use, and more. Administrators and platform teams can
1612
+ # also use [Identity and Access Management (IAM)](https://cloud.google.com/iam/
1613
+ # docs/overview) rules to grant access to teams or to individual developers.
1572
1614
  class WorkstationConfig
1573
1615
  include Google::Apis::Core::Hashable
1574
1616
 
1575
- # Client-specified annotations.
1617
+ # Optional. Client-specified annotations.
1576
1618
  # Corresponds to the JSON property `annotations`
1577
1619
  # @return [Hash<String,String>]
1578
1620
  attr_accessor :annotations
@@ -1587,33 +1629,33 @@ module Google
1587
1629
  # @return [Google::Apis::WorkstationsV1beta::Container]
1588
1630
  attr_accessor :container
1589
1631
 
1590
- # Output only. Time when this resource was created.
1632
+ # Output only. Time when this workstation configuration was created.
1591
1633
  # Corresponds to the JSON property `createTime`
1592
1634
  # @return [String]
1593
1635
  attr_accessor :create_time
1594
1636
 
1595
- # Output only. Whether this resource is in degraded mode, in which case it may
1596
- # require user action to restore full functionality. Details can be found in the
1597
- # `conditions` field.
1637
+ # Output only. Whether this resource is degraded, in which case it may require
1638
+ # user action to restore full functionality. See also the conditions field.
1598
1639
  # Corresponds to the JSON property `degraded`
1599
1640
  # @return [Boolean]
1600
1641
  attr_accessor :degraded
1601
1642
  alias_method :degraded?, :degraded
1602
1643
 
1603
- # Output only. Time when this resource was soft-deleted.
1644
+ # Output only. Time when this workstation configuration was soft-deleted.
1604
1645
  # Corresponds to the JSON property `deleteTime`
1605
1646
  # @return [String]
1606
1647
  attr_accessor :delete_time
1607
1648
 
1608
- # Human-readable name for this resource.
1649
+ # Optional. Human-readable name for this workstation configuration.
1609
1650
  # Corresponds to the JSON property `displayName`
1610
1651
  # @return [String]
1611
1652
  attr_accessor :display_name
1612
1653
 
1613
- # Whether to enable Linux `auditd` logging on the workstation. When enabled, a
1614
- # service account must also be specified that has `logging.buckets.write`
1615
- # permission on the project. Operating system audit logging is distinct from [
1616
- # Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging).
1654
+ # Optional. Whether to enable Linux `auditd` logging on the workstation. When
1655
+ # enabled, a service account must also be specified that has `logging.buckets.
1656
+ # write` permission on the project. Operating system audit logging is distinct
1657
+ # from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-
1658
+ # logging).
1617
1659
  # Corresponds to the JSON property `enableAuditAgent`
1618
1660
  # @return [Boolean]
1619
1661
  attr_accessor :enable_audit_agent
@@ -1628,8 +1670,9 @@ module Google
1628
1670
  # @return [Google::Apis::WorkstationsV1beta::CustomerEncryptionKey]
1629
1671
  attr_accessor :encryption_key
1630
1672
 
1631
- # Checksum computed by the server. May be sent on update and delete requests to
1632
- # make sure that the client has an up-to-date value before proceeding.
1673
+ # Optional. Checksum computed by the server. May be sent on update and delete
1674
+ # requests to make sure that the client has an up-to-date value before
1675
+ # proceeding.
1633
1676
  # Corresponds to the JSON property `etag`
1634
1677
  # @return [String]
1635
1678
  attr_accessor :etag
@@ -1639,69 +1682,72 @@ module Google
1639
1682
  # @return [Google::Apis::WorkstationsV1beta::Host]
1640
1683
  attr_accessor :host
1641
1684
 
1642
- # Number of seconds to wait before automatically stopping a workstation after it
1643
- # last received user traffic. A value of `0s` indicates that Cloud Workstations
1644
- # VMs created with this configuration should never time out due to idleness.
1645
- # Provide [duration](https://developers.google.com/protocol-buffers/docs/
1646
- # reference/google.protobuf#duration) terminated by `s` for seconds—for example,
1647
- # `7200s` (2 hours). The default is `1200s` (20 minutes).
1685
+ # Optional. Number of seconds to wait before automatically stopping a
1686
+ # workstation after it last received user traffic. A value of `"0s"` indicates
1687
+ # that Cloud Workstations VMs created with this configuration should never time
1688
+ # out due to idleness. Provide [duration](https://developers.google.com/protocol-
1689
+ # buffers/docs/reference/google.protobuf#duration) terminated by `s` for seconds—
1690
+ # for example, `"7200s"` (2 hours). The default is `"1200s"` (20 minutes).
1648
1691
  # Corresponds to the JSON property `idleTimeout`
1649
1692
  # @return [String]
1650
1693
  attr_accessor :idle_timeout
1651
1694
 
1652
- # Client-specified labels that are applied to the resource and that are also
1653
- # propagated to the underlying Compute Engine resources.
1695
+ # Optional. [Labels](https://cloud.google.com/workstations/docs/label-resources)
1696
+ # that are applied to the workstation configuration and that are also propagated
1697
+ # to the underlying Compute Engine resources.
1654
1698
  # Corresponds to the JSON property `labels`
1655
1699
  # @return [Hash<String,String>]
1656
1700
  attr_accessor :labels
1657
1701
 
1658
- # Full name of this resource.
1702
+ # Full name of this workstation configuration.
1659
1703
  # Corresponds to the JSON property `name`
1660
1704
  # @return [String]
1661
1705
  attr_accessor :name
1662
1706
 
1663
- # Directories to persist across workstation sessions.
1707
+ # Optional. Directories to persist across workstation sessions.
1664
1708
  # Corresponds to the JSON property `persistentDirectories`
1665
1709
  # @return [Array<Google::Apis::WorkstationsV1beta::PersistentDirectory>]
1666
1710
  attr_accessor :persistent_directories
1667
1711
 
1668
- # Readiness checks to perform when starting a workstation using this workstation
1669
- # configuration. Mark a workstation as running only after all specified
1670
- # readiness checks return 200 status codes.
1712
+ # Optional. Readiness checks to perform when starting a workstation using this
1713
+ # workstation configuration. Mark a workstation as running only after all
1714
+ # specified readiness checks return 200 status codes.
1671
1715
  # Corresponds to the JSON property `readinessChecks`
1672
1716
  # @return [Array<Google::Apis::WorkstationsV1beta::ReadinessCheck>]
1673
1717
  attr_accessor :readiness_checks
1674
1718
 
1675
- # Output only. Indicates whether this resource is currently being updated to
1676
- # match its intended state.
1719
+ # Output only. Indicates whether this workstation configuration is currently
1720
+ # being updated to match its intended state.
1677
1721
  # Corresponds to the JSON property `reconciling`
1678
1722
  # @return [Boolean]
1679
1723
  attr_accessor :reconciling
1680
1724
  alias_method :reconciling?, :reconciling
1681
1725
 
1682
- # Number of seconds that a workstation can run until it is automatically shut
1683
- # down. We recommend that workstations be shut down daily to reduce costs and so
1684
- # that security updates can be applied upon restart. The `idleTimeout` and `
1685
- # runningTimeout` parameters are independent of each other. Note that the `
1686
- # runningTimeout` parameter shuts down VMs after the specified time, regardless
1687
- # of whether or not the VMs are idle. Provide duration terminated by `s` for
1688
- # seconds—for example, `54000s` (15 hours). Defaults to `43200s` (12 hours). A
1689
- # value of `0` indicates that workstations using this configuration should never
1690
- # time out. If `encryption_key` is set, it must be greater than `0` and less
1691
- # than `86400s` (24 hours). Warning: A value of `0s` indicates that Cloud
1692
- # Workstations VMs created with this configuration have no maximum running time.
1693
- # This is strongly discouraged because you incur costs and will not pick up
1694
- # security updates.
1726
+ # Optional. Number of seconds that a workstation can run until it is
1727
+ # automatically shut down. We recommend that workstations be shut down daily to
1728
+ # reduce costs and so that security updates can be applied upon restart. The
1729
+ # idle_timeout and running_timeout fields are independent of each other. Note
1730
+ # that the running_timeout field shuts down VMs after the specified time,
1731
+ # regardless of whether or not the VMs are idle. Provide duration terminated by `
1732
+ # s` for seconds—for example, `"54000s"` (15 hours). Defaults to `"43200s"` (12
1733
+ # hours). A value of `"0s"` indicates that workstations using this configuration
1734
+ # should never time out. If encryption_key is set, it must be greater than `"0s"`
1735
+ # and less than `"86400s"` (24 hours). Warning: A value of `"0s"` indicates
1736
+ # that Cloud Workstations VMs created with this configuration have no maximum
1737
+ # running time. This is strongly discouraged because you incur costs and will
1738
+ # not pick up security updates.
1695
1739
  # Corresponds to the JSON property `runningTimeout`
1696
1740
  # @return [String]
1697
1741
  attr_accessor :running_timeout
1698
1742
 
1699
- # Output only. A system-assigned unique identifier for this resource.
1743
+ # Output only. A system-assigned unique identifier for this workstation
1744
+ # configuration.
1700
1745
  # Corresponds to the JSON property `uid`
1701
1746
  # @return [String]
1702
1747
  attr_accessor :uid
1703
1748
 
1704
- # Output only. Time when this resource was most recently updated.
1749
+ # Output only. Time when this workstation configuration was most recently
1750
+ # updated.
1705
1751
  # Corresponds to the JSON property `updateTime`
1706
1752
  # @return [String]
1707
1753
  attr_accessor :update_time
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module WorkstationsV1beta
18
18
  # Version of the google-apis-workstations_v1beta gem
19
- GEM_VERSION = "0.13.0"
19
+ GEM_VERSION = "0.15.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
22
  GENERATOR_VERSION = "0.12.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20230531"
25
+ REVISION = "20230802"
26
26
  end
27
27
  end
28
28
  end
@@ -331,6 +331,7 @@ module Google
331
331
  property :confidential_instance_config, as: 'confidentialInstanceConfig', class: Google::Apis::WorkstationsV1beta::GceConfidentialInstanceConfig, decorator: Google::Apis::WorkstationsV1beta::GceConfidentialInstanceConfig::Representation
332
332
 
333
333
  property :disable_public_ip_addresses, as: 'disablePublicIpAddresses'
334
+ property :enable_nested_virtualization, as: 'enableNestedVirtualization'
334
335
  property :machine_type, as: 'machineType'
335
336
  property :pool_size, as: 'poolSize'
336
337
  property :pooled_instances, as: 'pooledInstances'
@@ -198,8 +198,8 @@ module Google
198
198
  # Required. Parent resource name.
199
199
  # @param [Google::Apis::WorkstationsV1beta::WorkstationCluster] workstation_cluster_object
200
200
  # @param [Boolean] validate_only
201
- # If set, validate the request and preview the review, but do not actually apply
202
- # it.
201
+ # Optional. If set, validate the request and preview the review, but do not
202
+ # actually apply it.
203
203
  # @param [String] workstation_cluster_id
204
204
  # Required. ID to use for the workstation cluster.
205
205
  # @param [String] fields
@@ -237,14 +237,15 @@ module Google
237
237
  # @param [String] name
238
238
  # Required. Name of the workstation cluster to delete.
239
239
  # @param [String] etag
240
- # If set, the request will be rejected if the latest version of the workstation
241
- # cluster on the server does not have this ETag.
240
+ # Optional. If set, the request will be rejected if the latest version of the
241
+ # workstation cluster on the server does not have this ETag.
242
242
  # @param [Boolean] force
243
- # If set, any workstation configurations and workstations in the workstation
244
- # cluster are also deleted. Otherwise, the request only works if the workstation
245
- # cluster has no configurations or workstations.
243
+ # Optional. If set, any workstation configurations and workstations in the
244
+ # workstation cluster are also deleted. Otherwise, the request only works if the
245
+ # workstation cluster has no configurations or workstations.
246
246
  # @param [Boolean] validate_only
247
- # If set, validate the request and preview the review, but do not apply it.
247
+ # Optional. If set, validate the request and preview the review, but do not
248
+ # apply it.
248
249
  # @param [String] fields
249
250
  # Selector specifying which fields to include in a partial response.
250
251
  # @param [String] quota_user
@@ -309,9 +310,9 @@ module Google
309
310
  # @param [String] parent
310
311
  # Required. Parent resource name.
311
312
  # @param [Fixnum] page_size
312
- # Maximum number of items to return.
313
+ # Optional. Maximum number of items to return.
313
314
  # @param [String] page_token
314
- # next_page_token value returned from a previous List request, if any.
315
+ # Optional. next_page_token value returned from a previous List request, if any.
315
316
  # @param [String] fields
316
317
  # Selector specifying which fields to include in a partial response.
317
318
  # @param [String] quota_user
@@ -343,17 +344,17 @@ module Google
343
344
 
344
345
  # Updates an existing workstation cluster.
345
346
  # @param [String] name
346
- # Full name of this resource.
347
+ # Full name of this workstation cluster.
347
348
  # @param [Google::Apis::WorkstationsV1beta::WorkstationCluster] workstation_cluster_object
348
349
  # @param [Boolean] allow_missing
349
- # If set, and the workstation cluster is not found, a new workstation cluster
350
- # will be created. In this situation, update_mask is ignored.
350
+ # Optional. If set, and the workstation cluster is not found, a new workstation
351
+ # cluster will be created. In this situation, update_mask is ignored.
351
352
  # @param [String] update_mask
352
353
  # Required. Mask that specifies which fields in the workstation cluster should
353
354
  # be updated.
354
355
  # @param [Boolean] validate_only
355
- # If set, validate the request and preview the review, but do not actually apply
356
- # it.
356
+ # Optional. If set, validate the request and preview the review, but do not
357
+ # actually apply it.
357
358
  # @param [String] fields
358
359
  # Selector specifying which fields to include in a partial response.
359
360
  # @param [String] quota_user
@@ -391,8 +392,8 @@ module Google
391
392
  # Required. Parent resource name.
392
393
  # @param [Google::Apis::WorkstationsV1beta::WorkstationConfig] workstation_config_object
393
394
  # @param [Boolean] validate_only
394
- # If set, validate the request and preview the review, but do not actually apply
395
- # it.
395
+ # Optional. If set, validate the request and preview the review, but do not
396
+ # actually apply it.
396
397
  # @param [String] workstation_config_id
397
398
  # Required. ID to use for the workstation configuration.
398
399
  # @param [String] fields
@@ -430,15 +431,15 @@ module Google
430
431
  # @param [String] name
431
432
  # Required. Name of the workstation configuration to delete.
432
433
  # @param [String] etag
433
- # If set, the request is rejected if the latest version of the workstation
434
- # configuration on the server does not have this ETag.
434
+ # Optional. If set, the request is rejected if the latest version of the
435
+ # workstation configuration on the server does not have this ETag.
435
436
  # @param [Boolean] force
436
- # If set, any workstations in the workstation configuration are also deleted.
437
- # Otherwise, the request works only if the workstation configuration has no
438
- # workstations.
437
+ # Optional. If set, any workstations in the workstation configuration are also
438
+ # deleted. Otherwise, the request works only if the workstation configuration
439
+ # has no workstations.
439
440
  # @param [Boolean] validate_only
440
- # If set, validate the request and preview the review, but do not actually apply
441
- # it.
441
+ # Optional. If set, validate the request and preview the review, but do not
442
+ # actually apply it.
442
443
  # @param [String] fields
443
444
  # Selector specifying which fields to include in a partial response.
444
445
  # @param [String] quota_user
@@ -548,9 +549,9 @@ module Google
548
549
  # @param [String] parent
549
550
  # Required. Parent resource name.
550
551
  # @param [Fixnum] page_size
551
- # Maximum number of items to return.
552
+ # Optional. Maximum number of items to return.
552
553
  # @param [String] page_token
553
- # next_page_token value returned from a previous List request, if any.
554
+ # Optional. next_page_token value returned from a previous List request, if any.
554
555
  # @param [String] fields
555
556
  # Selector specifying which fields to include in a partial response.
556
557
  # @param [String] quota_user
@@ -585,9 +586,9 @@ module Google
585
586
  # @param [String] parent
586
587
  # Required. Parent resource name.
587
588
  # @param [Fixnum] page_size
588
- # Maximum number of items to return.
589
+ # Optional. Maximum number of items to return.
589
590
  # @param [String] page_token
590
- # next_page_token value returned from a previous List request, if any.
591
+ # Optional. next_page_token value returned from a previous List request, if any.
591
592
  # @param [String] fields
592
593
  # Selector specifying which fields to include in a partial response.
593
594
  # @param [String] quota_user
@@ -619,17 +620,18 @@ module Google
619
620
 
620
621
  # Updates an existing workstation configuration.
621
622
  # @param [String] name
622
- # Full name of this resource.
623
+ # Full name of this workstation configuration.
623
624
  # @param [Google::Apis::WorkstationsV1beta::WorkstationConfig] workstation_config_object
624
625
  # @param [Boolean] allow_missing
625
- # If set and the workstation configuration is not found, a new workstation
626
- # configuration will be created. In this situation, update_mask is ignored.
626
+ # Optional. If set and the workstation configuration is not found, a new
627
+ # workstation configuration will be created. In this situation, update_mask is
628
+ # ignored.
627
629
  # @param [String] update_mask
628
630
  # Required. Mask specifying which fields in the workstation configuration should
629
631
  # be updated.
630
632
  # @param [Boolean] validate_only
631
- # If set, validate the request and preview the review, but do not actually apply
632
- # it.
633
+ # Optional. If set, validate the request and preview the review, but do not
634
+ # actually apply it.
633
635
  # @param [String] fields
634
636
  # Selector specifying which fields to include in a partial response.
635
637
  # @param [String] quota_user
@@ -743,8 +745,8 @@ module Google
743
745
  # Required. Parent resource name.
744
746
  # @param [Google::Apis::WorkstationsV1beta::Workstation] workstation_object
745
747
  # @param [Boolean] validate_only
746
- # If set, validate the request and preview the review, but do not actually apply
747
- # it.
748
+ # Optional. If set, validate the request and preview the review, but do not
749
+ # actually apply it.
748
750
  # @param [String] workstation_id
749
751
  # Required. ID to use for the workstation.
750
752
  # @param [String] fields
@@ -782,11 +784,11 @@ module Google
782
784
  # @param [String] name
783
785
  # Required. Name of the workstation to delete.
784
786
  # @param [String] etag
785
- # If set, the request will be rejected if the latest version of the workstation
786
- # on the server does not have this ETag.
787
+ # Optional. If set, the request will be rejected if the latest version of the
788
+ # workstation on the server does not have this ETag.
787
789
  # @param [Boolean] validate_only
788
- # If set, validate the request and preview the review, but do not actually apply
789
- # it.
790
+ # Optional. If set, validate the request and preview the review, but do not
791
+ # actually apply it.
790
792
  # @param [String] fields
791
793
  # Selector specifying which fields to include in a partial response.
792
794
  # @param [String] quota_user
@@ -930,9 +932,9 @@ module Google
930
932
  # @param [String] parent
931
933
  # Required. Parent resource name.
932
934
  # @param [Fixnum] page_size
933
- # Maximum number of items to return.
935
+ # Optional. Maximum number of items to return.
934
936
  # @param [String] page_token
935
- # next_page_token value returned from a previous List request, if any.
937
+ # Optional. next_page_token value returned from a previous List request, if any.
936
938
  # @param [String] fields
937
939
  # Selector specifying which fields to include in a partial response.
938
940
  # @param [String] quota_user
@@ -967,9 +969,9 @@ module Google
967
969
  # @param [String] parent
968
970
  # Required. Parent resource name.
969
971
  # @param [Fixnum] page_size
970
- # Maximum number of items to return.
972
+ # Optional. Maximum number of items to return.
971
973
  # @param [String] page_token
972
- # next_page_token value returned from a previous List request, if any.
974
+ # Optional. next_page_token value returned from a previous List request, if any.
973
975
  # @param [String] fields
974
976
  # Selector specifying which fields to include in a partial response.
975
977
  # @param [String] quota_user
@@ -1001,17 +1003,18 @@ module Google
1001
1003
 
1002
1004
  # Updates an existing workstation.
1003
1005
  # @param [String] name
1004
- # Full name of this resource.
1006
+ # Full name of this workstation.
1005
1007
  # @param [Google::Apis::WorkstationsV1beta::Workstation] workstation_object
1006
1008
  # @param [Boolean] allow_missing
1007
- # If set and the workstation configuration is not found, a new workstation
1008
- # configuration is created. In this situation, update_mask is ignored.
1009
+ # Optional. If set and the workstation configuration is not found, a new
1010
+ # workstation configuration is created. In this situation, update_mask is
1011
+ # ignored.
1009
1012
  # @param [String] update_mask
1010
1013
  # Required. Mask specifying which fields in the workstation configuration should
1011
1014
  # be updated.
1012
1015
  # @param [Boolean] validate_only
1013
- # If set, validate the request and preview the review, but do not actually apply
1014
- # it.
1016
+ # Optional. If set, validate the request and preview the review, but do not
1017
+ # actually apply it.
1015
1018
  # @param [String] fields
1016
1019
  # Selector specifying which fields to include in a partial response.
1017
1020
  # @param [String] quota_user
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-workstations_v1beta
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.13.0
4
+ version: 0.15.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-06-11 00:00:00.000000000 Z
11
+ date: 2023-08-13 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
58
58
  metadata:
59
59
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
60
60
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-workstations_v1beta/CHANGELOG.md
61
- documentation_uri: https://googleapis.dev/ruby/google-apis-workstations_v1beta/v0.13.0
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-workstations_v1beta/v0.15.0
62
62
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-workstations_v1beta
63
63
  post_install_message:
64
64
  rdoc_options: []