Skip to content

Commit dd560af

Browse files
feat(workstations): update the API
#### workstations:v1beta The following keys were added: - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.pushCredentials.description - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.pushCredentials.flatPath - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.pushCredentials.httpMethod - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.pushCredentials.id - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.pushCredentials.parameterOrder - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.pushCredentials.parameters.workstation.description - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.pushCredentials.parameters.workstation.location - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.pushCredentials.parameters.workstation.pattern - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.pushCredentials.parameters.workstation.required - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.pushCredentials.parameters.workstation.type - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.pushCredentials.path - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.pushCredentials.request.$ref - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.pushCredentials.response.$ref - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.pushCredentials.scopes - schemas.OAuthToken.description - schemas.OAuthToken.id - schemas.OAuthToken.properties.accessToken.description - schemas.OAuthToken.properties.accessToken.type - schemas.OAuthToken.properties.email.description - schemas.OAuthToken.properties.email.type - schemas.OAuthToken.properties.expireTime.description - schemas.OAuthToken.properties.expireTime.format - schemas.OAuthToken.properties.expireTime.type - schemas.OAuthToken.properties.scopes.description - schemas.OAuthToken.properties.scopes.type - schemas.OAuthToken.type - schemas.PushCredentialsRequest.description - schemas.PushCredentialsRequest.id - schemas.PushCredentialsRequest.properties.applicationDefaultCredentials.$ref - schemas.PushCredentialsRequest.properties.applicationDefaultCredentials.description - schemas.PushCredentialsRequest.type - schemas.WorkstationCluster.properties.workstationAuthorizationUrl.description - schemas.WorkstationCluster.properties.workstationAuthorizationUrl.type - schemas.WorkstationCluster.properties.workstationLaunchUrl.description - schemas.WorkstationCluster.properties.workstationLaunchUrl.type - schemas.WorkstationConfig.properties.enablePushingCredentials.description - schemas.WorkstationConfig.properties.enablePushingCredentials.type The following keys were changed: - resources.projects.resources.locations.resources.workstationClusters.methods.create.parameters.validateOnly.description - resources.projects.resources.locations.resources.workstationClusters.methods.delete.parameters.validateOnly.description - resources.projects.resources.locations.resources.workstationClusters.methods.patch.parameters.validateOnly.description - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.methods.create.parameters.validateOnly.description - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.methods.delete.parameters.validateOnly.description - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.methods.patch.parameters.validateOnly.description - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.create.parameters.validateOnly.description - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.delete.parameters.validateOnly.description - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.patch.parameters.allowMissing.description - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.patch.parameters.updateMask.description - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.patch.parameters.validateOnly.description - schemas.StartWorkstationRequest.properties.validateOnly.description - schemas.StopWorkstationRequest.properties.validateOnly.description #### workstations:v1 The following keys were added: - schemas.GceRegionalPersistentDisk.properties.archiveTimeout.description - schemas.GceRegionalPersistentDisk.properties.archiveTimeout.format - schemas.GceRegionalPersistentDisk.properties.archiveTimeout.type - schemas.WorkstationCluster.properties.workstationAuthorizationUrl.description - schemas.WorkstationCluster.properties.workstationAuthorizationUrl.type - schemas.WorkstationCluster.properties.workstationLaunchUrl.description - schemas.WorkstationCluster.properties.workstationLaunchUrl.type The following keys were changed: - resources.projects.resources.locations.methods.list.description - resources.projects.resources.locations.resources.workstationClusters.methods.create.parameters.validateOnly.description - resources.projects.resources.locations.resources.workstationClusters.methods.delete.parameters.validateOnly.description - resources.projects.resources.locations.resources.workstationClusters.methods.patch.parameters.validateOnly.description - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.methods.create.parameters.validateOnly.description - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.methods.delete.parameters.validateOnly.description - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.methods.patch.parameters.validateOnly.description - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.create.parameters.validateOnly.description - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.delete.parameters.validateOnly.description - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.patch.parameters.allowMissing.description - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.patch.parameters.updateMask.description - resources.projects.resources.locations.resources.workstationClusters.resources.workstationConfigs.resources.workstations.methods.patch.parameters.validateOnly.description - schemas.StartWorkstationRequest.properties.validateOnly.description - schemas.StopWorkstationRequest.properties.validateOnly.description
1 parent 29336d1 commit dd560af

