feat(workstations): update the API

#### workstations:v1beta

The following keys were added:
- schemas.BoostConfig.properties.reservationAffinity.$ref
- schemas.BoostConfig.properties.reservationAffinity.description
- schemas.GceInstance.properties.reservationAffinity.$ref
- schemas.GceInstance.properties.reservationAffinity.description
- schemas.ReservationAffinity.description
- schemas.ReservationAffinity.id
- schemas.ReservationAffinity.properties.consumeReservationType.description
- schemas.ReservationAffinity.properties.consumeReservationType.enum
- schemas.ReservationAffinity.properties.consumeReservationType.enumDescriptions
- schemas.ReservationAffinity.properties.consumeReservationType.type
- schemas.ReservationAffinity.properties.key.description
- schemas.ReservationAffinity.properties.key.type
- schemas.ReservationAffinity.properties.values.description
- schemas.ReservationAffinity.properties.values.items.type
- schemas.ReservationAffinity.properties.values.type
- schemas.ReservationAffinity.type

Author: yoshi-automation

discovery/workstations-v1beta.json

@@ -1142,7 +1142,7 @@
       }
     }
   },
-  "revision": "20250604",
+  "revision": "20250625",
   "rootUrl": "https://workstations.googleapis.com/",
   "schemas": {
     "Accelerator": {
@@ -1263,6 +1263,10 @@
           "description": "Optional. The number of boost VMs that the system should keep idle so that workstations can be boosted quickly. Defaults to `0`.",
           "format": "int32",
           "type": "integer"
+        },
+        "reservationAffinity": {
+          "$ref": "ReservationAffinity",
+          "description": "Optional. [ReservationAffinity](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources) specifies a reservation that can be consumed to create boost VM instances. If SPECIFIC_RESERVATION is specified, Cloud Workstations will only create VMs in the zone where the reservation is located. This would affect availability since the service will no longer be resilient to zonal outages. If ANY_RESERVATION is specified, creating reservations in both zones that the config creates VMs in will ensure higher availability. **Important Considerations for Reservation Affinity:** * This feature is intended for advanced users and requires familiarity with Google Compute Engine reservations. * Using reservations incurs charges, regardless of utilization. * The resources in the pool will consume the specified reservation. Take this into account when setting the pool size."
         }
       },
       "type": "object"
@@ -1454,6 +1458,10 @@
           "readOnly": true,
           "type": "integer"
         },
+        "reservationAffinity": {
+          "$ref": "ReservationAffinity",
+          "description": "Optional. [ReservationAffinity](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources) specifies a reservation that can be consumed to create boost VM instances. If SPECIFIC_RESERVATION is specified, Cloud Workstations will only create VMs in the zone where the reservation is located. This would affect availability since the service will no longer be resilient to zonal outages. If ANY_RESERVATION is specified, creating reservations in both zones that the config creates VMs in will ensure higher availability. **Important Considerations for Reservation Affinity:** * This feature is intended for advanced users and requires familiarity with Google Compute Engine reservations. * Using reservations incurs charges, regardless of utilization. * The resources in the pool will consume the specified reservation. Take this into account when setting the pool size."
+        },
         "serviceAccount": {
           "description": "Optional. The email address of the service account for Cloud Workstations VMs created with this configuration. When specified, be sure that the service account has `logging.logEntries.create` and `monitoring.timeSeries.create` permissions on the project so it can write logs out to Cloud Logging. If using a custom container image, the service account must have [Artifact Registry Reader](https://cloud.google.com/artifact-registry/docs/access-control#roles) permission to pull the specified image. If you as the administrator want to be able to `ssh` into the underlying VM, you need to set this value to a service account for which you have the `iam.serviceAccounts.actAs` permission. Conversely, if you don't want anyone to be able to `ssh` into the underlying VM, use a service account where no one has that permission. If not set, VMs run with a service account provided by the Cloud Workstations service, and the image must be publicly accessible.",
           "type": "string"
@@ -1987,6 +1995,40 @@
       },
       "type": "object"
     },
