feat(workstations): update the API

#### workstations:v1beta

The following keys were added:
- schemas.GceInstance.properties.instanceMetadata.additionalProperties.type
- schemas.GceInstance.properties.instanceMetadata.description
- schemas.GceInstance.properties.instanceMetadata.type

The following keys were changed:
- resources.projects.resources.locations.resources.operations.methods.list.parameters.returnPartialSuccess.description
- schemas.GceHyperdiskBalancedHighAvailability.description
- schemas.GceInstance.properties.startupScriptUri.description
- schemas.ListOperationsResponse.properties.unreachable.description

#### workstations:v1

The following keys were added:
- schemas.GceHyperdiskBalancedHighAvailability.description
- schemas.GceHyperdiskBalancedHighAvailability.id
- schemas.GceHyperdiskBalancedHighAvailability.properties.archiveTimeout.description
- schemas.GceHyperdiskBalancedHighAvailability.properties.archiveTimeout.format
- schemas.GceHyperdiskBalancedHighAvailability.properties.archiveTimeout.type
- schemas.GceHyperdiskBalancedHighAvailability.properties.reclaimPolicy.description
- schemas.GceHyperdiskBalancedHighAvailability.properties.reclaimPolicy.enum
- schemas.GceHyperdiskBalancedHighAvailability.properties.reclaimPolicy.enumDescriptions
- schemas.GceHyperdiskBalancedHighAvailability.properties.reclaimPolicy.type
- schemas.GceHyperdiskBalancedHighAvailability.properties.sizeGb.description
- schemas.GceHyperdiskBalancedHighAvailability.properties.sizeGb.format
- schemas.GceHyperdiskBalancedHighAvailability.properties.sizeGb.type
- schemas.GceHyperdiskBalancedHighAvailability.properties.sourceSnapshot.description
- schemas.GceHyperdiskBalancedHighAvailability.properties.sourceSnapshot.type
- schemas.GceHyperdiskBalancedHighAvailability.type
- schemas.GceInstance.properties.startupScriptUri.description
- schemas.GceInstance.properties.startupScriptUri.type
- schemas.PersistentDirectory.properties.gceHd.$ref
- schemas.PersistentDirectory.properties.gceHd.description

The following keys were changed:
- resources.projects.resources.locations.resources.operations.methods.list.parameters.returnPartialSuccess.description
- schemas.ListOperationsResponse.properties.unreachable.description

Author: yoshi-automation

discovery/workstations-v1.json

@@ -296,7 +296,7 @@
                       "type": "string"
                     },
                     "returnPartialSuccess": {
-                      "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the [ListOperationsResponse.unreachable] field. This can only be `true` when reading across collections e.g. when `parent` is set to `\"projects/example/locations/-\"`. This field is not by default supported and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.",
+                      "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.",
                       "location": "query",
                       "type": "boolean"
                     }
@@ -1221,7 +1221,7 @@
       }
     }
   },
-  "revision": "20251022",
+  "revision": "20251202",
   "rootUrl": "https://workstations.googleapis.com/",
   "schemas": {
     "Accelerator": {
@@ -1479,6 +1479,41 @@
       },
       "type": "object"
     },
