Skip to content

Commit 2997287

Browse files
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
1 parent a682eea commit 2997287

File tree

4 files changed

+92
-28
lines changed

4 files changed

+92
-28
lines changed

‎discovery/workstations-v1.json

Lines changed: 28 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -143,6 +143,12 @@
143143
"name"
144144
],
145145
"parameters": {
146+
"extraLocationTypes": {
147+
"description": "Optional. A list of extra location types that should be used as conditions for controlling the visibility of the locations.",
148+
"location": "query",
149+
"repeated": true,
150+
"type": "string"
151+
},
146152
"filter": {
147153
"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).",
148154
"location": "query",
@@ -414,6 +420,11 @@
414420
"parent"
415421
],
416422
"parameters": {
423+
"filter": {
424+
"description": "Optional. Filter the WorkstationClusters to be listed. Possible filters are described in https://google.aip.dev/160.",
425+
"location": "query",
426+
"type": "string"
427+
},
417428
"pageSize": {
418429
"description": "Optional. Maximum number of items to return.",
419430
"format": "int32",
@@ -632,6 +643,11 @@
632643
"parent"
633644
],
634645
"parameters": {
646+
"filter": {
647+
"description": "Optional. Filter the WorkstationConfigs to be listed. Possible filters are described in https://google.aip.dev/160.",
648+
"location": "query",
649+
"type": "string"
650+
},
635651
"pageSize": {
636652
"description": "Optional. Maximum number of items to return.",
637653
"format": "int32",
@@ -965,6 +981,11 @@
965981
"parent"
966982
],
967983
"parameters": {
984+
"filter": {
985+
"description": "Optional. Filter the Workstations to be listed. Possible filters are described in https://google.aip.dev/160.",
986+
"location": "query",
987+
"type": "string"
988+
},
968989
"pageSize": {
969990
"description": "Optional. Maximum number of items to return.",
970991
"format": "int32",
@@ -1195,7 +1216,7 @@
11951216
}
11961217
}
11971218
},
1198-
"revision": "20250219",
1219+
"revision": "20250326",
11991220
"rootUrl": "https://workstations.googleapis.com/",
12001221
"schemas": {
12011222
"Accelerator": {
@@ -1567,7 +1588,7 @@
15671588
"type": "string"
15681589
},
15691590
"sourceSnapshot": {
1570-
"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.",
1591+
"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.",
15711592
"type": "string"
15721593
}
15731594
},
@@ -1605,7 +1626,7 @@
16051626
"type": "integer"
16061627
},
16071628
"sourceSnapshot": {
1608-
"description": "Optional. Name of the snapshot to use as the source for the disk. If set, size_gb and fs_type must be empty.",
1629+
"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.",
16091630
"type": "string"
16101631
}
16111632
},
@@ -2325,7 +2346,7 @@
23252346
"type": "string"
23262347
},
23272348
"degraded": {
2328-
"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.",
2349+
"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.",
23292350
"readOnly": true,
23302351
"type": "boolean"
23312352
},
@@ -2379,7 +2400,7 @@
23792400
"additionalProperties": {
23802401
"type": "string"
23812402
},
2382-
"description": "Optional. Tag keys/values directly bound to this resource. For example: \"123/environment\": \"production\", \"123/costCenter\": \"marketing\"",
2403+
"description": "Optional. Input only. Immutable. Tag keys/values directly bound to this resource. For example: \"123/environment\": \"production\", \"123/costCenter\": \"marketing\"",
23832404
"type": "object"
23842405
},
23852406
"uid": {
@@ -2415,7 +2436,7 @@
24152436
"type": "object"
24162437
},
24172438
"conditions": {
2418-
"description": "Output only. Status conditions describing the current resource state.",
2439+
"description": "Output only. Status conditions describing the workstation configuration's current state.",
24192440
"items": {
24202441
"$ref": "Status"
24212442
},
@@ -2433,7 +2454,7 @@
24332454
"type": "string"
24342455
},
24352456
"degraded": {
2436-
"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.",
2457+
"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.",
24372458
"readOnly": true,
24382459
"type": "boolean"
24392460
},

