@maxim_mazurok/gapi.client.workstations-v1beta 0.2.20260218 → 0.2.20260604

package/index.d.ts

@@ -9,7 +9,7 @@
 // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
 // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
 // Generated from: https://workstations.googleapis.com/$discovery/rest?version=v1beta
-// Revision: 20260218
+// Revision: 20260604
 
 /// <reference types="gapi.client" />
 
@@ -126,6 +126,8 @@ declare namespace gapi.client {
     interface GceHyperdiskBalancedHighAvailability {
       /** 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. */
       archiveTimeout?: string;
+      /** Optional. Maximum size in GB to which this persistent directory can be resized. Defaults to unlimited if not set. */
+      maxSizeGb?: number;
       /** Optional. Whether the persistent disk should be deleted when the workstation is deleted. Valid values are `DELETE` and `RETAIN`. Defaults to `DELETE`. */
       reclaimPolicy?: 'RECLAIM_POLICY_UNSPECIFIED' | 'DELETE' | 'RETAIN';
       /** 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`. */
@@ -196,6 +198,8 @@ declare namespace gapi.client {
       diskType?: string;
       /** Optional. Type of file system that the disk should be formatted with. The workstation image must support this file system type. Must be empty if source_snapshot is set. Defaults to `"ext4"`. */
       fsType?: string;
+      /** Optional. Maximum size in GB to which this persistent directory can be resized. Defaults to unlimited if not set. */
+      maxSizeGb?: number;
       /** Optional. Whether the persistent disk should be deleted when the workstation is deleted. Valid values are `DELETE` and `RETAIN`. Defaults to `DELETE`. */
       reclaimPolicy?: 'RECLAIM_POLICY_UNSPECIFIED' | 'DELETE' | 'RETAIN';
       /** 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`. If less than `200` GB, the disk_type must be `"pd-balanced"` or `"pd-ssd"`. */
@@ -284,6 +288,16 @@ declare namespace gapi.client {
       /** The requested workstations. */
       workstations?: Workstation[];
     }
+    interface OAuthToken {
+      /** Required. The OAuth token. */
+      accessToken?: string;
+      /** Optional. The email address encapsulated in the OAuth token. */
+      email?: string;
+      /** Optional. The time the OAuth access token will expire. This should be the time the access token was generated plus the expires_in offset returned from the Access Token Response. */
+      expireTime?: string;
+      /** Optional. The scopes encapsulated in the OAuth token. See https://developers.google.com/identity/protocols/oauth2/scopes for more information. */
+      scopes?: string;
+    }
     interface Operation {
       /** If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available. */
       done?: boolean;
@@ -346,6 +360,10 @@ declare namespace gapi.client {
       /** Output only. Service attachment URI for the workstation cluster. The service attachment is created when private endpoint is enabled. To access workstations in the workstation cluster, configure access to the managed service using [Private Service Connect](https://cloud.google.com/vpc/docs/configure-private-service-connect-services). */
       serviceAttachmentUri?: string;
     }
+    interface PushCredentialsRequest {
+      /** Optional. Credentials used by Cloud Client Libraries, Google API Client Libraries, and other tooling within the user conainer: https://cloud.google.com/docs/authentication/application-default-credentials */
+      applicationDefaultCredentials?: OAuthToken;
+    }
     interface ReadinessCheck {
       /** Optional. Path to which the request should be sent. */
       path?: string;
@@ -379,21 +397,21 @@ declare namespace gapi.client {
       boostConfig?: string;
       /** Optional. If set, the request will be rejected if the latest version of the workstation on the server does not have this ETag. */
       etag?: string;
-      /** Optional. If set, validate the request and preview the review, but do not actually apply it. */
+      /** Optional. If set, validate the request and preview the result, but do not actually apply it. */
       validateOnly?: boolean;
     }
     interface Status {
       /** The status code, which should be an enum value of google.rpc.Code. */
       code?: number;
       /** A list of messages that carry the error details. There is a common set of message types for APIs to use. */
-      details?: Array<{[P in string]: any}>;
+      details?: {[P in string]: any}[];
       /** A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client. */
       message?: string;
     }
     interface StopWorkstationRequest {
       /** Optional. If set, the request will be rejected if the latest version of the workstation on the server does not have this ETag. */
       etag?: string;
-      /** Optional. If set, validate the request and preview the review, but do not actually apply it. */
+      /** Optional. If set, validate the request and preview the result, but do not actually apply it. */
       validateOnly?: boolean;
     }
     interface TestIamPermissionsRequest {
@@ -431,6 +449,8 @@ declare namespace gapi.client {
       labels?: {[P in string]: string};
       /** Identifier. Full name of this workstation. */
       name?: string;
+      /** Optional. Directories to persist across workstation sessions. */
+      persistentDirectories?: WorkstationPersistentDirectory[];
       /** Output only. Indicates whether this workstation is currently being updated to match its intended state. */
       reconciling?: boolean;
       /** Optional. Output only. Runtime host for the workstation when in STATE_RUNNING. */
@@ -504,6 +524,10 @@ declare namespace gapi.client {
       uid?: string;
       /** Output only. Time when this workstation cluster was most recently updated. */
       updateTime?: string;
+      /** 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. */
+      workstationAuthorizationUrl?: string;
+      /** 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. */
+      workstationLaunchUrl?: string;
     }
     interface WorkstationConfig {
       /** Optional. A list of PortRanges specifying single ports or ranges of ports that are externally accessible in the workstation. Allowed ports must be one of 22, 80, or within range 1024-65535. If not specified defaults to ports 22, 80, and ports 1024-65535. */
@@ -526,6 +550,8 @@ declare namespace gapi.client {
       displayName?: string;
       /** Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](https://cloud.google.com/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type="gce_instance" log_name:"/logs/linux-auditd" */
       enableAuditAgent?: boolean;
+      /** Optional. Enables pushing user provided credentials to Workstations by calling workstations.pushCredentials. If application_default_credentials are supplied to pushCredentials, the provided token is returned when tools and applications running in the user container make a request for Default Application Credentials. Please note that any credentials supplied are made available to all users with access to the workstation. */
+      enablePushingCredentials?: boolean;
       /** Immutable. Encrypts resources of this workstation configuration using a customer-managed encryption key (CMEK). If specified, the boot disk of the Compute Engine instance and the persistent disk are encrypted using this encryption key. If this field is not set, the disks are encrypted using a generated key. Customer-managed encryption keys do not protect disk metadata. If the customer-managed encryption key is rotated, when the workstation instance is stopped, the system attempts to recreate the persistent disk with the new version of the key. Be sure to keep older versions of the key until the persistent disk is recreated. Otherwise, data on the persistent disk might be lost. If the encryption key is revoked, the workstation session automatically stops within 7 hours. Immutable after the workstation configuration is created. */
       encryptionKey?: CustomerEncryptionKey;
       /** Optional. Ephemeral directories which won't persist across workstation sessions. */
@@ -565,6 +591,12 @@ declare namespace gapi.client {
       /** Output only. Time when this workstation configuration was most recently updated. */
       updateTime?: string;
     }
+    interface WorkstationPersistentDirectory {
+      /** Optional. The mount path of the persistent directory. */
+      mountPath?: string;
+      /** Optional. Size of the persistent directory in GB. If specified in an update request, this is the desired size of the directory. */
+      sizeGb?: number;
+    }
     interface OperationsResource {
       /** Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`. */
       cancel(request: {
@@ -741,7 +773,7 @@ declare namespace gapi.client {
         upload_protocol?: string;
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
-        /** Optional. If set, validate the request and preview the review, but do not actually apply it. */
+        /** Optional. If set, validate the request and preview the result, but do not actually apply it. */
         validateOnly?: boolean;
         /** Required. ID to use for the workstation. */
         workstationId?: string;
@@ -774,7 +806,7 @@ declare namespace gapi.client {
           upload_protocol?: string;
           /** Legacy upload protocol for media (e.g. "media", "multipart"). */
           uploadType?: string;
-          /** Optional. If set, validate the request and preview the review, but do not actually apply it. */
+          /** Optional. If set, validate the request and preview the result, but do not actually apply it. */
           validateOnly?: boolean;
           /** Required. ID to use for the workstation. */
           workstationId?: string;
@@ -809,7 +841,7 @@ declare namespace gapi.client {
         upload_protocol?: string;
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
-        /** Optional. If set, validate the request and preview the review, but do not actually apply it. */
+        /** Optional. If set, validate the request and preview the result, but do not actually apply it. */
         validateOnly?: boolean;
       }): Request<Operation>;
       /** Returns a short-lived credential that can be used to send authenticated and authorized traffic to a workstation. Once generated this token cannot be revoked and is good for the lifetime of the token. */
@@ -996,7 +1028,7 @@ declare namespace gapi.client {
         '$.xgafv'?: '1' | '2';
         /** OAuth access token. */
         access_token?: string;
-        /** Optional. If set and the workstation configuration is not found, a new workstation configuration is created. In this situation, update_mask is ignored. */
+        /** Optional. If set and the workstation is not found, a new workstation is created. In this situation, update_mask is ignored. */
         allowMissing?: boolean;
         /** Data format for response. */
         alt?: 'json' | 'media' | 'proto';
@@ -1014,13 +1046,13 @@ declare namespace gapi.client {
         prettyPrint?: boolean;
         /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
         quotaUser?: string;
-        /** Required. Mask specifying which fields in the workstation configuration should be updated. */
+        /** Required. Mask specifying which fields in the workstation should be updated. */
         updateMask?: string;
         /** Upload protocol for media (e.g. "raw", "multipart"). */
         upload_protocol?: string;
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
-        /** Optional. If set, validate the request and preview the review, but do not actually apply it. */
+        /** Optional. If set, validate the request and preview the result, but do not actually apply it. */
         validateOnly?: boolean;
         /** Request body */
         resource: Workstation;
@@ -1031,7 +1063,7 @@ declare namespace gapi.client {
           '$.xgafv'?: '1' | '2';
           /** OAuth access token. */
           access_token?: string;
-          /** Optional. If set and the workstation configuration is not found, a new workstation configuration is created. In this situation, update_mask is ignored. */
+          /** Optional. If set and the workstation is not found, a new workstation is created. In this situation, update_mask is ignored. */
           allowMissing?: boolean;
           /** Data format for response. */
           alt?: 'json' | 'media' | 'proto';
@@ -1049,17 +1081,75 @@ declare namespace gapi.client {
           prettyPrint?: boolean;
           /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
           quotaUser?: string;
-          /** Required. Mask specifying which fields in the workstation configuration should be updated. */
+          /** Required. Mask specifying which fields in the workstation should be updated. */
           updateMask?: string;
           /** Upload protocol for media (e.g. "raw", "multipart"). */
           upload_protocol?: string;
           /** Legacy upload protocol for media (e.g. "media", "multipart"). */
           uploadType?: string;
-          /** Optional. If set, validate the request and preview the review, but do not actually apply it. */
+          /** Optional. If set, validate the request and preview the result, but do not actually apply it. */
           validateOnly?: boolean;
         },
         body: Workstation,
       ): Request<Operation>;
+      /** Pushes credentials to a running workstation on behalf of a user. Once complete, supported credential types (application_default_credentials) are made available to processes running in the user container. */
+      pushCredentials(request: {
+        /** V1 error format. */
+        '$.xgafv'?: '1' | '2';
+        /** OAuth access token. */
+        access_token?: string;
+        /** Data format for response. */
+        alt?: 'json' | 'media' | 'proto';
+        /** JSONP */
+        callback?: string;
+        /** Selector specifying which fields to include in a partial response. */
+        fields?: string;
+        /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+        key?: string;
+        /** OAuth 2.0 token for the current user. */
+        oauth_token?: string;
+        /** Returns response with indentations and line breaks. */
+        prettyPrint?: boolean;
+        /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+        quotaUser?: string;
+        /** Upload protocol for media (e.g. "raw", "multipart"). */
+        upload_protocol?: string;
+        /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+        uploadType?: string;
+        /** Required. Name of the workstation for which the credentials should be pushed. */
+        workstation: string;
+        /** Request body */
+        resource: PushCredentialsRequest;
+      }): Request<Operation>;
+      pushCredentials(
+        request: {
+          /** V1 error format. */
+          '$.xgafv'?: '1' | '2';
+          /** OAuth access token. */
+          access_token?: string;
+          /** Data format for response. */
+          alt?: 'json' | 'media' | 'proto';
+          /** JSONP */
+          callback?: string;
+          /** Selector specifying which fields to include in a partial response. */
+          fields?: string;
+          /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+          key?: string;
+          /** OAuth 2.0 token for the current user. */
+          oauth_token?: string;
+          /** Returns response with indentations and line breaks. */
+          prettyPrint?: boolean;
+          /** Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. */
+          quotaUser?: string;
+          /** Upload protocol for media (e.g. "raw", "multipart"). */
+          upload_protocol?: string;
+          /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+          uploadType?: string;
+          /** Required. Name of the workstation for which the credentials should be pushed. */
+          workstation: string;
+        },
+        body: PushCredentialsRequest,
+      ): Request<Operation>;
       /** Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. */
       setIamPolicy(
         request: {
@@ -1264,7 +1354,7 @@ declare namespace gapi.client {
         upload_protocol?: string;
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
-        /** Optional. If set, validate the request and preview the review, but do not actually apply it. */
+        /** Optional. If set, validate the request and preview the result, but do not actually apply it. */
         validateOnly?: boolean;
         /** Required. ID to use for the workstation configuration. */
         workstationConfigId?: string;
@@ -1297,7 +1387,7 @@ declare namespace gapi.client {
           upload_protocol?: string;
           /** Legacy upload protocol for media (e.g. "media", "multipart"). */
           uploadType?: string;
-          /** Optional. If set, validate the request and preview the review, but do not actually apply it. */
+          /** Optional. If set, validate the request and preview the result, but do not actually apply it. */
           validateOnly?: boolean;
           /** Required. ID to use for the workstation configuration. */
           workstationConfigId?: string;
@@ -1334,7 +1424,7 @@ declare namespace gapi.client {
         upload_protocol?: string;
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
-        /** Optional. If set, validate the request and preview the review, but do not actually apply it. */
+        /** Optional. If set, validate the request and preview the result, but do not actually apply it. */
         validateOnly?: boolean;
       }): Request<Operation>;
       /** Returns the requested workstation configuration. */
@@ -1487,7 +1577,7 @@ declare namespace gapi.client {
         upload_protocol?: string;
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
-        /** Optional. If set, validate the request and preview the review, but do not actually apply it. */
+        /** Optional. If set, validate the request and preview the result, but do not actually apply it. */
         validateOnly?: boolean;
         /** Request body */
         resource: WorkstationConfig;
@@ -1522,7 +1612,7 @@ declare namespace gapi.client {
           upload_protocol?: string;
           /** Legacy upload protocol for media (e.g. "media", "multipart"). */
           uploadType?: string;
-          /** Optional. If set, validate the request and preview the review, but do not actually apply it. */
+          /** Optional. If set, validate the request and preview the result, but do not actually apply it. */
           validateOnly?: boolean;
         },
         body: WorkstationConfig,
@@ -1616,7 +1706,7 @@ declare namespace gapi.client {
         upload_protocol?: string;
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
-        /** Optional. If set, validate the request and preview the review, but do not actually apply it. */
+        /** Optional. If set, validate the request and preview the result, but do not actually apply it. */
         validateOnly?: boolean;
         /** Required. ID to use for the workstation cluster. */
         workstationClusterId?: string;
@@ -1649,7 +1739,7 @@ declare namespace gapi.client {
           upload_protocol?: string;
           /** Legacy upload protocol for media (e.g. "media", "multipart"). */
           uploadType?: string;
-          /** Optional. If set, validate the request and preview the review, but do not actually apply it. */
+          /** Optional. If set, validate the request and preview the result, but do not actually apply it. */
           validateOnly?: boolean;
           /** Required. ID to use for the workstation cluster. */
           workstationClusterId?: string;
@@ -1686,7 +1776,7 @@ declare namespace gapi.client {
         upload_protocol?: string;
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
-        /** Optional. If set, validate the request and preview the review, but do not apply it. */
+        /** Optional. If set, validate the request and preview the result, but do not apply it. */
         validateOnly?: boolean;
       }): Request<Operation>;
       /** Returns the requested workstation cluster. */
@@ -1779,7 +1869,7 @@ declare namespace gapi.client {
         upload_protocol?: string;
         /** Legacy upload protocol for media (e.g. "media", "multipart"). */
         uploadType?: string;
-        /** Optional. If set, validate the request and preview the review, but do not actually apply it. */
+        /** Optional. If set, validate the request and preview the result, but do not actually apply it. */
         validateOnly?: boolean;
         /** Request body */
         resource: WorkstationCluster;
@@ -1814,7 +1904,7 @@ declare namespace gapi.client {
           upload_protocol?: string;
           /** Legacy upload protocol for media (e.g. "media", "multipart"). */
           uploadType?: string;
-          /** Optional. If set, validate the request and preview the review, but do not actually apply it. */
+          /** Optional. If set, validate the request and preview the result, but do not actually apply it. */
           validateOnly?: boolean;
         },
         body: WorkstationCluster,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxim_mazurok/gapi.client.workstations-v1beta",
-  "version": "0.2.20260218",
+  "version": "0.2.20260604",
   "description": "TypeScript typings for Cloud Workstations API v1beta",
   "repository": {
     "type": "git",

package/readme.md

@@ -11,6 +11,23 @@ Install typings for Cloud Workstations API:
 npm install @types/gapi.client.workstations-v1beta --save-dev
 ```
 
+## TypeScript 6.0+
+
+TypeScript 6.0 changed `types` to default to `[]`. You must now explicitly list type packages in `tsconfig.json`:
+
+```json
+{
+  "compilerOptions": {
+    "types": [
+      "gapi",
+      "gapi.auth2",
+      "gapi.client",
+      "gapi.client.workstations-v1beta"
+    ]
+  }
+}
+```
+
 ## Usage
 
 You need to initialize Google API client in your code: