feat(workstations): update the API

#### workstations:v1beta

The following keys were added:
- resources.projects.resources.locations.resources.workstationClusters.methods.list.parameters.filter.description
- resources.projects.resources.locations.resources.workstationClusters.methods.list.parameters.filter.location
- resources.projects.resources.locations.resources.workstationClusters.methods.list.parameters.filter.type
- resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.methods.list.parameters.filter.description
- resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.methods.list.parameters.filter.location
- resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.methods.list.parameters.filter.type
- resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.list.parameters.filter.description
- resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.list.parameters.filter.location
- resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.list.parameters.filter.type

The following keys were changed:
- schemas.GcePersistentDisk.properties.sourceSnapshot.description
- schemas.GceRegionalPersistentDisk.properties.sourceSnapshot.description
- schemas.Workstation.properties.degraded.description
- schemas.WorkstationCluster.properties.degraded.description
- schemas.WorkstationCluster.properties.tags.description
- schemas.WorkstationConfig.properties.conditions.description
- schemas.WorkstationConfig.properties.degraded.description

#### workstations:v1

The following keys were added:
- resources.projects.resources.locations.methods.list.parameters.extraLocationTypes.description
- resources.projects.resources.locations.methods.list.parameters.extraLocationTypes.location
- resources.projects.resources.locations.methods.list.parameters.extraLocationTypes.repeated
- resources.projects.resources.locations.methods.list.parameters.extraLocationTypes.type
- resources.projects.resources.locations.resources.workstationClusters.methods.list.parameters.filter.description
- resources.projects.resources.locations.resources.workstationClusters.methods.list.parameters.filter.location
- resources.projects.resources.locations.resources.workstationClusters.methods.list.parameters.filter.type
- resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.methods.list.parameters.filter.description
- resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.methods.list.parameters.filter.location
- resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.methods.list.parameters.filter.type
- resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.list.parameters.filter.description
- resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.list.parameters.filter.location
- resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.list.parameters.filter.type

The following keys were changed:
- schemas.GcePersistentDisk.properties.sourceSnapshot.description
- schemas.GceRegionalPersistentDisk.properties.sourceSnapshot.description
- schemas.WorkstationCluster.properties.degraded.description
- schemas.WorkstationCluster.properties.tags.description
- schemas.WorkstationConfig.properties.conditions.description
- schemas.WorkstationConfig.properties.degraded.description

Author: yoshi-automation

discovery/workstations-v1.json

@@ -143,6 +143,12 @@
                 "name"
               ],
               "parameters": {
+                "extraLocationTypes": {
+                  "description": "Optional. A list of extra location types that should be used as conditions for controlling the visibility of the locations.",
+                  "location": "query",
+                  "repeated": true,
+                  "type": "string"
+                },
                 "filter": {
                   "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).",
                   "location": "query",
@@ -414,6 +420,11 @@
                     "parent"
                   ],
                   "parameters": {
+                    "filter": {
+                      "description": "Optional. Filter the WorkstationClusters to be listed. Possible filters are described in https://google.aip.dev/160.",
+                      "location": "query",
+                      "type": "string"
+                    },
                     "pageSize": {
                       "description": "Optional. Maximum number of items to return.",
                       "format": "int32",
@@ -632,6 +643,11 @@
                         "parent"
                       ],
                       "parameters": {
+                        "filter": {
+                          "description": "Optional. Filter the WorkstationConfigs to be listed. Possible filters are described in https://google.aip.dev/160.",
+                          "location": "query",
+                          "type": "string"
+                        },
                         "pageSize": {
                           "description": "Optional. Maximum number of items to return.",
                           "format": "int32",
@@ -965,6 +981,11 @@
                             "parent"
                           ],
                           "parameters": {
+                            "filter": {
+                              "description": "Optional. Filter the Workstations to be listed. Possible filters are described in https://google.aip.dev/160.",
+                              "location": "query",
+                              "type": "string"
+                            },
                             "pageSize": {
                               "description": "Optional. Maximum number of items to return.",
                               "format": "int32",
@@ -1195,7 +1216,7 @@
       }
     }
   },
-  "revision": "20250219",
+  "revision": "20250326",
   "rootUrl": "https://workstations.googleapis.com/",
   "schemas": {
     "Accelerator": {
@@ -1567,7 +1588,7 @@
           "type": "string"
         },
         "sourceSnapshot": {
-          "description": "Optional. Name of the snapshot to use as the source for the disk. Must be empty if source_image is set. Must be empty if read_only is false. Updating source_snapshot will update content in the ephemeral directory after the workstation is restarted. Only file systems supported by Container-Optimized OS (COS) are explicitly supported. For a list of supported file systems, please refer to the [COS documentation](https://cloud.google.com/container-optimized-os/docs/concepts/supported-filesystems). This field is mutable.",
+          "description": "Optional. Name of the snapshot to use as the source for the disk. Must be empty if source_image is set. Must be empty if read_only is false. Updating source_snapshot will update content in the ephemeral directory after the workstation is restarted. Only file systems supported by Container-Optimized OS (COS) are explicitly supported. For a list of supported file systems, see [the filesystems available in Container-Optimized OS](https://cloud.google.com/container-optimized-os/docs/concepts/supported-filesystems). This field is mutable.",
           "type": "string"
         }
       },
@@ -1605,7 +1626,7 @@
           "type": "integer"
         },
         "sourceSnapshot": {
-          "description": "Optional. Name of the snapshot to use as the source for the disk. If set, size_gb and fs_type must be empty.",
+          "description": "Optional. Name of the snapshot to use as the source for the disk. If set, size_gb and fs_type must be empty. Must be formatted as ext4 file system with no partitions.",
           "type": "string"
         }
       },