‎discovery/workstations-v1beta.json

Lines changed: 23 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -346,6 +346,11 @@
346346
"parent"
347347
],
348348
"parameters": {
349+
"filter": {
350+
"description": "Optional. Filter the WorkstationClusters to be listed. Possible filters are described in https://google.aip.dev/160.",
351+
"location": "query",
352+
"type": "string"
353+
},
349354
"pageSize": {
350355
"description": "Optional. Maximum number of items to return.",
351356
"format": "int32",
@@ -564,6 +569,11 @@
564569
"parent"
565570
],
566571
"parameters": {
572+
"filter": {
573+
"description": "Optional. Filter the WorkstationConfigs to be listed. Possible filters are described in https://google.aip.dev/160.",
574+
"location": "query",
575+
"type": "string"
576+
},
567577
"pageSize": {
568578
"description": "Optional. Maximum number of items to return.",
569579
"format": "int32",
@@ -897,6 +907,11 @@
897907
"parent"
898908
],
899909
"parameters": {
910+
"filter": {
911+
"description": "Optional. Filter the Workstations to be listed. Possible filters are described in https://google.aip.dev/160.",
912+
"location": "query",
913+
"type": "string"
914+
},
900915
"pageSize": {
901916
"description": "Optional. Maximum number of items to return.",
902917
"format": "int32",
@@ -1127,7 +1142,7 @@
11271142
}
11281143
}
11291144
},
1130-
"revision": "20250219",
1145+
"revision": "20250326",
11311146
"rootUrl": "https://workstations.googleapis.com/",
11321147
"schemas": {
11331148
"Accelerator": {
@@ -1499,7 +1514,7 @@
14991514
"type": "string"
15001515
},
15011516
"sourceSnapshot": {
1502-
"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.",
1517+
"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.",
15031518
"type": "string"
15041519
}
15051520
},
@@ -1537,7 +1552,7 @@
15371552
"type": "integer"
15381553
},
15391554
"sourceSnapshot": {
1540-
"description": "Optional. Name of the snapshot to use as the source for the disk. If set, size_gb and fs_type must be empty.",
1555+
"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.",
15411556
"type": "string"
15421557
}
15431558
},
@@ -2111,7 +2126,7 @@
21112126
"type": "string"
21122127
},
21132128
"degraded": {
2114-
"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.",
2129+
"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.",
21152130
"readOnly": true,
21162131
"type": "boolean"
21172132
},
@@ -2263,7 +2278,7 @@
22632278
"type": "string"
22642279
},
22652280
"degraded": {
2266-
"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.",
2281+
"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.",
22672282
"readOnly": true,
22682283
"type": "boolean"
22692284
},
@@ -2327,7 +2342,7 @@
23272342
"additionalProperties": {
23282343
"type": "string"
23292344
},
2330-
"description": "Optional. Tag keys/values directly bound to this resource. For example: \"123/environment\": \"production\", \"123/costCenter\": \"marketing\"",
2345+
"description": "Optional. Input only. Immutable. Tag keys/values directly bound to this resource. For example: \"123/environment\": \"production\", \"123/costCenter\": \"marketing\"",
23312346
"type": "object"
23322347
},
23332348
"uid": {
@@ -2363,7 +2378,7 @@
23632378
"type": "object"
23642379
},
23652380
"conditions": {
2366-
"description": "Output only. Status conditions describing the current resource state.",
2381+
"description": "Output only. Status conditions describing the workstation configuration's current state.",
23672382
"items": {
23682383
"$ref": "Status"
23692384
},
@@ -2381,7 +2396,7 @@
23812396
"type": "string"
23822397
},
23832398
"degraded": {
2384-
"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.",
2399+
"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.",
23852400
"readOnly": true,
23862401
"type": "boolean"
23872402
},

‎src/apis/workstations/v1.ts

Lines changed: 22 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -406,7 +406,7 @@ export namespace workstations_v1 {
406406
*/
407407
sourceImage?: string | null;
408408
/**
409-
* 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.
409+
* 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.
410410
*/
411411
sourceSnapshot?: string | null;
412412
}
@@ -431,7 +431,7 @@ export namespace workstations_v1 {
431431
*/
432432
sizeGb?: number | null;
433433
/**
434-
* Optional. Name of the snapshot to use as the source for the disk. If set, size_gb and fs_type must be empty.
434+
* 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.
435435
*/
436436
sourceSnapshot?: string | null;
437437
}
@@ -951,7 +951,7 @@ export namespace workstations_v1 {
951951
*/
952952
createTime?: string | null;
953953
/**
954-
* 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.
954+
* 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.
955955
*/
956956
degraded?: boolean | null;
957957
/**
@@ -995,7 +995,7 @@ export namespace workstations_v1 {
995995
*/
996996
subnetwork?: string | null;
997997
/**
998-
* Optional. Tag keys/values directly bound to this resource. For example: "123/environment": "production", "123/costCenter": "marketing"
998+
* Optional. Input only. Immutable. Tag keys/values directly bound to this resource. For example: "123/environment": "production", "123/costCenter": "marketing"
999999
*/
10001000
tags?: {[key: string]: string} | null;
10011001
/**
@@ -1020,7 +1020,7 @@ export namespace workstations_v1 {
10201020
*/
10211021
annotations?: {[key: string]: string} | null;
10221022
/**
1023-
* Output only. Status conditions describing the current resource state.
1023+
* Output only. Status conditions describing the workstation configuration's current state.
10241024
*/
10251025
conditions?: Schema$Status[];
10261026
/**
@@ -1032,7 +1032,7 @@ export namespace workstations_v1 {
10321032
*/
10331033
createTime?: string | null;
10341034
/**
1035-
* Output only. Whether this resource is degraded, in which case it may require user action to restore full functionality. See also the conditions field.
1035+
* 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.
10361036
*/
10371037
degraded?: boolean | null;
10381038
/**
@@ -1327,6 +1327,10 @@ export namespace workstations_v1 {
13271327
}
13281328
export interface Params$Resource$Projects$Locations$List
13291329
extends StandardParameters {
1330+
/**
1331+
* Optional. A list of extra location types that should be used as conditions for controlling the visibility of the locations.
1332+
*/
1333+
extraLocationTypes?: string[];
13301334
/**
13311335
* 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).
13321336
*/
@@ -2260,6 +2264,10 @@ export namespace workstations_v1 {
22602264
}
22612265
export interface Params$Resource$Projects$Locations$Workstationclusters$List
22622266
extends StandardParameters {
2267+
/**
2268+
* Optional. Filter the WorkstationClusters to be listed. Possible filters are described in https://google.aip.dev/160.
2269+
*/
2270+
filter?: string;
22632271
/**
22642272
* Optional. Maximum number of items to return.
22652273
*/
@@ -3188,6 +3196,10 @@ export namespace workstations_v1 {
31883196
}
31893197
export interface Params$Resource$Projects$Locations$Workstationclusters$Workstationconfigs$List
31903198
extends StandardParameters {
3199+
/**
3200+
* Optional. Filter the WorkstationConfigs to be listed. Possible filters are described in https://google.aip.dev/160.
3201+
*/
3202+
filter?: string;
31913203
/**
31923204
* Optional. Maximum number of items to return.
31933205
*/
@@ -4420,6 +4432,10 @@ export namespace workstations_v1 {
44204432
}
44214433
export interface Params$Resource$Projects$Locations$Workstationclusters$Workstationconfigs$Workstations$List
44224434
extends StandardParameters {
4435+
/**
4436+
* Optional. Filter the Workstations to be listed. Possible filters are described in https://google.aip.dev/160.
4437+
*/
4438+
filter?: string;
44234439
/**
44244440
* Optional. Maximum number of items to return.
44254441
*/

0 commit comments

Comments
 (0)