Skip to content

Commit f673425

Browse files
feat(workstations): update the API
#### workstations:v1beta 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 #### workstations:v1 The following keys were changed: - resources.projects.resources.locations.methods.list.parameters.extraLocationTypes.description
1 parent 5efd6c0 commit f673425

File tree

4 files changed

+77
-5
lines changed

4 files changed

+77
-5
lines changed

discovery/workstations-v1.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -144,7 +144,7 @@
144144
],
145145
"parameters": {
146146
"extraLocationTypes": {
147-
"description": "Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.",
147+
"description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.",
148148
"location": "query",
149149
"repeated": true,
150150
"type": "string"
@@ -1221,7 +1221,7 @@
12211221
}
12221222
}
12231223
},
1224-
"revision": "20250929",
1224+
"revision": "20251022",
12251225
"rootUrl": "https://workstations.googleapis.com/",
12261226
"schemas": {
12271227
"Accelerator": {

discovery/workstations-v1beta.json

Lines changed: 44 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1147,7 +1147,7 @@
11471147
}
11481148
}
11491149
},
1150-
"revision": "20250929",
1150+
"revision": "20251022",
11511151
"rootUrl": "https://workstations.googleapis.com/",
11521152
"schemas": {
11531153
"Accelerator": {
@@ -1409,6 +1409,41 @@
14091409
},
14101410
"type": "object"
14111411
},
1412+
"GceHyperdiskBalancedHighAvailability": {
1413+
"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.",
1414+
"id": "GceHyperdiskBalancedHighAvailability",
1415+
"properties": {
1416+
"archiveTimeout": {
1417+
"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.",
1418+
"format": "google-duration",
1419+
"type": "string"
1420+
},
1421+
"reclaimPolicy": {
1422+
"description": "Optional. Whether the persistent disk should be deleted when the workstation is deleted. Valid values are `DELETE` and `RETAIN`. Defaults to `DELETE`.",
1423+
"enum": [
1424+
"RECLAIM_POLICY_UNSPECIFIED",
1425+
"DELETE",
1426+
"RETAIN"
1427+
],
1428+
"enumDescriptions": [
1429+
"Do not use.",
1430+
"Delete the persistent disk when deleting the workstation.",
1431+
"Keep the persistent disk when deleting the workstation. An administrator must manually delete the disk."
1432+
],
1433+
"type": "string"
1434+
},
1435+
"sizeGb": {
1436+
"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`.",
1437+
"format": "int32",
1438+
"type": "integer"
1439+
},
1440+
"sourceSnapshot": {
1441+
"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.",
1442+
"type": "string"
1443+
}
1444+
},
1445+
"type": "object"
1446+
},
14121447
"GceInstance": {
14131448
"description": "A runtime using a Compute Engine instance.",
14141449
"id": "GceInstance",
@@ -1482,6 +1517,10 @@
14821517
"$ref": "GceShieldedInstanceConfig",
14831518
"description": "Optional. A set of Compute Engine Shielded instance options."
14841519
},
1520+
"startupScriptUri": {
1521+
"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.",
1522+
"type": "string"
1523+
},
14851524
"tags": {
14861525
"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).",
14871526
"items": {
@@ -1904,6 +1943,10 @@
19041943
"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.",
19051944
"id": "PersistentDirectory",
19061945
"properties": {
1946+
"gceHd": {
1947+
"$ref": "GceHyperdiskBalancedHighAvailability",
1948+
"description": "A PersistentDirectory backed by a Compute Engine hyperdisk high availability disk."
1949+
},
19071950
"gcePd": {
19081951
"$ref": "GceRegionalPersistentDisk",
19091952
"description": "A PersistentDirectory backed by a Compute Engine persistent disk."

src/apis/workstations/v1.ts

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1325,7 +1325,7 @@ export namespace workstations_v1 {
13251325
*
13261326
* // Do the magic
13271327
* const res = await workstations.projects.locations.list({
1328-
* // Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.
1328+
* // Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.
13291329
* extraLocationTypes: 'placeholder-value',
13301330
* // 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).
13311331
* filter: 'placeholder-value',
@@ -1453,7 +1453,7 @@ export namespace workstations_v1 {
14531453
export interface Params$Resource$Projects$Locations$List
14541454
extends StandardParameters {
14551455
/**
1456-
* Optional. Unless explicitly documented otherwise, don't use this unsupported field which is primarily intended for internal usage.
1456+
* Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.
14571457
*/
14581458
extraLocationTypes?: string[];
14591459
/**

src/apis/workstations/v1beta.ts

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -320,6 +320,27 @@ export namespace workstations_v1beta {
320320
*/
321321
enableConfidentialCompute?: boolean | null;
322322
}
323+
/**
324+
* 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.
325+
*/
326+
export interface Schema$GceHyperdiskBalancedHighAvailability {
327+
/**
328+
* 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.
329+
*/
330+
archiveTimeout?: string | null;
331+
/**
332+
* Optional. Whether the persistent disk should be deleted when the workstation is deleted. Valid values are `DELETE` and `RETAIN`. Defaults to `DELETE`.
333+
*/
334+
reclaimPolicy?: string | null;
335+
/**
336+
* 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`.
337+
*/
338+
sizeGb?: number | null;
339+
/**
340+
* 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.
341+
*/
342+
sourceSnapshot?: string | null;
343+
}
323344
/**
324345
* A runtime using a Compute Engine instance.
325346
*/
@@ -380,6 +401,10 @@ export namespace workstations_v1beta {
380401
* Optional. A set of Compute Engine Shielded instance options.
381402
*/
382403
shieldedInstanceConfig?: Schema$GceShieldedInstanceConfig;
404+
/**
405+
* 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.
406+
*/
407+
startupScriptUri?: string | null;
383408
/**
384409
* 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).
385410
*/
@@ -689,6 +714,10 @@ export namespace workstations_v1beta {
689714
* A directory to persist across workstation sessions. Updates to this field will not update existing workstations and will only take effect on new workstations.
690715
*/
691716
export interface Schema$PersistentDirectory {
717+
/**
718+
* A PersistentDirectory backed by a Compute Engine hyperdisk high availability disk.
719+
*/
720+
gceHd?: Schema$GceHyperdiskBalancedHighAvailability;
692721
/**
693722
* A PersistentDirectory backed by a Compute Engine persistent disk.
694723
*/

0 commit comments

Comments
 (0)