@@ -2325,7 +2346,7 @@
           "type": "string"
         },
         "degraded": {
-          "description": "Output only. Whether this workstation cluster is in degraded mode, in which case it may require user action to restore full functionality. Details can be found in conditions.",
+          "description": "Output only. Whether this workstation cluster is in degraded mode, in which case it may require user action to restore full functionality. The conditions field contains detailed information about the status of the cluster.",
           "readOnly": true,
           "type": "boolean"
         },
@@ -2379,7 +2400,7 @@
           "additionalProperties": {
             "type": "string"
           },
-          "description": "Optional. Tag keys/values directly bound to this resource. For example: \"123/environment\": \"production\", \"123/costCenter\": \"marketing\"",
+          "description": "Optional. Input only. Immutable. Tag keys/values directly bound to this resource. For example: \"123/environment\": \"production\", \"123/costCenter\": \"marketing\"",
           "type": "object"
         },
         "uid": {
@@ -2415,7 +2436,7 @@
           "type": "object"
         },
         "conditions": {
-          "description": "Output only. Status conditions describing the current resource state.",
+          "description": "Output only. Status conditions describing the workstation configuration's current state.",
           "items": {
             "$ref": "Status"
           },
@@ -2433,7 +2454,7 @@
           "type": "string"
         },
         "degraded": {
-          "description": "Output only. Whether this resource is degraded, in which case it may require user action to restore full functionality. See also the conditions field.",
+          "description": "Output only. Whether this workstation configuration is in degraded mode, in which case it may require user action to restore full functionality. The conditions field contains detailed information about the status of the configuration.",
           "readOnly": true,
           "type": "boolean"
         },

discovery/workstations-v1beta.json

@@ -346,6 +346,11 @@
                     "parent"
                   ],
                   "parameters": {
+                    "filter": {
+                      "description": "Optional. Filter the WorkstationClusters to be listed. Possible filters are described in https://google.aip.dev/160.",
+                      "location": "query",
+                      "type": "string"
+                    },
                     "pageSize": {
                       "description": "Optional. Maximum number of items to return.",
                       "format": "int32",
@@ -564,6 +569,11 @@
                         "parent"
                       ],
                       "parameters": {
+                        "filter": {
+                          "description": "Optional. Filter the WorkstationConfigs to be listed. Possible filters are described in https://google.aip.dev/160.",
+                          "location": "query",
+                          "type": "string"
+                        },
                         "pageSize": {
                           "description": "Optional. Maximum number of items to return.",
                           "format": "int32",
@@ -897,6 +907,11 @@
                             "parent"
                           ],
                           "parameters": {
+                            "filter": {
+                              "description": "Optional. Filter the Workstations to be listed. Possible filters are described in https://google.aip.dev/160.",
+                              "location": "query",
+                              "type": "string"
+                            },
                             "pageSize": {
                               "description": "Optional. Maximum number of items to return.",
                               "format": "int32",
@@ -1127,7 +1142,7 @@
       }
     }
   },
-  "revision": "20250219",
+  "revision": "20250326",
   "rootUrl": "https://workstations.googleapis.com/",
   "schemas": {
     "Accelerator": {
@@ -1499,7 +1514,7 @@
           "type": "string"
         },
         "sourceSnapshot": {
-          "description": "Optional. Name of the snapshot to use as the source for the disk. Must be empty if source_image is set. Must be empty if read_only is false. Updating source_snapshot will update content in the ephemeral directory after the workstation is restarted. Only file systems supported by Container-Optimized OS (COS) are explicitly supported. For a list of supported file systems, please refer to the [COS documentation](https://cloud.google.com/container-optimized-os/docs/concepts/supported-filesystems). This field is mutable.",
+          "description": "Optional. Name of the snapshot to use as the source for the disk. Must be empty if source_image is set. Must be empty if read_only is false. Updating source_snapshot will update content in the ephemeral directory after the workstation is restarted. Only file systems supported by Container-Optimized OS (COS) are explicitly supported. For a list of supported file systems, see [the filesystems available in Container-Optimized OS](https://cloud.google.com/container-optimized-os/docs/concepts/supported-filesystems). This field is mutable.",
           "type": "string"
         }
       },
@@ -1537,7 +1552,7 @@
           "type": "integer"
         },
         "sourceSnapshot": {
-          "description": "Optional. Name of the snapshot to use as the source for the disk. If set, size_gb and fs_type must be empty.",
+          "description": "Optional. Name of the snapshot to use as the source for the disk. If set, size_gb and fs_type must be empty. Must be formatted as ext4 file system with no partitions.",
           "type": "string"
         }
       },
@@ -2111,7 +2126,7 @@
           "type": "string"
         },
         "degraded": {
-          "description": "Output only. Whether this workstation is in degraded mode, in which case it may require user action to restore full functionality. Details can be found in conditions.",
+          "description": "Output only. Whether this workstation is in degraded mode, in which case it may require user action to restore full functionality. The conditions field contains detailed information about the status of the workstation.",
           "readOnly": true,
           "type": "boolean"
         },
@@ -2263,7 +2278,7 @@
           "type": "string"
         },
         "degraded": {
-          "description": "Output only. Whether this workstation cluster is in degraded mode, in which case it may require user action to restore full functionality. Details can be found in conditions.",
+          "description": "Output only. Whether this workstation cluster is in degraded mode, in which case it may require user action to restore full functionality. The conditions field contains detailed information about the status of the cluster.",
           "readOnly": true,
           "type": "boolean"
         },
@@ -2327,7 +2342,7 @@
           "additionalProperties": {
             "type": "string"
           },
-          "description": "Optional. Tag keys/values directly bound to this resource. For example: \"123/environment\": \"production\", \"123/costCenter\": \"marketing\"",
+          "description": "Optional. Input only. Immutable. Tag keys/values directly bound to this resource. For example: \"123/environment\": \"production\", \"123/costCenter\": \"marketing\"",
           "type": "object"
         },
         "uid": {
@@ -2363,7 +2378,7 @@
           "type": "object"
         },
         "conditions": {
-          "description": "Output only. Status conditions describing the current resource state.",
+          "description": "Output only. Status conditions describing the workstation configuration's current state.",
           "items": {
             "$ref": "Status"
           },
@@ -2381,7 +2396,7 @@
           "type": "string"
         },
         "degraded": {
-          "description": "Output only. Whether this resource is degraded, in which case it may require user action to restore full functionality. See also the conditions field.",
+          "description": "Output only. Whether this workstation configuration is in degraded mode, in which case it may require user action to restore full functionality. The conditions field contains detailed information about the status of the configuration.",
           "readOnly": true,
           "type": "boolean"
         },

src/apis/workstations/v1.ts

@@ -406,7 +406,7 @@ export namespace workstations_v1 {
      */
     sourceImage?: string | null;
     /**
-     * Optional. Name of the snapshot to use as the source for the disk. Must be empty if source_image is set. Must be empty if read_only is false. Updating source_snapshot will update content in the ephemeral directory after the workstation is restarted. Only file systems supported by Container-Optimized OS (COS) are explicitly supported. For a list of supported file systems, please refer to the [COS documentation](https://cloud.google.com/container-optimized-os/docs/concepts/supported-filesystems). This field is mutable.
+     * Optional. Name of the snapshot to use as the source for the disk. Must be empty if source_image is set. Must be empty if read_only is false. Updating source_snapshot will update content in the ephemeral directory after the workstation is restarted. Only file systems supported by Container-Optimized OS (COS) are explicitly supported. For a list of supported file systems, see [the filesystems available in Container-Optimized OS](https://cloud.google.com/container-optimized-os/docs/concepts/supported-filesystems). This field is mutable.
      */
     sourceSnapshot?: string | null;
   }