+    "ReservationAffinity": {
+      "description": "ReservationAffinity is the configuration of the desired reservation from which instances can consume resources.",
+      "id": "ReservationAffinity",
+      "properties": {
+        "consumeReservationType": {
+          "description": "Optional. Corresponds to the type of reservation consumption.",
+          "enum": [
+            "TYPE_UNSPECIFIED",
+            "NO_RESERVATION",
+            "ANY_RESERVATION",
+            "SPECIFIC_RESERVATION"
+          ],
+          "enumDescriptions": [
+            "Default value. This should not be used.",
+            "Do not consume from any reserved capacity.",
+            "Consume any reservation available.",
+            "Must consume from a specific reservation. Must specify key value fields for specifying the reservations."
+          ],
+          "type": "string"
+        },
+        "key": {
+          "description": "Optional. Corresponds to the label key of reservation resource.",
+          "type": "string"
+        },
+        "values": {
+          "description": "Optional. Corresponds to the label values of reservation resources. Valid values are either a name to a reservation in the same project or \"projects/{project}/reservations/{reservation}\" to target a shared reservation in the same zone but in a different project.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
     "RuntimeHost": {
       "description": "Runtime host for the workstation.",
       "id": "RuntimeHost",

src/apis/workstations/package.json

@@ -28,7 +28,7 @@
     "webpack": "webpack"
   },
   "dependencies": {
-    "googleapis-common": "^8.0.0"
+    "googleapis-common": "^8.0.2-rc.0"
   },
   "devDependencies": {
     "@microsoft/api-documenter": "^7.8.10",

src/apis/workstations/v1beta.ts

@@ -208,6 +208,10 @@ export namespace workstations_v1beta {
      * Optional. The number of boost VMs that the system should keep idle so that workstations can be boosted quickly. Defaults to `0`.
      */
     poolSize?: number | null;
+    /**
+     * Optional. [ReservationAffinity](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources) specifies a reservation that can be consumed to create boost VM instances. If SPECIFIC_RESERVATION is specified, Cloud Workstations will only create VMs in the zone where the reservation is located. This would affect availability since the service will no longer be resilient to zonal outages. If ANY_RESERVATION is specified, creating reservations in both zones that the config creates VMs in will ensure higher availability. **Important Considerations for Reservation Affinity:** * This feature is intended for advanced users and requires familiarity with Google Compute Engine reservations. * Using reservations incurs charges, regardless of utilization. * The resources in the pool will consume the specified reservation. Take this into account when setting the pool size.
+     */
+    reservationAffinity?: Schema$ReservationAffinity;
   }
   /**
    * The request message for Operations.CancelOperation.
@@ -360,6 +364,10 @@ export namespace workstations_v1beta {
      * Optional. The number of VMs that the system should keep idle so that new workstations can be started quickly for new users. Defaults to `0` in the API.
      */
     poolSize?: number | null;
+    /**
+     * Optional. [ReservationAffinity](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources) specifies a reservation that can be consumed to create boost VM instances. If SPECIFIC_RESERVATION is specified, Cloud Workstations will only create VMs in the zone where the reservation is located. This would affect availability since the service will no longer be resilient to zonal outages. If ANY_RESERVATION is specified, creating reservations in both zones that the config creates VMs in will ensure higher availability. **Important Considerations for Reservation Affinity:** * This feature is intended for advanced users and requires familiarity with Google Compute Engine reservations. * Using reservations incurs charges, regardless of utilization. * The resources in the pool will consume the specified reservation. Take this into account when setting the pool size.
+     */
+    reservationAffinity?: Schema$ReservationAffinity;
     /**
      * Optional. The email address of the service account for Cloud Workstations VMs created with this configuration. When specified, be sure that the service account has `logging.logEntries.create` and `monitoring.timeSeries.create` permissions on the project so it can write logs out to Cloud Logging. If using a custom container image, the service account must have [Artifact Registry Reader](https://cloud.google.com/artifact-registry/docs/access-control#roles) permission to pull the specified image. If you as the administrator want to be able to `ssh` into the underlying VM, you need to set this value to a service account for which you have the `iam.serviceAccounts.actAs` permission. Conversely, if you don't want anyone to be able to `ssh` into the underlying VM, use a service account where no one has that permission. If not set, VMs run with a service account provided by the Cloud Workstations service, and the image must be publicly accessible.
      */
@@ -754,6 +762,23 @@ export namespace workstations_v1beta {
      */
     port?: number | null;
   }
+  /**
+   * ReservationAffinity is the configuration of the desired reservation from which instances can consume resources.
+   */
+  export interface Schema$ReservationAffinity {
+    /**
+     * Optional. Corresponds to the type of reservation consumption.
+     */
+    consumeReservationType?: string | null;
+    /**
+     * Optional. Corresponds to the label key of reservation resource.
+     */
+    key?: string | null;
+    /**
+     * Optional. Corresponds to the label values of reservation resources. Valid values are either a name to a reservation in the same project or "projects/{project\}/reservations/{reservation\}" to target a shared reservation in the same zone but in a different project.
+     */
+    values?: string[] | null;
+  }
   /**
    * Runtime host for the workstation.
    */