feat(workstations): update the API

yoshi-automation · yoshi-automation · commit a6f8a708bd1a · 2024-10-21T01:36:05.000Z
#### workstations:v1beta

The following keys were added:
- schemas.WorkstationCluster.properties.tags.additionalProperties.type
- schemas.WorkstationCluster.properties.tags.description
- schemas.WorkstationCluster.properties.tags.type

#### workstations:v1

The following keys were added:
- schemas.BoostConfig.description
- schemas.BoostConfig.id
- schemas.BoostConfig.properties.accelerators.description
- schemas.BoostConfig.properties.accelerators.items.$ref
- schemas.BoostConfig.properties.accelerators.type
- schemas.BoostConfig.properties.bootDiskSizeGb.description
- schemas.BoostConfig.properties.bootDiskSizeGb.format
- schemas.BoostConfig.properties.bootDiskSizeGb.type
- schemas.BoostConfig.properties.enableNestedVirtualization.description
- schemas.BoostConfig.properties.enableNestedVirtualization.type
- schemas.BoostConfig.properties.id.description
- schemas.BoostConfig.properties.id.type
- schemas.BoostConfig.properties.machineType.description
- schemas.BoostConfig.properties.machineType.type
- schemas.BoostConfig.properties.poolSize.description
- schemas.BoostConfig.properties.poolSize.format
- schemas.BoostConfig.properties.poolSize.type
- schemas.BoostConfig.type
- schemas.GceInstance.properties.boostConfigs.description
- schemas.GceInstance.properties.boostConfigs.items.$ref
- schemas.GceInstance.properties.boostConfigs.type
- schemas.WorkstationCluster.properties.tags.additionalProperties.type
- schemas.WorkstationCluster.properties.tags.description
- schemas.WorkstationCluster.properties.tags.type
diff --git a/discovery/workstations-v1.json b/discovery/workstations-v1.json
@@ -1195,7 +1195,7 @@
       }
     }
   },
-  "revision": "20240904",
+  "revision": "20241009",
   "rootUrl": "https://workstations.googleapis.com/",
   "schemas": {
     "Accelerator": {
@@ -1284,6 +1284,42 @@
       },
       "type": "object"
     },
+    "BoostConfig": {
+      "description": "A configuration that workstations can boost to.",
+      "id": "BoostConfig",
+      "properties": {
+        "accelerators": {
+          "description": "Optional. A list of the type and count of accelerator cards attached to the boost instance. Defaults to `none`.",
+          "items": {
+            "$ref": "Accelerator"
+          },
+          "type": "array"
+        },
+        "bootDiskSizeGb": {
+          "description": "Optional. The size of the boot disk for the VM in gigabytes (GB). The minimum boot disk size is `30` GB. Defaults to `50` GB.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "enableNestedVirtualization": {
+          "description": "Optional. Whether to enable nested virtualization on boosted Cloud Workstations VMs running using this boost 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 boost configurations that specify a machine_type in the N1 or N2 machine series.",
+          "type": "boolean"
+        },
+        "id": {
+          "description": "Optional. Required. The id to be used for the boost configuration.",
+          "type": "string"
+        },
+        "machineType": {
+          "description": "Optional. The type of machine that boosted VM instances will use—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). Defaults to `e2-standard-4`.",
+          "type": "string"
+        },
+        "poolSize": {
+          "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"
+        }
+      },
+      "type": "object"
+    },
     "CancelOperationRequest": {
       "description": "The request message for Operations.CancelOperation.",
       "id": "CancelOperationRequest",
@@ -1417,6 +1453,13 @@
           },
           "type": "array"
         },
+        "boostConfigs": {
+          "description": "Optional. A list of the boost configurations that workstations created using this workstation configuration are allowed to use.",
+          "items": {
+            "$ref": "BoostConfig"
+          },
+          "type": "array"
+        },
         "bootDiskSizeGb": {
           "description": "Optional. The size of the boot disk for the VM in gigabytes (GB). The minimum boot disk size is `30` GB. Defaults to `50` GB.",
           "format": "int32",
@@ -2286,6 +2329,13 @@
           "description": "Immutable. Name of the Compute Engine subnetwork in which instances associated with this workstation cluster will be created. Must be part of the subnetwork specified for this workstation cluster.",
           "type": "string"
         },