@@ -431,7 +431,7 @@ export namespace workstations_v1 {
      */
     sizeGb?: number | null;
     /**
-     * Optional. Name of the snapshot to use as the source for the disk. If set, size_gb and fs_type must be empty.
+     * Optional. Name of the snapshot to use as the source for the disk. If set, size_gb and fs_type must be empty. Must be formatted as ext4 file system with no partitions.
      */
     sourceSnapshot?: string | null;
   }
@@ -951,7 +951,7 @@ export namespace workstations_v1 {
      */
     createTime?: string | null;
     /**
-     * Output only. Whether this workstation cluster is in degraded mode, in which case it may require user action to restore full functionality. Details can be found in conditions.
+     * Output only. Whether this workstation cluster is in degraded mode, in which case it may require user action to restore full functionality. The conditions field contains detailed information about the status of the cluster.
      */
     degraded?: boolean | null;
     /**
@@ -995,7 +995,7 @@ export namespace workstations_v1 {
      */
     subnetwork?: string | null;
     /**
-     * Optional. Tag keys/values directly bound to this resource. For example: "123/environment": "production", "123/costCenter": "marketing"
+     * Optional. Input only. Immutable. Tag keys/values directly bound to this resource. For example: "123/environment": "production", "123/costCenter": "marketing"
      */
     tags?: {[key: string]: string} | null;
     /**
@@ -1020,7 +1020,7 @@ export namespace workstations_v1 {
      */
     annotations?: {[key: string]: string} | null;
     /**
-     * Output only. Status conditions describing the current resource state.
+     * Output only. Status conditions describing the workstation configuration's current state.
      */
     conditions?: Schema$Status[];
     /**
@@ -1032,7 +1032,7 @@ export namespace workstations_v1 {
      */
     createTime?: string | null;
     /**
-     * Output only. Whether this resource is degraded, in which case it may require user action to restore full functionality. See also the conditions field.
+     * Output only. Whether this workstation configuration is in degraded mode, in which case it may require user action to restore full functionality. The conditions field contains detailed information about the status of the configuration.
      */
     degraded?: boolean | null;
     /**
@@ -1327,6 +1327,10 @@ export namespace workstations_v1 {
   }
   export interface Params$Resource$Projects$Locations$List
     extends StandardParameters {
+    /**
+     * Optional. A list of extra location types that should be used as conditions for controlling the visibility of the locations.
+     */
+    extraLocationTypes?: string[];
     /**
      * A filter to narrow down results to a preferred subset. The filtering language accepts strings like `"displayName=tokyo"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).
      */
@@ -2260,6 +2264,10 @@ export namespace workstations_v1 {
   }
   export interface Params$Resource$Projects$Locations$Workstationclusters$List
     extends StandardParameters {
+    /**
+     * Optional. Filter the WorkstationClusters to be listed. Possible filters are described in https://google.aip.dev/160.
+     */
+    filter?: string;
     /**
      * Optional. Maximum number of items to return.
      */
@@ -3188,6 +3196,10 @@ export namespace workstations_v1 {
   }
   export interface Params$Resource$Projects$Locations$Workstationclusters$Workstationconfigs$List
     extends StandardParameters {
+    /**
+     * Optional. Filter the WorkstationConfigs to be listed. Possible filters are described in https://google.aip.dev/160.
+     */
+    filter?: string;
     /**
      * Optional. Maximum number of items to return.
      */
@@ -4420,6 +4432,10 @@ export namespace workstations_v1 {
   }
   export interface Params$Resource$Projects$Locations$Workstationclusters$Workstationconfigs$Workstations$List
     extends StandardParameters {
+    /**
+     * Optional. Filter the Workstations to be listed. Possible filters are described in https://google.aip.dev/160.
+     */
+    filter?: string;
     /**
      * Optional. Maximum number of items to return.
      */