4 files changed

Lines changed: 406 additions & 84 deletions

File tree

discovery/workstations-v1.json

Lines changed: 28 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -135,7 +135,7 @@
135135
]
136136
},
137137
"list": {
138-
"description": "Lists information about the supported locations for this service. This method can be called in two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project-visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include public locations as well as private or other locations specifically visible to the project.",
138+
"description": "Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the [ListLocationsRequest.name] field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.",
139139
"flatPath": "v1/projects/{projectsId}/locations",
140140
"httpMethod": "GET",
141141
"id": "workstations.projects.locations.list",
@@ -330,7 +330,7 @@
330330
"type": "string"
331331
},
332332
"validateOnly": {
333-
"description": "Optional. If set, validate the request and preview the review, but do not actually apply it.",
333+
"description": "Optional. If set, validate the request and preview the result, but do not actually apply it.",
334334
"location": "query",
335335
"type": "boolean"
336336
},
@@ -378,7 +378,7 @@
378378
"type": "string"
379379
},
380380
"validateOnly": {
381-
"description": "Optional. If set, validate the request and preview the review, but do not apply it.",
381+
"description": "Optional. If set, validate the request and preview the result, but do not apply it.",
382382
"location": "query",
383383
"type": "boolean"
384384
}
@@ -485,7 +485,7 @@
485485
"type": "string"
486486
},
487487
"validateOnly": {
488-
"description": "Optional. If set, validate the request and preview the review, but do not actually apply it.",
488+
"description": "Optional. If set, validate the request and preview the result, but do not actually apply it.",
489489
"location": "query",
490490
"type": "boolean"
491491
}
@@ -522,7 +522,7 @@
522522
"type": "string"
523523
},
524524
"validateOnly": {
525-
"description": "Optional. If set, validate the request and preview the review, but do not actually apply it.",
525+
"description": "Optional. If set, validate the request and preview the result, but do not actually apply it.",
526526
"location": "query",
527527
"type": "boolean"
528528
},
@@ -570,7 +570,7 @@
570570
"type": "string"
571571
},
572572
"validateOnly": {
573-
"description": "Optional. If set, validate the request and preview the review, but do not actually apply it.",
573+
"description": "Optional. If set, validate the request and preview the result, but do not actually apply it.",
574574
"location": "query",
575575
"type": "boolean"
576576
}
@@ -744,7 +744,7 @@
744744
"type": "string"
745745
},
746746
"validateOnly": {
747-
"description": "Optional. If set, validate the request and preview the review, but do not actually apply it.",
747+
"description": "Optional. If set, validate the request and preview the result, but do not actually apply it.",
748748
"location": "query",
749749
"type": "boolean"
750750
}
@@ -837,7 +837,7 @@
837837
"type": "string"
838838
},
839839
"validateOnly": {
840-
"description": "Optional. If set, validate the request and preview the review, but do not actually apply it.",
840+
"description": "Optional. If set, validate the request and preview the result, but do not actually apply it.",
841841
"location": "query",
842842
"type": "boolean"
843843
},
@@ -880,7 +880,7 @@
880880
"type": "string"
881881
},
882882
"validateOnly": {
883-
"description": "Optional. If set, validate the request and preview the review, but do not actually apply it.",
883+
"description": "Optional. If set, validate the request and preview the result, but do not actually apply it.",
884884
"location": "query",
885885
"type": "boolean"
886886
}
@@ -1064,7 +1064,7 @@
10641064
],
10651065
"parameters": {
10661066
"allowMissing": {
1067-
"description": "Optional. If set and the workstation configuration is not found, a new workstation configuration is created. In this situation, update_mask is ignored.",
1067+
"description": "Optional. If set and the workstation is not found, a new workstation is created. In this situation, update_mask is ignored.",
10681068
"location": "query",
10691069
"type": "boolean"
10701070
},
@@ -1076,13 +1076,13 @@
10761076
"type": "string"
10771077
},
10781078
"updateMask": {
1079-
"description": "Required. Mask specifying which fields in the workstation configuration should be updated.",
1079+
"description": "Required. Mask specifying which fields in the workstation should be updated.",
10801080
"format": "google-fieldmask",
10811081
"location": "query",
10821082
"type": "string"
10831083
},
10841084
"validateOnly": {
1085-
"description": "Optional. If set, validate the request and preview the review, but do not actually apply it.",
1085+
"description": "Optional. If set, validate the request and preview the result, but do not actually apply it.",
10861086
"location": "query",
10871087
"type": "boolean"
10881088
}
@@ -1221,7 +1221,7 @@
12211221
}
12221222
}
12231223
},
1224-
"revision": "20260126",
1224+
"revision": "20260413",
12251225
"rootUrl": "https://workstations.googleapis.com/",
12261226
"schemas": {
12271227
"Accelerator": {
@@ -1660,6 +1660,11 @@
16601660
"description": "A Persistent Directory backed by a Compute Engine regional persistent disk. The persistent_directories field is repeated, but it may contain only one entry. It creates a [persistent disk](https://cloud.google.com/compute/docs/disks/persistent-disks) that mounts to the workstation VM at `/home` when the session starts and detaches when the session ends. If this field is empty, workstations created with this configuration do not have a persistent home directory.",
16611661
"id": "GceRegionalPersistentDisk",
16621662
"properties": {
1663+
"archiveTimeout": {
1664+
"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.",
1665+
"format": "google-duration",
1666+
"type": "string"
1667+
},
16631668
"diskType": {
16641669
"description": "Optional. The [type of the persistent disk](https://cloud.google.com/compute/docs/disks#disk-types) for the home directory. Defaults to `\"pd-standard\"`.",
16651670
"type": "string"
@@ -2200,7 +2205,7 @@
22002205
"type": "string"
22012206
},
22022207
"validateOnly": {
2203-
"description": "Optional. If set, validate the request and preview the review, but do not actually apply it.",
2208+
"description": "Optional. If set, validate the request and preview the result, but do not actually apply it.",
22042209
"type": "boolean"
22052210
}
22062211
},
@@ -2242,7 +2247,7 @@
22422247
"type": "string"
22432248
},
22442249
"validateOnly": {
2245-
"description": "Optional. If set, validate the request and preview the review, but do not actually apply it.",
2250+
"description": "Optional. If set, validate the request and preview the result, but do not actually apply it.",
22462251
"type": "boolean"
22472252
}
22482253
},
@@ -2490,6 +2495,14 @@
24902495
"format": "google-datetime",
24912496
"readOnly": true,
24922497
"type": "string"
2498+
},
2499+
"workstationAuthorizationUrl": {
2500+
"description": "Optional. Specifies the redirect URL for unauthorized requests received by workstation VMs in this cluster. Redirects to this endpoint will send a base64 encoded `state` query param containing the target workstation name and original request hostname. The endpoint is responsible for retrieving a token using `GenerateAccessToken` and redirecting back to the original hostname with the token.",
2501+
"type": "string"
2502+
},
2503+
"workstationLaunchUrl": {
2504+
"description": "Optional. Specifies the launch URL for workstations in this cluster. Requests sent to unstarted workstations will be redirected to this URL. Requests redirected to the launch endpoint will be sent with a `workstation` and `project` query parameter containing the full workstation resource name and project ID, respectively. The launch endpoint is responsible for starting the workstation, polling it until it reaches `STATE_RUNNING`, and then issuing a redirect to the workstation's host URL.",
2505+
"type": "string"
24932506
}
24942507
},
24952508
"type": "object"

0 commit comments

Comments
 (0)