+        "tags": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Optional. Tag keys/values directly bound to this resource. For example: \"123/environment\": \"production\", \"123/costCenter\": \"marketing\"",
+          "type": "object"
+        },
         "uid": {
           "description": "Output only. A system-assigned unique identifier for this workstation cluster.",
           "readOnly": true,
diff --git a/discovery/workstations-v1beta.json b/discovery/workstations-v1beta.json
@@ -1127,7 +1127,7 @@
       }
     }
   },
-  "revision": "20240904",
+  "revision": "20241009",
   "rootUrl": "https://workstations.googleapis.com/",
   "schemas": {
     "Accelerator": {
@@ -2268,6 +2268,13 @@
           "description": "Immutable. Name of the Compute Engine subnetwork in which instances associated with this workstation cluster will be created. Must be part of the subnetwork specified for this workstation cluster.",
           "type": "string"
         },
+        "tags": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Optional. Tag keys/values directly bound to this resource. For example: \"123/environment\": \"production\", \"123/costCenter\": \"marketing\"",
+          "type": "object"
+        },
         "uid": {
           "description": "Output only. A system-assigned unique identifier for this workstation cluster.",
           "readOnly": true,
diff --git a/src/apis/workstations/v1.ts b/src/apis/workstations/v1.ts
@@ -180,6 +180,35 @@ export namespace workstations_v1 {
      */
     role?: string | null;
   }
+  /**
+   * A configuration that workstations can boost to.
+   */
+  export interface Schema$BoostConfig {
+    /**
+     * Optional. A list of the type and count of accelerator cards attached to the boost instance. Defaults to `none`.
+     */
+    accelerators?: Schema$Accelerator[];
+    /**
+     * Optional. The size of the boot disk for the VM in gigabytes (GB). The minimum boot disk size is `30` GB. Defaults to `50` GB.
+     */
+    bootDiskSizeGb?: number | null;
+    /**
+     * Optional. Whether to enable nested virtualization on boosted Cloud Workstations VMs running using this boost 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 boost configurations that specify a machine_type in the N1 or N2 machine series.
+     */
+    enableNestedVirtualization?: boolean | null;
+    /**
+     * Optional. Required. The id to be used for the boost configuration.
+     */
+    id?: string | null;
+    /**
+     * Optional. The type of machine that boosted VM instances will use—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). Defaults to `e2-standard-4`.
+     */
+    machineType?: string | null;
+    /**
+     * 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;
+  }
   /**
    * The request message for Operations.CancelOperation.
    */
@@ -286,6 +315,10 @@ export namespace workstations_v1 {
      * Optional. A list of the type and count of accelerator cards attached to the instance.
      */
     accelerators?: Schema$Accelerator[];
+    /**
+     * Optional. A list of the boost configurations that workstations created using this workstation configuration are allowed to use.
+     */
+    boostConfigs?: Schema$BoostConfig[];
     /**
      * Optional. The size of the boot disk for the VM in gigabytes (GB). The minimum boot disk size is `30` GB. Defaults to `50` GB.
      */
@@ -923,6 +956,10 @@ export namespace workstations_v1 {
      * Immutable. Name of the Compute Engine subnetwork in which instances associated with this workstation cluster will be created. Must be part of the subnetwork specified for this workstation cluster.
      */
     subnetwork?: string | null;
+    /**
+     * Optional. Tag keys/values directly bound to this resource. For example: "123/environment": "production", "123/costCenter": "marketing"
+     */
+    tags?: {[key: string]: string} | null;
     /**
      * Output only. A system-assigned unique identifier for this workstation cluster.
      */
diff --git a/src/apis/workstations/v1beta.ts b/src/apis/workstations/v1beta.ts
@@ -964,6 +964,10 @@ export namespace workstations_v1beta {
      * Immutable. Name of the Compute Engine subnetwork in which instances associated with this workstation cluster will be created. Must be part of the subnetwork specified for this workstation cluster.
      */
     subnetwork?: string | null;
+    /**
+     * Optional. Tag keys/values directly bound to this resource. For example: "123/environment": "production", "123/costCenter": "marketing"
+     */
+    tags?: {[key: string]: string} | null;
     /**
      * Output only. A system-assigned unique identifier for this workstation cluster.
      */