+    "GceHyperdiskBalancedHighAvailability": {
+      "description": "A Persistent Directory backed by a Compute Engine [Hyperdisk Balanced High Availability Disk](https://cloud.google.com/compute/docs/disks/hd-types/hyperdisk-balanced-ha). This is a high-availability block storage solution that offers a balance between performance and cost for most general-purpose workloads.",
+      "id": "GceHyperdiskBalancedHighAvailability",
+      "properties": {
+        "archiveTimeout": {
+          "description": "Optional. Number of seconds to wait after initially creating or subsequently shutting down the workstation before converting its disk into a snapshot. This generally saves costs at the expense of greater startup time on next workstation start, as the service will need to create a disk from the archival snapshot. A value of `\"0s\"` indicates that the disk will never be archived.",
+          "format": "google-duration",
+          "type": "string"
+        },
+        "reclaimPolicy": {
+          "description": "Optional. Whether the persistent disk should be deleted when the workstation is deleted. Valid values are `DELETE` and `RETAIN`. Defaults to `DELETE`.",
+          "enum": [
+            "RECLAIM_POLICY_UNSPECIFIED",
+            "DELETE",
+            "RETAIN"
+          ],
+          "enumDescriptions": [
+            "Do not use.",
+            "Delete the persistent disk when deleting the workstation.",
+            "Keep the persistent disk when deleting the workstation. An administrator must manually delete the disk."
+          ],
+          "type": "string"
+        },
+        "sizeGb": {
+          "description": "Optional. The GB capacity of a persistent home directory for each workstation created with this configuration. Must be empty if source_snapshot is set. Valid values are `10`, `50`, `100`, `200`, `500`, or `1000`. Defaults to `200`.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "sourceSnapshot": {
+          "description": "Optional. Name of the snapshot to use as the source for the disk. If set, size_gb must be empty. Must be formatted as ext4 file system with no partitions.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "GceInstance": {
       "description": "A runtime using a Compute Engine instance.",
       "id": "GceInstance",
@@ -1548,6 +1583,10 @@
           "$ref": "GceShieldedInstanceConfig",
           "description": "Optional. A set of Compute Engine Shielded instance options."
         },
+        "startupScriptUri": {
+          "description": "Optional. Link to the startup script stored in Cloud Storage. This script will be run on the host workstation VM when the VM is created. The URI must be of the form gs://{bucket-name}/{object-name}. If specifying a startup script, the service account must have [Permission to access the bucket and script file in Cloud Storage](https://cloud.google.com/storage/docs/access-control/iam-permissions). Otherwise, the script must be publicly accessible. Note that the service regularly updates the OS version used, and it is the responsibility of the user to ensure the script stays compatible with the OS version.",
+          "type": "string"
+        },
         "tags": {
           "description": "Optional. Network tags to add to the Compute Engine VMs backing the workstations. This option applies [network tags](https://cloud.google.com/vpc/docs/add-remove-network-tags) to VMs created with this configuration. These network tags enable the creation of [firewall rules](https://cloud.google.com/workstations/docs/configure-firewall-rules).",
           "items": {
@@ -1756,7 +1795,7 @@
           "type": "array"
         },
         "unreachable": {
-          "description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections e.g. when attempting to list all resources across all supported locations.",
+          "description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections. For example, when attempting to list all resources across all supported locations.",
           "items": {
             "type": "string"
           },
@@ -2007,6 +2046,10 @@
       "description": "A directory to persist across workstation sessions. Updates to this field will not update existing workstations and will only take effect on new workstations.",
       "id": "PersistentDirectory",
       "properties": {
+        "gceHd": {
+          "$ref": "GceHyperdiskBalancedHighAvailability",
+          "description": "A PersistentDirectory backed by a Compute Engine hyperdisk high availability disk."
+        },
         "gcePd": {
           "$ref": "GceRegionalPersistentDisk",
           "description": "A PersistentDirectory backed by a Compute Engine persistent disk."

discovery/workstations-v1beta.json

@@ -222,7 +222,7 @@
                       "type": "string"
                     },
                     "returnPartialSuccess": {
-                      "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the [ListOperationsResponse.unreachable] field. This can only be `true` when reading across collections e.g. when `parent` is set to `\"projects/example/locations/-\"`. This field is not by default supported and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.",
+                      "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.",
                       "location": "query",
                       "type": "boolean"
                     }
@@ -1147,7 +1147,7 @@
       }
     }
   },
-  "revision": "20251022",
+  "revision": "20251202",
   "rootUrl": "https://workstations.googleapis.com/",
   "schemas": {
     "Accelerator": {
@@ -1410,7 +1410,7 @@
       "type": "object"
     },
     "GceHyperdiskBalancedHighAvailability": {
-      "description": "A Persistent Directory backed by a Compute Engine Hyperdisk Balanced High Availability Disk. This is a high-availability block storage solution that offers a balance between performance and cost for most general-purpose workloads.",
+      "description": "A Persistent Directory backed by a Compute Engine [Hyperdisk Balanced High Availability Disk](https://cloud.google.com/compute/docs/disks/hd-types/hyperdisk-balanced-ha). This is a high-availability block storage solution that offers a balance between performance and cost for most general-purpose workloads.",
       "id": "GceHyperdiskBalancedHighAvailability",
       "properties": {
         "archiveTimeout": {
@@ -1483,6 +1483,13 @@
           "description": "Optional. Whether to enable nested virtualization on Cloud Workstations VMs created using this workstation configuration. Defaults to false. Nested virtualization lets you run virtual machine (VM) instances inside your workstation. Before enabling nested virtualization, consider the following important considerations. Cloud Workstations instances are subject to the [same restrictions as Compute Engine instances](https://cloud.google.com/compute/docs/instances/nested-virtualization/overview#restrictions): * **Organization policy**: projects, folders, or organizations may be restricted from creating nested VMs if the **Disable VM nested virtualization** constraint is enforced in the organization policy. For more information, see the Compute Engine section, [Checking whether nested virtualization is allowed](https://cloud.google.com/compute/docs/instances/nested-virtualization/managing-constraint#checking_whether_nested_virtualization_is_allowed). * **Performance**: nested VMs might experience a 10% or greater decrease in performance for workloads that are CPU-bound and possibly greater than a 10% decrease for workloads that are input/output bound. * **Machine Type**: nested virtualization can only be enabled on workstation configurations that specify a machine_type in the N1 or N2 machine series.",
           "type": "boolean"
         },
+        "instanceMetadata": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Optional. Custom metadata to apply to Compute Engine instances.",
+          "type": "object"
+        },
         "machineType": {
           "description": "Optional. The type of machine to use for VM instances—for example, `\"e2-standard-4\"`. For more information about machine types that Cloud Workstations supports, see the list of [available machine types](https://cloud.google.com/workstations/docs/available-machine-types).",
           "type": "string"
@@ -1518,7 +1525,7 @@
           "description": "Optional. A set of Compute Engine Shielded instance options."
         },
         "startupScriptUri": {
-          "description": "Optional. Link to the startup script stored in Cloud Storage. This script will be run on the host workstation VM when the VM is created. The uri must be of the form gs://{bucket-name}/{object-name}. If specifying a startup script, the service account must have [Permission to access the bucket and script file in Cloud Storage](https://cloud.google.com/storage/docs/access-control/iam-permissions). Otherwise, the script must be publicly accessible.",
+          "description": "Optional. Link to the startup script stored in Cloud Storage. This script will be run on the host workstation VM when the VM is created. The URI must be of the form gs://{bucket-name}/{object-name}. If specifying a startup script, the service account must have [Permission to access the bucket and script file in Cloud Storage](https://cloud.google.com/storage/docs/access-control/iam-permissions). Otherwise, the script must be publicly accessible. Note that the service regularly updates the OS version used, and it is the responsibility of the user to ensure the script stays compatible with the OS version.",
           "type": "string"
         },
         "tags": {
@@ -1726,7 +1733,7 @@
           "type": "array"
         },
         "unreachable": {
-          "description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections e.g. when attempting to list all resources across all supported locations.",
+          "description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections. For example, when attempting to list all resources across all supported locations.",
           "items": {
             "type": "string"
           },

src/apis/workstations/v1.ts

@@ -316,6 +316,27 @@ export namespace workstations_v1 {
      */
     enableConfidentialCompute?: boolean | null;
   }
+  /**
+   * A Persistent Directory backed by a Compute Engine [Hyperdisk Balanced High Availability Disk](https://cloud.google.com/compute/docs/disks/hd-types/hyperdisk-balanced-ha). This is a high-availability block storage solution that offers a balance between performance and cost for most general-purpose workloads.
+   */
+  export interface Schema$GceHyperdiskBalancedHighAvailability {
+    /**
+     * Optional. Number of seconds to wait after initially creating or subsequently shutting down the workstation before converting its disk into a snapshot. This generally saves costs at the expense of greater startup time on next workstation start, as the service will need to create a disk from the archival snapshot. A value of `"0s"` indicates that the disk will never be archived.
+     */
+    archiveTimeout?: string | null;
+    /**
+     * Optional. Whether the persistent disk should be deleted when the workstation is deleted. Valid values are `DELETE` and `RETAIN`. Defaults to `DELETE`.
+     */
+    reclaimPolicy?: string | null;
+    /**
+     * Optional. The GB capacity of a persistent home directory for each workstation created with this configuration. Must be empty if source_snapshot is set. Valid values are `10`, `50`, `100`, `200`, `500`, or `1000`. Defaults to `200`.
+     */
+    sizeGb?: number | null;
+    /**
+     * Optional. Name of the snapshot to use as the source for the disk. If set, size_gb must be empty. Must be formatted as ext4 file system with no partitions.
+     */
+    sourceSnapshot?: string | null;
+  }
   /**
    * A runtime using a Compute Engine instance.
    */
@@ -372,6 +393,10 @@ export namespace workstations_v1 {
      * Optional. A set of Compute Engine Shielded instance options.
      */
     shieldedInstanceConfig?: Schema$GceShieldedInstanceConfig;
+    /**
+     * Optional. Link to the startup script stored in Cloud Storage. This script will be run on the host workstation VM when the VM is created. The URI must be of the form gs://{bucket-name\}/{object-name\}. If specifying a startup script, the service account must have [Permission to access the bucket and script file in Cloud Storage](https://cloud.google.com/storage/docs/access-control/iam-permissions). Otherwise, the script must be publicly accessible. Note that the service regularly updates the OS version used, and it is the responsibility of the user to ensure the script stays compatible with the OS version.
+     */
+    startupScriptUri?: string | null;
     /**
      * Optional. Network tags to add to the Compute Engine VMs backing the workstations. This option applies [network tags](https://cloud.google.com/vpc/docs/add-remove-network-tags) to VMs created with this configuration. These network tags enable the creation of [firewall rules](https://cloud.google.com/workstations/docs/configure-firewall-rules).
      */
@@ -530,7 +555,7 @@ export namespace workstations_v1 {
      */
     operations?: Schema$Operation[];
     /**
-     * Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections e.g. when attempting to list all resources across all supported locations.
+     * Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections. For example, when attempting to list all resources across all supported locations.
      */
     unreachable?: string[] | null;
   }
@@ -706,6 +731,10 @@ export namespace workstations_v1 {
    * A directory to persist across workstation sessions. Updates to this field will not update existing workstations and will only take effect on new workstations.
    */
   export interface Schema$PersistentDirectory {
+    /**
+     * A PersistentDirectory backed by a Compute Engine hyperdisk high availability disk.
+     */
+    gceHd?: Schema$GceHyperdiskBalancedHighAvailability;
     /**
      * A PersistentDirectory backed by a Compute Engine persistent disk.
      */
@@ -1925,7 +1954,7 @@ export namespace workstations_v1 {
      *     pageSize: 'placeholder-value',
      *     // The standard list page token.
      *     pageToken: 'placeholder-value',
-     *     // When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the [ListOperationsResponse.unreachable] field. This can only be `true` when reading across collections e.g. when `parent` is set to `"projects/example/locations/-"`. This field is not by default supported and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.
+     *     // When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `"projects/example/locations/-"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.
      *     returnPartialSuccess: 'placeholder-value',
      *   });
      *   console.log(res.data);
@@ -2077,7 +2106,7 @@ export namespace workstations_v1 {
      */
     pageToken?: string;
     /**
-     * When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the [ListOperationsResponse.unreachable] field. This can only be `true` when reading across collections e.g. when `parent` is set to `"projects/example/locations/-"`. This field is not by default supported and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.
+     * When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `"projects/example/locations/-"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.
      */
     returnPartialSuccess?: boolean;
   }