Class WorkstationsClient (0.29.0)

GitHub RepositoryProduct ReferenceREST DocumentationRPC Documentation

Service Description: Service for interacting with Cloud Workstations.

This class provides the ability to make remote calls to the backing service through method calls that map to API methods. Sample code to get started:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   WorkstationClusterName name =
       WorkstationClusterName.of("[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]");
   WorkstationCluster response = workstationsClient.getWorkstationCluster(name);
 }
 

Note: close() needs to be called on the WorkstationsClient object to clean up resources such as threads. In the example above, try-with-resources is used, which automatically calls close().

Methods
MethodDescriptionMethod Variants

GetWorkstationCluster

Returns the requested workstation cluster.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • getWorkstationCluster(GetWorkstationClusterRequest request)

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

  • getWorkstationCluster(WorkstationClusterName name)

  • getWorkstationCluster(String name)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • getWorkstationClusterCallable()

ListWorkstationClusters

Returns all workstation clusters in the specified location.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • listWorkstationClusters(ListWorkstationClustersRequest request)

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

  • listWorkstationClusters(LocationName parent)

  • listWorkstationClusters(String parent)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • listWorkstationClustersPagedCallable()

  • listWorkstationClustersCallable()

CreateWorkstationCluster

Creates a new workstation cluster.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • createWorkstationClusterAsync(CreateWorkstationClusterRequest request)

Methods that return long-running operations have "Async" method variants that return OperationFuture, which is used to track polling of the service.

  • createWorkstationClusterAsync(LocationName parent, WorkstationCluster workstationCluster, String workstationClusterId)

  • createWorkstationClusterAsync(String parent, WorkstationCluster workstationCluster, String workstationClusterId)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • createWorkstationClusterOperationCallable()

  • createWorkstationClusterCallable()

UpdateWorkstationCluster

Updates an existing workstation cluster.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • updateWorkstationClusterAsync(UpdateWorkstationClusterRequest request)

Methods that return long-running operations have "Async" method variants that return OperationFuture, which is used to track polling of the service.

  • updateWorkstationClusterAsync(WorkstationCluster workstationCluster, FieldMask updateMask)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • updateWorkstationClusterOperationCallable()

  • updateWorkstationClusterCallable()

DeleteWorkstationCluster

Deletes the specified workstation cluster.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • deleteWorkstationClusterAsync(DeleteWorkstationClusterRequest request)

Methods that return long-running operations have "Async" method variants that return OperationFuture, which is used to track polling of the service.

  • deleteWorkstationClusterAsync(WorkstationClusterName name)

  • deleteWorkstationClusterAsync(String name)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • deleteWorkstationClusterOperationCallable()

  • deleteWorkstationClusterCallable()

GetWorkstationConfig

Returns the requested workstation configuration.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • getWorkstationConfig(GetWorkstationConfigRequest request)

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

  • getWorkstationConfig(WorkstationConfigName name)

  • getWorkstationConfig(String name)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • getWorkstationConfigCallable()

ListWorkstationConfigs

Returns all workstation configurations in the specified cluster.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • listWorkstationConfigs(ListWorkstationConfigsRequest request)

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

  • listWorkstationConfigs(WorkstationClusterName parent)

  • listWorkstationConfigs(String parent)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • listWorkstationConfigsPagedCallable()

  • listWorkstationConfigsCallable()

ListUsableWorkstationConfigs

Returns all workstation configurations in the specified cluster on which the caller has the "workstations.workstation.create" permission.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • listUsableWorkstationConfigs(ListUsableWorkstationConfigsRequest request)

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

  • listUsableWorkstationConfigs(WorkstationClusterName parent)

  • listUsableWorkstationConfigs(String parent)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • listUsableWorkstationConfigsPagedCallable()

  • listUsableWorkstationConfigsCallable()

CreateWorkstationConfig

Creates a new workstation configuration.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • createWorkstationConfigAsync(CreateWorkstationConfigRequest request)

Methods that return long-running operations have "Async" method variants that return OperationFuture, which is used to track polling of the service.

  • createWorkstationConfigAsync(WorkstationClusterName parent, WorkstationConfig workstationConfig, String workstationConfigId)

  • createWorkstationConfigAsync(String parent, WorkstationConfig workstationConfig, String workstationConfigId)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • createWorkstationConfigOperationCallable()

  • createWorkstationConfigCallable()

UpdateWorkstationConfig

Updates an existing workstation configuration.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • updateWorkstationConfigAsync(UpdateWorkstationConfigRequest request)

Methods that return long-running operations have "Async" method variants that return OperationFuture, which is used to track polling of the service.

  • updateWorkstationConfigAsync(WorkstationConfig workstationConfig, FieldMask updateMask)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • updateWorkstationConfigOperationCallable()

  • updateWorkstationConfigCallable()

DeleteWorkstationConfig

Deletes the specified workstation configuration.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • deleteWorkstationConfigAsync(DeleteWorkstationConfigRequest request)

Methods that return long-running operations have "Async" method variants that return OperationFuture, which is used to track polling of the service.

  • deleteWorkstationConfigAsync(WorkstationConfigName name)

  • deleteWorkstationConfigAsync(String name)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • deleteWorkstationConfigOperationCallable()

  • deleteWorkstationConfigCallable()

GetWorkstation

Returns the requested workstation.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • getWorkstation(GetWorkstationRequest request)

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

  • getWorkstation(WorkstationName name)

  • getWorkstation(String name)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • getWorkstationCallable()

ListWorkstations

Returns all Workstations using the specified workstation configuration.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • listWorkstations(ListWorkstationsRequest request)

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

  • listWorkstations(WorkstationConfigName parent)

  • listWorkstations(String parent)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • listWorkstationsPagedCallable()

  • listWorkstationsCallable()

ListUsableWorkstations

Returns all workstations using the specified workstation configuration on which the caller has the "workstations.workstations.use" permission.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • listUsableWorkstations(ListUsableWorkstationsRequest request)

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

  • listUsableWorkstations(WorkstationConfigName parent)

  • listUsableWorkstations(String parent)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • listUsableWorkstationsPagedCallable()

  • listUsableWorkstationsCallable()

CreateWorkstation

Creates a new workstation.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • createWorkstationAsync(CreateWorkstationRequest request)

Methods that return long-running operations have "Async" method variants that return OperationFuture, which is used to track polling of the service.

  • createWorkstationAsync(WorkstationConfigName parent, Workstation workstation, String workstationId)

  • createWorkstationAsync(String parent, Workstation workstation, String workstationId)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • createWorkstationOperationCallable()

  • createWorkstationCallable()

UpdateWorkstation

Updates an existing workstation.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • updateWorkstationAsync(UpdateWorkstationRequest request)

Methods that return long-running operations have "Async" method variants that return OperationFuture, which is used to track polling of the service.

  • updateWorkstationAsync(Workstation workstation, FieldMask updateMask)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • updateWorkstationOperationCallable()

  • updateWorkstationCallable()

DeleteWorkstation

Deletes the specified workstation.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • deleteWorkstationAsync(DeleteWorkstationRequest request)

Methods that return long-running operations have "Async" method variants that return OperationFuture, which is used to track polling of the service.

  • deleteWorkstationAsync(WorkstationName name)

  • deleteWorkstationAsync(String name)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • deleteWorkstationOperationCallable()

  • deleteWorkstationCallable()

StartWorkstation

Starts running a workstation so that users can connect to it.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • startWorkstationAsync(StartWorkstationRequest request)

Methods that return long-running operations have "Async" method variants that return OperationFuture, which is used to track polling of the service.

  • startWorkstationAsync(WorkstationName name)

  • startWorkstationAsync(String name)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • startWorkstationOperationCallable()

  • startWorkstationCallable()

StopWorkstation

Stops running a workstation, reducing costs.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • stopWorkstationAsync(StopWorkstationRequest request)

Methods that return long-running operations have "Async" method variants that return OperationFuture, which is used to track polling of the service.

  • stopWorkstationAsync(WorkstationName name)

  • stopWorkstationAsync(String name)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • stopWorkstationOperationCallable()

  • stopWorkstationCallable()

GenerateAccessToken

Returns a short-lived credential that can be used to send authenticated and authorized traffic to a workstation.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • generateAccessToken(GenerateAccessTokenRequest request)

"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

  • generateAccessToken(WorkstationName workstation)

  • generateAccessToken(String workstation)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • generateAccessTokenCallable()

SetIamPolicy

Sets the access control policy on the specified resource. Replacesany existing policy.

Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIEDerrors.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • setIamPolicy(SetIamPolicyRequest request)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • setIamPolicyCallable()

GetIamPolicy

Gets the access control policy for a resource. Returns an empty policyif the resource exists and does not have a policy set.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • getIamPolicy(GetIamPolicyRequest request)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • getIamPolicyCallable()

TestIamPermissions

Returns permissions that a caller has on the specified resource. If theresource does not exist, this will return an empty set ofpermissions, not a NOT_FOUND error.

Note: This operation is designed to be used for buildingpermission-aware UIs and command-line tools, not for authorizationchecking. This operation may "fail open" without warning.

Request object method variants only take one parameter, a request object, which must be constructed before the call.

  • testIamPermissions(TestIamPermissionsRequest request)

Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

  • testIamPermissionsCallable()

See the individual methods for example code.

Many parameters require resource names to be formatted in a particular way. To assist with these names, this class includes a format method for each type of name, and additionally a parse method to extract the individual identifiers contained within names that are returned.

This class can be customized by passing in a custom instance of WorkstationsSettings to create(). For example:

To customize credentials:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 WorkstationsSettings workstationsSettings =
     WorkstationsSettings.newBuilder()
         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
         .build();
 WorkstationsClient workstationsClient = WorkstationsClient.create(workstationsSettings);
 

To customize the endpoint:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 WorkstationsSettings workstationsSettings =
     WorkstationsSettings.newBuilder().setEndpoint(myEndpoint).build();
 WorkstationsClient workstationsClient = WorkstationsClient.create(workstationsSettings);
 

To use REST (HTTP1.1/JSON) transport (instead of gRPC) for sending and receiving requests over the wire:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 WorkstationsSettings workstationsSettings = WorkstationsSettings.newHttpJsonBuilder().build();
 WorkstationsClient workstationsClient = WorkstationsClient.create(workstationsSettings);
 

Please refer to the GitHub repository's samples for more quickstart code snippets.

Inheritance

java.lang.Object > WorkstationsClient

Static Methods

create()

public static final WorkstationsClient create()

Constructs an instance of WorkstationsClient with default settings.

Returns
TypeDescription
WorkstationsClient
Exceptions
TypeDescription
IOException

create(WorkstationsSettings settings)

public static final WorkstationsClient create(WorkstationsSettings settings)

Constructs an instance of WorkstationsClient, using the given settings. The channels are created based on the settings passed in, or defaults for any settings that are not set.

Parameter
NameDescription
settingsWorkstationsSettings
Returns
TypeDescription
WorkstationsClient
Exceptions
TypeDescription
IOException

create(WorkstationsStub stub)

public static final WorkstationsClient create(WorkstationsStub stub)

Constructs an instance of WorkstationsClient, using the given stub for making calls. This is for advanced usage - prefer using create(WorkstationsSettings).

Parameter
NameDescription
stubWorkstationsStub
Returns
TypeDescription
WorkstationsClient

Constructors

WorkstationsClient(WorkstationsSettings settings)

protected WorkstationsClient(WorkstationsSettings settings)

Constructs an instance of WorkstationsClient, using the given settings. This is protected so that it is easy to make a subclass, but otherwise, the static factory methods should be preferred.

Parameter
NameDescription
settingsWorkstationsSettings

WorkstationsClient(WorkstationsStub stub)

protected WorkstationsClient(WorkstationsStub stub)
Parameter
NameDescription
stubWorkstationsStub

Methods

awaitTermination(long duration, TimeUnit unit)

public boolean awaitTermination(long duration, TimeUnit unit)
Parameters
NameDescription
durationlong
unitTimeUnit
Returns
TypeDescription
boolean
Exceptions
TypeDescription
InterruptedException

close()

public final void close()

createWorkstationAsync(CreateWorkstationRequest request)

public final OperationFuture<Workstation,OperationMetadata> createWorkstationAsync(CreateWorkstationRequest request)

Creates a new workstation.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   CreateWorkstationRequest request =
       CreateWorkstationRequest.newBuilder()
           .setParent(
               WorkstationConfigName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]")
                   .toString())
           .setWorkstationId("workstationId560540030")
           .setWorkstation(Workstation.newBuilder().build())
           .setValidateOnly(true)
           .build();
   Workstation response = workstationsClient.createWorkstationAsync(request).get();
 }
 
Parameter
NameDescription
requestCreateWorkstationRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
OperationFuture<Workstation,OperationMetadata>

createWorkstationAsync(WorkstationConfigName parent, Workstation workstation, String workstationId)

public final OperationFuture<Workstation,OperationMetadata> createWorkstationAsync(WorkstationConfigName parent, Workstation workstation, String workstationId)

Creates a new workstation.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   WorkstationConfigName parent =
       WorkstationConfigName.of(
           "[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]", "[WORKSTATION_CONFIG]");
   Workstation workstation = Workstation.newBuilder().build();
   String workstationId = "workstationId560540030";
   Workstation response =
       workstationsClient.createWorkstationAsync(parent, workstation, workstationId).get();
 }
 
Parameters
NameDescription
parentWorkstationConfigName

Required. Parent resource name.

workstationWorkstation

Required. Workstation to create.

workstationIdString

Required. ID to use for the workstation.

Returns
TypeDescription
OperationFuture<Workstation,OperationMetadata>

createWorkstationAsync(String parent, Workstation workstation, String workstationId)

public final OperationFuture<Workstation,OperationMetadata> createWorkstationAsync(String parent, Workstation workstation, String workstationId)

Creates a new workstation.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   String parent =
       WorkstationConfigName.of(
               "[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]", "[WORKSTATION_CONFIG]")
           .toString();
   Workstation workstation = Workstation.newBuilder().build();
   String workstationId = "workstationId560540030";
   Workstation response =
       workstationsClient.createWorkstationAsync(parent, workstation, workstationId).get();
 }
 
Parameters
NameDescription
parentString

Required. Parent resource name.

workstationWorkstation

Required. Workstation to create.

workstationIdString

Required. ID to use for the workstation.

Returns
TypeDescription
OperationFuture<Workstation,OperationMetadata>

createWorkstationCallable()

public final UnaryCallable<CreateWorkstationRequest,Operation> createWorkstationCallable()

Creates a new workstation.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   CreateWorkstationRequest request =
       CreateWorkstationRequest.newBuilder()
           .setParent(
               WorkstationConfigName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]")
                   .toString())
           .setWorkstationId("workstationId560540030")
           .setWorkstation(Workstation.newBuilder().build())
           .setValidateOnly(true)
           .build();
   ApiFuture<Operation> future =
       workstationsClient.createWorkstationCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 
Returns
TypeDescription
UnaryCallable<CreateWorkstationRequest,Operation>

createWorkstationClusterAsync(CreateWorkstationClusterRequest request)

public final OperationFuture<WorkstationCluster,OperationMetadata> createWorkstationClusterAsync(CreateWorkstationClusterRequest request)

Creates a new workstation cluster.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   CreateWorkstationClusterRequest request =
       CreateWorkstationClusterRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setWorkstationClusterId("workstationClusterId351421170")
           .setWorkstationCluster(WorkstationCluster.newBuilder().build())
           .setValidateOnly(true)
           .build();
   WorkstationCluster response = workstationsClient.createWorkstationClusterAsync(request).get();
 }
 
Parameter
NameDescription
requestCreateWorkstationClusterRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
OperationFuture<WorkstationCluster,OperationMetadata>

createWorkstationClusterAsync(LocationName parent, WorkstationCluster workstationCluster, String workstationClusterId)

public final OperationFuture<WorkstationCluster,OperationMetadata> createWorkstationClusterAsync(LocationName parent, WorkstationCluster workstationCluster, String workstationClusterId)

Creates a new workstation cluster.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
   WorkstationCluster workstationCluster = WorkstationCluster.newBuilder().build();
   String workstationClusterId = "workstationClusterId351421170";
   WorkstationCluster response =
       workstationsClient
           .createWorkstationClusterAsync(parent, workstationCluster, workstationClusterId)
           .get();
 }
 
Parameters
NameDescription
parentLocationName

Required. Parent resource name.

workstationClusterWorkstationCluster

Required. Workstation cluster to create.

workstationClusterIdString

Required. ID to use for the workstation cluster.

Returns
TypeDescription
OperationFuture<WorkstationCluster,OperationMetadata>

createWorkstationClusterAsync(String parent, WorkstationCluster workstationCluster, String workstationClusterId)

public final OperationFuture<WorkstationCluster,OperationMetadata> createWorkstationClusterAsync(String parent, WorkstationCluster workstationCluster, String workstationClusterId)

Creates a new workstation cluster.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
   WorkstationCluster workstationCluster = WorkstationCluster.newBuilder().build();
   String workstationClusterId = "workstationClusterId351421170";
   WorkstationCluster response =
       workstationsClient
           .createWorkstationClusterAsync(parent, workstationCluster, workstationClusterId)
           .get();
 }
 
Parameters
NameDescription
parentString

Required. Parent resource name.

workstationClusterWorkstationCluster

Required. Workstation cluster to create.

workstationClusterIdString

Required. ID to use for the workstation cluster.

Returns
TypeDescription
OperationFuture<WorkstationCluster,OperationMetadata>

createWorkstationClusterCallable()

public final UnaryCallable<CreateWorkstationClusterRequest,Operation> createWorkstationClusterCallable()

Creates a new workstation cluster.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   CreateWorkstationClusterRequest request =
       CreateWorkstationClusterRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setWorkstationClusterId("workstationClusterId351421170")
           .setWorkstationCluster(WorkstationCluster.newBuilder().build())
           .setValidateOnly(true)
           .build();
   ApiFuture<Operation> future =
       workstationsClient.createWorkstationClusterCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 
Returns
TypeDescription
UnaryCallable<CreateWorkstationClusterRequest,Operation>

createWorkstationClusterOperationCallable()

public final OperationCallable<CreateWorkstationClusterRequest,WorkstationCluster,OperationMetadata> createWorkstationClusterOperationCallable()

Creates a new workstation cluster.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   CreateWorkstationClusterRequest request =
       CreateWorkstationClusterRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setWorkstationClusterId("workstationClusterId351421170")
           .setWorkstationCluster(WorkstationCluster.newBuilder().build())
           .setValidateOnly(true)
           .build();
   OperationFuture<WorkstationCluster, OperationMetadata> future =
       workstationsClient.createWorkstationClusterOperationCallable().futureCall(request);
   // Do something.
   WorkstationCluster response = future.get();
 }
 
Returns
TypeDescription
OperationCallable<CreateWorkstationClusterRequest,WorkstationCluster,OperationMetadata>

createWorkstationConfigAsync(CreateWorkstationConfigRequest request)

public final OperationFuture<WorkstationConfig,OperationMetadata> createWorkstationConfigAsync(CreateWorkstationConfigRequest request)

Creates a new workstation configuration.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   CreateWorkstationConfigRequest request =
       CreateWorkstationConfigRequest.newBuilder()
           .setParent(
               WorkstationClusterName.of("[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]")
                   .toString())
           .setWorkstationConfigId("workstationConfigId798542368")
           .setWorkstationConfig(WorkstationConfig.newBuilder().build())
           .setValidateOnly(true)
           .build();
   WorkstationConfig response = workstationsClient.createWorkstationConfigAsync(request).get();
 }
 
Parameter
NameDescription
requestCreateWorkstationConfigRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
OperationFuture<WorkstationConfig,OperationMetadata>

createWorkstationConfigAsync(WorkstationClusterName parent, WorkstationConfig workstationConfig, String workstationConfigId)

public final OperationFuture<WorkstationConfig,OperationMetadata> createWorkstationConfigAsync(WorkstationClusterName parent, WorkstationConfig workstationConfig, String workstationConfigId)

Creates a new workstation configuration.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   WorkstationClusterName parent =
       WorkstationClusterName.of("[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]");
   WorkstationConfig workstationConfig = WorkstationConfig.newBuilder().build();
   String workstationConfigId = "workstationConfigId798542368";
   WorkstationConfig response =
       workstationsClient
           .createWorkstationConfigAsync(parent, workstationConfig, workstationConfigId)
           .get();
 }
 
Parameters
NameDescription
parentWorkstationClusterName

Required. Parent resource name.

workstationConfigWorkstationConfig

Required. Config to create.

workstationConfigIdString

Required. ID to use for the workstation configuration.

Returns
TypeDescription
OperationFuture<WorkstationConfig,OperationMetadata>

createWorkstationConfigAsync(String parent, WorkstationConfig workstationConfig, String workstationConfigId)

public final OperationFuture<WorkstationConfig,OperationMetadata> createWorkstationConfigAsync(String parent, WorkstationConfig workstationConfig, String workstationConfigId)

Creates a new workstation configuration.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   String parent =
       WorkstationClusterName.of("[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]").toString();
   WorkstationConfig workstationConfig = WorkstationConfig.newBuilder().build();
   String workstationConfigId = "workstationConfigId798542368";
   WorkstationConfig response =
       workstationsClient
           .createWorkstationConfigAsync(parent, workstationConfig, workstationConfigId)
           .get();
 }
 
Parameters
NameDescription
parentString

Required. Parent resource name.

workstationConfigWorkstationConfig

Required. Config to create.

workstationConfigIdString

Required. ID to use for the workstation configuration.

Returns
TypeDescription
OperationFuture<WorkstationConfig,OperationMetadata>

createWorkstationConfigCallable()

public final UnaryCallable<CreateWorkstationConfigRequest,Operation> createWorkstationConfigCallable()

Creates a new workstation configuration.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   CreateWorkstationConfigRequest request =
       CreateWorkstationConfigRequest.newBuilder()
           .setParent(
               WorkstationClusterName.of("[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]")
                   .toString())
           .setWorkstationConfigId("workstationConfigId798542368")
           .setWorkstationConfig(WorkstationConfig.newBuilder().build())
           .setValidateOnly(true)
           .build();
   ApiFuture<Operation> future =
       workstationsClient.createWorkstationConfigCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 
Returns
TypeDescription
UnaryCallable<CreateWorkstationConfigRequest,Operation>

createWorkstationConfigOperationCallable()

public final OperationCallable<CreateWorkstationConfigRequest,WorkstationConfig,OperationMetadata> createWorkstationConfigOperationCallable()

Creates a new workstation configuration.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   CreateWorkstationConfigRequest request =
       CreateWorkstationConfigRequest.newBuilder()
           .setParent(
               WorkstationClusterName.of("[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]")
                   .toString())
           .setWorkstationConfigId("workstationConfigId798542368")
           .setWorkstationConfig(WorkstationConfig.newBuilder().build())
           .setValidateOnly(true)
           .build();
   OperationFuture<WorkstationConfig, OperationMetadata> future =
       workstationsClient.createWorkstationConfigOperationCallable().futureCall(request);
   // Do something.
   WorkstationConfig response = future.get();
 }
 
Returns
TypeDescription
OperationCallable<CreateWorkstationConfigRequest,WorkstationConfig,OperationMetadata>

createWorkstationOperationCallable()

public final OperationCallable<CreateWorkstationRequest,Workstation,OperationMetadata> createWorkstationOperationCallable()

Creates a new workstation.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   CreateWorkstationRequest request =
       CreateWorkstationRequest.newBuilder()
           .setParent(
               WorkstationConfigName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]")
                   .toString())
           .setWorkstationId("workstationId560540030")
           .setWorkstation(Workstation.newBuilder().build())
           .setValidateOnly(true)
           .build();
   OperationFuture<Workstation, OperationMetadata> future =
       workstationsClient.createWorkstationOperationCallable().futureCall(request);
   // Do something.
   Workstation response = future.get();
 }
 
Returns
TypeDescription
OperationCallable<CreateWorkstationRequest,Workstation,OperationMetadata>

deleteWorkstationAsync(DeleteWorkstationRequest request)

public final OperationFuture<Workstation,OperationMetadata> deleteWorkstationAsync(DeleteWorkstationRequest request)

Deletes the specified workstation.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   DeleteWorkstationRequest request =
       DeleteWorkstationRequest.newBuilder()
           .setName(
               WorkstationName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]",
                       "[WORKSTATION]")
                   .toString())
           .setValidateOnly(true)
           .setEtag("etag3123477")
           .build();
   Workstation response = workstationsClient.deleteWorkstationAsync(request).get();
 }
 
Parameter
NameDescription
requestDeleteWorkstationRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
OperationFuture<Workstation,OperationMetadata>

deleteWorkstationAsync(WorkstationName name)

public final OperationFuture<Workstation,OperationMetadata> deleteWorkstationAsync(WorkstationName name)

Deletes the specified workstation.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   WorkstationName name =
       WorkstationName.of(
           "[PROJECT]",
           "[LOCATION]",
           "[WORKSTATION_CLUSTER]",
           "[WORKSTATION_CONFIG]",
           "[WORKSTATION]");
   Workstation response = workstationsClient.deleteWorkstationAsync(name).get();
 }
 
Parameter
NameDescription
nameWorkstationName

Required. Name of the workstation to delete.

Returns
TypeDescription
OperationFuture<Workstation,OperationMetadata>

deleteWorkstationAsync(String name)

public final OperationFuture<Workstation,OperationMetadata> deleteWorkstationAsync(String name)

Deletes the specified workstation.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   String name =
       WorkstationName.of(
               "[PROJECT]",
               "[LOCATION]",
               "[WORKSTATION_CLUSTER]",
               "[WORKSTATION_CONFIG]",
               "[WORKSTATION]")
           .toString();
   Workstation response = workstationsClient.deleteWorkstationAsync(name).get();
 }
 
Parameter
NameDescription
nameString

Required. Name of the workstation to delete.

Returns
TypeDescription
OperationFuture<Workstation,OperationMetadata>

deleteWorkstationCallable()

public final UnaryCallable<DeleteWorkstationRequest,Operation> deleteWorkstationCallable()

Deletes the specified workstation.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   DeleteWorkstationRequest request =
       DeleteWorkstationRequest.newBuilder()
           .setName(
               WorkstationName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]",
                       "[WORKSTATION]")
                   .toString())
           .setValidateOnly(true)
           .setEtag("etag3123477")
           .build();
   ApiFuture<Operation> future =
       workstationsClient.deleteWorkstationCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 
Returns
TypeDescription
UnaryCallable<DeleteWorkstationRequest,Operation>

deleteWorkstationClusterAsync(DeleteWorkstationClusterRequest request)

public final OperationFuture<WorkstationCluster,OperationMetadata> deleteWorkstationClusterAsync(DeleteWorkstationClusterRequest request)

Deletes the specified workstation cluster.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   DeleteWorkstationClusterRequest request =
       DeleteWorkstationClusterRequest.newBuilder()
           .setName(
               WorkstationClusterName.of("[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]")
                   .toString())
           .setValidateOnly(true)
           .setEtag("etag3123477")
           .setForce(true)
           .build();
   WorkstationCluster response = workstationsClient.deleteWorkstationClusterAsync(request).get();
 }
 
Parameter
NameDescription
requestDeleteWorkstationClusterRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
OperationFuture<WorkstationCluster,OperationMetadata>

deleteWorkstationClusterAsync(WorkstationClusterName name)

public final OperationFuture<WorkstationCluster,OperationMetadata> deleteWorkstationClusterAsync(WorkstationClusterName name)

Deletes the specified workstation cluster.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   WorkstationClusterName name =
       WorkstationClusterName.of("[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]");
   WorkstationCluster response = workstationsClient.deleteWorkstationClusterAsync(name).get();
 }
 
Parameter
NameDescription
nameWorkstationClusterName

Required. Name of the workstation cluster to delete.

Returns
TypeDescription
OperationFuture<WorkstationCluster,OperationMetadata>

deleteWorkstationClusterAsync(String name)

public final OperationFuture<WorkstationCluster,OperationMetadata> deleteWorkstationClusterAsync(String name)

Deletes the specified workstation cluster.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   String name =
       WorkstationClusterName.of("[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]").toString();
   WorkstationCluster response = workstationsClient.deleteWorkstationClusterAsync(name).get();
 }
 
Parameter
NameDescription
nameString

Required. Name of the workstation cluster to delete.

Returns
TypeDescription
OperationFuture<WorkstationCluster,OperationMetadata>

deleteWorkstationClusterCallable()

public final UnaryCallable<DeleteWorkstationClusterRequest,Operation> deleteWorkstationClusterCallable()

Deletes the specified workstation cluster.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   DeleteWorkstationClusterRequest request =
       DeleteWorkstationClusterRequest.newBuilder()
           .setName(
               WorkstationClusterName.of("[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]")
                   .toString())
           .setValidateOnly(true)
           .setEtag("etag3123477")
           .setForce(true)
           .build();
   ApiFuture<Operation> future =
       workstationsClient.deleteWorkstationClusterCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 
Returns
TypeDescription
UnaryCallable<DeleteWorkstationClusterRequest,Operation>

deleteWorkstationClusterOperationCallable()

public final OperationCallable<DeleteWorkstationClusterRequest,WorkstationCluster,OperationMetadata> deleteWorkstationClusterOperationCallable()

Deletes the specified workstation cluster.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   DeleteWorkstationClusterRequest request =
       DeleteWorkstationClusterRequest.newBuilder()
           .setName(
               WorkstationClusterName.of("[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]")
                   .toString())
           .setValidateOnly(true)
           .setEtag("etag3123477")
           .setForce(true)
           .build();
   OperationFuture<WorkstationCluster, OperationMetadata> future =
       workstationsClient.deleteWorkstationClusterOperationCallable().futureCall(request);
   // Do something.
   WorkstationCluster response = future.get();
 }
 
Returns
TypeDescription
OperationCallable<DeleteWorkstationClusterRequest,WorkstationCluster,OperationMetadata>

deleteWorkstationConfigAsync(DeleteWorkstationConfigRequest request)

public final OperationFuture<WorkstationConfig,OperationMetadata> deleteWorkstationConfigAsync(DeleteWorkstationConfigRequest request)

Deletes the specified workstation configuration.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   DeleteWorkstationConfigRequest request =
       DeleteWorkstationConfigRequest.newBuilder()
           .setName(
               WorkstationConfigName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]")
                   .toString())
           .setValidateOnly(true)
           .setEtag("etag3123477")
           .setForce(true)
           .build();
   WorkstationConfig response = workstationsClient.deleteWorkstationConfigAsync(request).get();
 }
 
Parameter
NameDescription
requestDeleteWorkstationConfigRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
OperationFuture<WorkstationConfig,OperationMetadata>

deleteWorkstationConfigAsync(WorkstationConfigName name)

public final OperationFuture<WorkstationConfig,OperationMetadata> deleteWorkstationConfigAsync(WorkstationConfigName name)

Deletes the specified workstation configuration.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   WorkstationConfigName name =
       WorkstationConfigName.of(
           "[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]", "[WORKSTATION_CONFIG]");
   WorkstationConfig response = workstationsClient.deleteWorkstationConfigAsync(name).get();
 }
 
Parameter
NameDescription
nameWorkstationConfigName

Required. Name of the workstation configuration to delete.

Returns
TypeDescription
OperationFuture<WorkstationConfig,OperationMetadata>

deleteWorkstationConfigAsync(String name)

public final OperationFuture<WorkstationConfig,OperationMetadata> deleteWorkstationConfigAsync(String name)

Deletes the specified workstation configuration.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   String name =
       WorkstationConfigName.of(
               "[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]", "[WORKSTATION_CONFIG]")
           .toString();
   WorkstationConfig response = workstationsClient.deleteWorkstationConfigAsync(name).get();
 }
 
Parameter
NameDescription
nameString

Required. Name of the workstation configuration to delete.

Returns
TypeDescription
OperationFuture<WorkstationConfig,OperationMetadata>

deleteWorkstationConfigCallable()

public final UnaryCallable<DeleteWorkstationConfigRequest,Operation> deleteWorkstationConfigCallable()

Deletes the specified workstation configuration.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   DeleteWorkstationConfigRequest request =
       DeleteWorkstationConfigRequest.newBuilder()
           .setName(
               WorkstationConfigName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]")
                   .toString())
           .setValidateOnly(true)
           .setEtag("etag3123477")
           .setForce(true)
           .build();
   ApiFuture<Operation> future =
       workstationsClient.deleteWorkstationConfigCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 
Returns
TypeDescription
UnaryCallable<DeleteWorkstationConfigRequest,Operation>

deleteWorkstationConfigOperationCallable()

public final OperationCallable<DeleteWorkstationConfigRequest,WorkstationConfig,OperationMetadata> deleteWorkstationConfigOperationCallable()

Deletes the specified workstation configuration.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   DeleteWorkstationConfigRequest request =
       DeleteWorkstationConfigRequest.newBuilder()
           .setName(
               WorkstationConfigName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]")
                   .toString())
           .setValidateOnly(true)
           .setEtag("etag3123477")
           .setForce(true)
           .build();
   OperationFuture<WorkstationConfig, OperationMetadata> future =
       workstationsClient.deleteWorkstationConfigOperationCallable().futureCall(request);
   // Do something.
   WorkstationConfig response = future.get();
 }
 
Returns
TypeDescription
OperationCallable<DeleteWorkstationConfigRequest,WorkstationConfig,OperationMetadata>

deleteWorkstationOperationCallable()

public final OperationCallable<DeleteWorkstationRequest,Workstation,OperationMetadata> deleteWorkstationOperationCallable()

Deletes the specified workstation.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   DeleteWorkstationRequest request =
       DeleteWorkstationRequest.newBuilder()
           .setName(
               WorkstationName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]",
                       "[WORKSTATION]")
                   .toString())
           .setValidateOnly(true)
           .setEtag("etag3123477")
           .build();
   OperationFuture<Workstation, OperationMetadata> future =
       workstationsClient.deleteWorkstationOperationCallable().futureCall(request);
   // Do something.
   Workstation response = future.get();
 }
 
Returns
TypeDescription
OperationCallable<DeleteWorkstationRequest,Workstation,OperationMetadata>

generateAccessToken(GenerateAccessTokenRequest request)

public final GenerateAccessTokenResponse generateAccessToken(GenerateAccessTokenRequest request)

Returns a short-lived credential that can be used to send authenticated and authorized traffic to a workstation.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   GenerateAccessTokenRequest request =
       GenerateAccessTokenRequest.newBuilder()
           .setWorkstation(
               WorkstationName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]",
                       "[WORKSTATION]")
                   .toString())
           .build();
   GenerateAccessTokenResponse response = workstationsClient.generateAccessToken(request);
 }
 
Parameter
NameDescription
requestGenerateAccessTokenRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
GenerateAccessTokenResponse

generateAccessToken(WorkstationName workstation)

public final GenerateAccessTokenResponse generateAccessToken(WorkstationName workstation)

Returns a short-lived credential that can be used to send authenticated and authorized traffic to a workstation.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   WorkstationName workstation =
       WorkstationName.of(
           "[PROJECT]",
           "[LOCATION]",
           "[WORKSTATION_CLUSTER]",
           "[WORKSTATION_CONFIG]",
           "[WORKSTATION]");
   GenerateAccessTokenResponse response = workstationsClient.generateAccessToken(workstation);
 }
 
Parameter
NameDescription
workstationWorkstationName

Required. Name of the workstation for which the access token should be generated.

Returns
TypeDescription
GenerateAccessTokenResponse

generateAccessToken(String workstation)

public final GenerateAccessTokenResponse generateAccessToken(String workstation)

Returns a short-lived credential that can be used to send authenticated and authorized traffic to a workstation.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   String workstation =
       WorkstationName.of(
               "[PROJECT]",
               "[LOCATION]",
               "[WORKSTATION_CLUSTER]",
               "[WORKSTATION_CONFIG]",
               "[WORKSTATION]")
           .toString();
   GenerateAccessTokenResponse response = workstationsClient.generateAccessToken(workstation);
 }
 
Parameter
NameDescription
workstationString

Required. Name of the workstation for which the access token should be generated.

Returns
TypeDescription
GenerateAccessTokenResponse

generateAccessTokenCallable()

public final UnaryCallable<GenerateAccessTokenRequest,GenerateAccessTokenResponse> generateAccessTokenCallable()

Returns a short-lived credential that can be used to send authenticated and authorized traffic to a workstation.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   GenerateAccessTokenRequest request =
       GenerateAccessTokenRequest.newBuilder()
           .setWorkstation(
               WorkstationName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]",
                       "[WORKSTATION]")
                   .toString())
           .build();
   ApiFuture<GenerateAccessTokenResponse> future =
       workstationsClient.generateAccessTokenCallable().futureCall(request);
   // Do something.
   GenerateAccessTokenResponse response = future.get();
 }
 
Returns
TypeDescription
UnaryCallable<GenerateAccessTokenRequest,GenerateAccessTokenResponse>

getHttpJsonOperationsClient()

public final OperationsClient getHttpJsonOperationsClient()

Returns the OperationsClient that can be used to query the status of a long-running operation returned by another API method call.

Returns
TypeDescription
OperationsClient

getIamPolicy(GetIamPolicyRequest request)

public final Policy getIamPolicy(GetIamPolicyRequest request)

Gets the access control policy for a resource. Returns an empty policyif the resource exists and does not have a policy set.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   GetIamPolicyRequest request =
       GetIamPolicyRequest.newBuilder()
           .setResource(
               WorkstationName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]",
                       "[WORKSTATION]")
                   .toString())
           .setOptions(GetPolicyOptions.newBuilder().build())
           .build();
   Policy response = workstationsClient.getIamPolicy(request);
 }
 
Parameter
NameDescription
requestcom.google.iam.v1.GetIamPolicyRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
com.google.iam.v1.Policy

getIamPolicyCallable()

public final UnaryCallable<GetIamPolicyRequest,Policy> getIamPolicyCallable()

Gets the access control policy for a resource. Returns an empty policyif the resource exists and does not have a policy set.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   GetIamPolicyRequest request =
       GetIamPolicyRequest.newBuilder()
           .setResource(
               WorkstationName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]",
                       "[WORKSTATION]")
                   .toString())
           .setOptions(GetPolicyOptions.newBuilder().build())
           .build();
   ApiFuture<Policy> future = workstationsClient.getIamPolicyCallable().futureCall(request);
   // Do something.
   Policy response = future.get();
 }
 
Returns
TypeDescription
UnaryCallable<com.google.iam.v1.GetIamPolicyRequest,com.google.iam.v1.Policy>

getOperationsClient()

public final OperationsClient getOperationsClient()

Returns the OperationsClient that can be used to query the status of a long-running operation returned by another API method call.

Returns
TypeDescription
OperationsClient

getSettings()

public final WorkstationsSettings getSettings()
Returns
TypeDescription
WorkstationsSettings

getStub()

public WorkstationsStub getStub()
Returns
TypeDescription
WorkstationsStub

getWorkstation(GetWorkstationRequest request)

public final Workstation getWorkstation(GetWorkstationRequest request)

Returns the requested workstation.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   GetWorkstationRequest request =
       GetWorkstationRequest.newBuilder()
           .setName(
               WorkstationName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]",
                       "[WORKSTATION]")
                   .toString())
           .build();
   Workstation response = workstationsClient.getWorkstation(request);
 }
 
Parameter
NameDescription
requestGetWorkstationRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
Workstation

getWorkstation(WorkstationName name)

public final Workstation getWorkstation(WorkstationName name)

Returns the requested workstation.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   WorkstationName name =
       WorkstationName.of(
           "[PROJECT]",
           "[LOCATION]",
           "[WORKSTATION_CLUSTER]",
           "[WORKSTATION_CONFIG]",
           "[WORKSTATION]");
   Workstation response = workstationsClient.getWorkstation(name);
 }
 
Parameter
NameDescription
nameWorkstationName

Required. Name of the requested resource.

Returns
TypeDescription
Workstation

getWorkstation(String name)

public final Workstation getWorkstation(String name)

Returns the requested workstation.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   String name =
       WorkstationName.of(
               "[PROJECT]",
               "[LOCATION]",
               "[WORKSTATION_CLUSTER]",
               "[WORKSTATION_CONFIG]",
               "[WORKSTATION]")
           .toString();
   Workstation response = workstationsClient.getWorkstation(name);
 }
 
Parameter
NameDescription
nameString

Required. Name of the requested resource.

Returns
TypeDescription
Workstation

getWorkstationCallable()

public final UnaryCallable<GetWorkstationRequest,Workstation> getWorkstationCallable()

Returns the requested workstation.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   GetWorkstationRequest request =
       GetWorkstationRequest.newBuilder()
           .setName(
               WorkstationName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]",
                       "[WORKSTATION]")
                   .toString())
           .build();
   ApiFuture<Workstation> future =
       workstationsClient.getWorkstationCallable().futureCall(request);
   // Do something.
   Workstation response = future.get();
 }
 
Returns
TypeDescription
UnaryCallable<GetWorkstationRequest,Workstation>

getWorkstationCluster(GetWorkstationClusterRequest request)

public final WorkstationCluster getWorkstationCluster(GetWorkstationClusterRequest request)

Returns the requested workstation cluster.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   GetWorkstationClusterRequest request =
       GetWorkstationClusterRequest.newBuilder()
           .setName(
               WorkstationClusterName.of("[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]")
                   .toString())
           .build();
   WorkstationCluster response = workstationsClient.getWorkstationCluster(request);
 }
 
Parameter
NameDescription
requestGetWorkstationClusterRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
WorkstationCluster

getWorkstationCluster(WorkstationClusterName name)

public final WorkstationCluster getWorkstationCluster(WorkstationClusterName name)

Returns the requested workstation cluster.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   WorkstationClusterName name =
       WorkstationClusterName.of("[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]");
   WorkstationCluster response = workstationsClient.getWorkstationCluster(name);
 }
 
Parameter
NameDescription
nameWorkstationClusterName

Required. Name of the requested resource.

Returns
TypeDescription
WorkstationCluster

getWorkstationCluster(String name)

public final WorkstationCluster getWorkstationCluster(String name)

Returns the requested workstation cluster.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   String name =
       WorkstationClusterName.of("[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]").toString();
   WorkstationCluster response = workstationsClient.getWorkstationCluster(name);
 }
 
Parameter
NameDescription
nameString

Required. Name of the requested resource.

Returns
TypeDescription
WorkstationCluster

getWorkstationClusterCallable()

public final UnaryCallable<GetWorkstationClusterRequest,WorkstationCluster> getWorkstationClusterCallable()

Returns the requested workstation cluster.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   GetWorkstationClusterRequest request =
       GetWorkstationClusterRequest.newBuilder()
           .setName(
               WorkstationClusterName.of("[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]")
                   .toString())
           .build();
   ApiFuture<WorkstationCluster> future =
       workstationsClient.getWorkstationClusterCallable().futureCall(request);
   // Do something.
   WorkstationCluster response = future.get();
 }
 
Returns
TypeDescription
UnaryCallable<GetWorkstationClusterRequest,WorkstationCluster>

getWorkstationConfig(GetWorkstationConfigRequest request)

public final WorkstationConfig getWorkstationConfig(GetWorkstationConfigRequest request)

Returns the requested workstation configuration.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   GetWorkstationConfigRequest request =
       GetWorkstationConfigRequest.newBuilder()
           .setName(
               WorkstationConfigName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]")
                   .toString())
           .build();
   WorkstationConfig response = workstationsClient.getWorkstationConfig(request);
 }
 
Parameter
NameDescription
requestGetWorkstationConfigRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
WorkstationConfig

getWorkstationConfig(WorkstationConfigName name)

public final WorkstationConfig getWorkstationConfig(WorkstationConfigName name)

Returns the requested workstation configuration.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   WorkstationConfigName name =
       WorkstationConfigName.of(
           "[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]", "[WORKSTATION_CONFIG]");
   WorkstationConfig response = workstationsClient.getWorkstationConfig(name);
 }
 
Parameter
NameDescription
nameWorkstationConfigName

Required. Name of the requested resource.

Returns
TypeDescription
WorkstationConfig

getWorkstationConfig(String name)

public final WorkstationConfig getWorkstationConfig(String name)

Returns the requested workstation configuration.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   String name =
       WorkstationConfigName.of(
               "[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]", "[WORKSTATION_CONFIG]")
           .toString();
   WorkstationConfig response = workstationsClient.getWorkstationConfig(name);
 }
 
Parameter
NameDescription
nameString

Required. Name of the requested resource.

Returns
TypeDescription
WorkstationConfig

getWorkstationConfigCallable()

public final UnaryCallable<GetWorkstationConfigRequest,WorkstationConfig> getWorkstationConfigCallable()

Returns the requested workstation configuration.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   GetWorkstationConfigRequest request =
       GetWorkstationConfigRequest.newBuilder()
           .setName(
               WorkstationConfigName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]")
                   .toString())
           .build();
   ApiFuture<WorkstationConfig> future =
       workstationsClient.getWorkstationConfigCallable().futureCall(request);
   // Do something.
   WorkstationConfig response = future.get();
 }
 
Returns
TypeDescription
UnaryCallable<GetWorkstationConfigRequest,WorkstationConfig>

isShutdown()

public boolean isShutdown()
Returns
TypeDescription
boolean

isTerminated()

public boolean isTerminated()
Returns
TypeDescription
boolean

listUsableWorkstationConfigs(ListUsableWorkstationConfigsRequest request)

public final WorkstationsClient.ListUsableWorkstationConfigsPagedResponse listUsableWorkstationConfigs(ListUsableWorkstationConfigsRequest request)

Returns all workstation configurations in the specified cluster on which the caller has the "workstations.workstation.create" permission.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   ListUsableWorkstationConfigsRequest request =
       ListUsableWorkstationConfigsRequest.newBuilder()
           .setParent(
               WorkstationClusterName.of("[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]")
                   .toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   for (WorkstationConfig element :
       workstationsClient.listUsableWorkstationConfigs(request).iterateAll()) {
     // doThingsWith(element);
   }
 }
 
Parameter
NameDescription
requestListUsableWorkstationConfigsRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
WorkstationsClient.ListUsableWorkstationConfigsPagedResponse

listUsableWorkstationConfigs(WorkstationClusterName parent)

public final WorkstationsClient.ListUsableWorkstationConfigsPagedResponse listUsableWorkstationConfigs(WorkstationClusterName parent)

Returns all workstation configurations in the specified cluster on which the caller has the "workstations.workstation.create" permission.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   WorkstationClusterName parent =
       WorkstationClusterName.of("[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]");
   for (WorkstationConfig element :
       workstationsClient.listUsableWorkstationConfigs(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
 
Parameter
NameDescription
parentWorkstationClusterName

Required. Parent resource name.

Returns
TypeDescription
WorkstationsClient.ListUsableWorkstationConfigsPagedResponse

listUsableWorkstationConfigs(String parent)

public final WorkstationsClient.ListUsableWorkstationConfigsPagedResponse listUsableWorkstationConfigs(String parent)

Returns all workstation configurations in the specified cluster on which the caller has the "workstations.workstation.create" permission.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   String parent =
       WorkstationClusterName.of("[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]").toString();
   for (WorkstationConfig element :
       workstationsClient.listUsableWorkstationConfigs(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
 
Parameter
NameDescription
parentString

Required. Parent resource name.

Returns
TypeDescription
WorkstationsClient.ListUsableWorkstationConfigsPagedResponse

listUsableWorkstationConfigsCallable()

public final UnaryCallable<ListUsableWorkstationConfigsRequest,ListUsableWorkstationConfigsResponse> listUsableWorkstationConfigsCallable()

Returns all workstation configurations in the specified cluster on which the caller has the "workstations.workstation.create" permission.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   ListUsableWorkstationConfigsRequest request =
       ListUsableWorkstationConfigsRequest.newBuilder()
           .setParent(
               WorkstationClusterName.of("[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]")
                   .toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   while (true) {
     ListUsableWorkstationConfigsResponse response =
         workstationsClient.listUsableWorkstationConfigsCallable().call(request);
     for (WorkstationConfig element : response.getWorkstationConfigsList()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }
 
Returns
TypeDescription
UnaryCallable<ListUsableWorkstationConfigsRequest,ListUsableWorkstationConfigsResponse>

listUsableWorkstationConfigsPagedCallable()

public final UnaryCallable<ListUsableWorkstationConfigsRequest,WorkstationsClient.ListUsableWorkstationConfigsPagedResponse> listUsableWorkstationConfigsPagedCallable()

Returns all workstation configurations in the specified cluster on which the caller has the "workstations.workstation.create" permission.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   ListUsableWorkstationConfigsRequest request =
       ListUsableWorkstationConfigsRequest.newBuilder()
           .setParent(
               WorkstationClusterName.of("[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]")
                   .toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   ApiFuture<WorkstationConfig> future =
       workstationsClient.listUsableWorkstationConfigsPagedCallable().futureCall(request);
   // Do something.
   for (WorkstationConfig element : future.get().iterateAll()) {
     // doThingsWith(element);
   }
 }
 
Returns
TypeDescription
UnaryCallable<ListUsableWorkstationConfigsRequest,ListUsableWorkstationConfigsPagedResponse>

listUsableWorkstations(ListUsableWorkstationsRequest request)

public final WorkstationsClient.ListUsableWorkstationsPagedResponse listUsableWorkstations(ListUsableWorkstationsRequest request)

Returns all workstations using the specified workstation configuration on which the caller has the "workstations.workstations.use" permission.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   ListUsableWorkstationsRequest request =
       ListUsableWorkstationsRequest.newBuilder()
           .setParent(
               WorkstationConfigName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]")
                   .toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   for (Workstation element : workstationsClient.listUsableWorkstations(request).iterateAll()) {
     // doThingsWith(element);
   }
 }
 
Parameter
NameDescription
requestListUsableWorkstationsRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
WorkstationsClient.ListUsableWorkstationsPagedResponse

listUsableWorkstations(WorkstationConfigName parent)

public final WorkstationsClient.ListUsableWorkstationsPagedResponse listUsableWorkstations(WorkstationConfigName parent)

Returns all workstations using the specified workstation configuration on which the caller has the "workstations.workstations.use" permission.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   WorkstationConfigName parent =
       WorkstationConfigName.of(
           "[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]", "[WORKSTATION_CONFIG]");
   for (Workstation element : workstationsClient.listUsableWorkstations(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
 
Parameter
NameDescription
parentWorkstationConfigName

Required. Parent resource name.

Returns
TypeDescription
WorkstationsClient.ListUsableWorkstationsPagedResponse

listUsableWorkstations(String parent)

public final WorkstationsClient.ListUsableWorkstationsPagedResponse listUsableWorkstations(String parent)

Returns all workstations using the specified workstation configuration on which the caller has the "workstations.workstations.use" permission.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   String parent =
       WorkstationConfigName.of(
               "[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]", "[WORKSTATION_CONFIG]")
           .toString();
   for (Workstation element : workstationsClient.listUsableWorkstations(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
 
Parameter
NameDescription
parentString

Required. Parent resource name.

Returns
TypeDescription
WorkstationsClient.ListUsableWorkstationsPagedResponse

listUsableWorkstationsCallable()

public final UnaryCallable<ListUsableWorkstationsRequest,ListUsableWorkstationsResponse> listUsableWorkstationsCallable()

Returns all workstations using the specified workstation configuration on which the caller has the "workstations.workstations.use" permission.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   ListUsableWorkstationsRequest request =
       ListUsableWorkstationsRequest.newBuilder()
           .setParent(
               WorkstationConfigName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]")
                   .toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   while (true) {
     ListUsableWorkstationsResponse response =
         workstationsClient.listUsableWorkstationsCallable().call(request);
     for (Workstation element : response.getWorkstationsList()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }
 
Returns
TypeDescription
UnaryCallable<ListUsableWorkstationsRequest,ListUsableWorkstationsResponse>

listUsableWorkstationsPagedCallable()

public final UnaryCallable<ListUsableWorkstationsRequest,WorkstationsClient.ListUsableWorkstationsPagedResponse> listUsableWorkstationsPagedCallable()

Returns all workstations using the specified workstation configuration on which the caller has the "workstations.workstations.use" permission.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   ListUsableWorkstationsRequest request =
       ListUsableWorkstationsRequest.newBuilder()
           .setParent(
               WorkstationConfigName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]")
                   .toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   ApiFuture<Workstation> future =
       workstationsClient.listUsableWorkstationsPagedCallable().futureCall(request);
   // Do something.
   for (Workstation element : future.get().iterateAll()) {
     // doThingsWith(element);
   }
 }
 
Returns
TypeDescription
UnaryCallable<ListUsableWorkstationsRequest,ListUsableWorkstationsPagedResponse>

listWorkstationClusters(ListWorkstationClustersRequest request)

public final WorkstationsClient.ListWorkstationClustersPagedResponse listWorkstationClusters(ListWorkstationClustersRequest request)

Returns all workstation clusters in the specified location.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   ListWorkstationClustersRequest request =
       ListWorkstationClustersRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   for (WorkstationCluster element :
       workstationsClient.listWorkstationClusters(request).iterateAll()) {
     // doThingsWith(element);
   }
 }
 
Parameter
NameDescription
requestListWorkstationClustersRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
WorkstationsClient.ListWorkstationClustersPagedResponse

listWorkstationClusters(LocationName parent)

public final WorkstationsClient.ListWorkstationClustersPagedResponse listWorkstationClusters(LocationName parent)

Returns all workstation clusters in the specified location.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
   for (WorkstationCluster element :
       workstationsClient.listWorkstationClusters(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
 
Parameter
NameDescription
parentLocationName

Required. Parent resource name.

Returns
TypeDescription
WorkstationsClient.ListWorkstationClustersPagedResponse

listWorkstationClusters(String parent)

public final WorkstationsClient.ListWorkstationClustersPagedResponse listWorkstationClusters(String parent)

Returns all workstation clusters in the specified location.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
   for (WorkstationCluster element :
       workstationsClient.listWorkstationClusters(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
 
Parameter
NameDescription
parentString

Required. Parent resource name.

Returns
TypeDescription
WorkstationsClient.ListWorkstationClustersPagedResponse

listWorkstationClustersCallable()

public final UnaryCallable<ListWorkstationClustersRequest,ListWorkstationClustersResponse> listWorkstationClustersCallable()

Returns all workstation clusters in the specified location.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   ListWorkstationClustersRequest request =
       ListWorkstationClustersRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   while (true) {
     ListWorkstationClustersResponse response =
         workstationsClient.listWorkstationClustersCallable().call(request);
     for (WorkstationCluster element : response.getWorkstationClustersList()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }
 
Returns
TypeDescription
UnaryCallable<ListWorkstationClustersRequest,ListWorkstationClustersResponse>

listWorkstationClustersPagedCallable()

public final UnaryCallable<ListWorkstationClustersRequest,WorkstationsClient.ListWorkstationClustersPagedResponse> listWorkstationClustersPagedCallable()

Returns all workstation clusters in the specified location.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   ListWorkstationClustersRequest request =
       ListWorkstationClustersRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   ApiFuture<WorkstationCluster> future =
       workstationsClient.listWorkstationClustersPagedCallable().futureCall(request);
   // Do something.
   for (WorkstationCluster element : future.get().iterateAll()) {
     // doThingsWith(element);
   }
 }
 
Returns
TypeDescription
UnaryCallable<ListWorkstationClustersRequest,ListWorkstationClustersPagedResponse>

listWorkstationConfigs(ListWorkstationConfigsRequest request)

public final WorkstationsClient.ListWorkstationConfigsPagedResponse listWorkstationConfigs(ListWorkstationConfigsRequest request)

Returns all workstation configurations in the specified cluster.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   ListWorkstationConfigsRequest request =
       ListWorkstationConfigsRequest.newBuilder()
           .setParent(
               WorkstationClusterName.of("[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]")
                   .toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   for (WorkstationConfig element :
       workstationsClient.listWorkstationConfigs(request).iterateAll()) {
     // doThingsWith(element);
   }
 }
 
Parameter
NameDescription
requestListWorkstationConfigsRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
WorkstationsClient.ListWorkstationConfigsPagedResponse

listWorkstationConfigs(WorkstationClusterName parent)

public final WorkstationsClient.ListWorkstationConfigsPagedResponse listWorkstationConfigs(WorkstationClusterName parent)

Returns all workstation configurations in the specified cluster.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   WorkstationClusterName parent =
       WorkstationClusterName.of("[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]");
   for (WorkstationConfig element :
       workstationsClient.listWorkstationConfigs(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
 
Parameter
NameDescription
parentWorkstationClusterName

Required. Parent resource name.

Returns
TypeDescription
WorkstationsClient.ListWorkstationConfigsPagedResponse

listWorkstationConfigs(String parent)

public final WorkstationsClient.ListWorkstationConfigsPagedResponse listWorkstationConfigs(String parent)

Returns all workstation configurations in the specified cluster.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   String parent =
       WorkstationClusterName.of("[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]").toString();
   for (WorkstationConfig element :
       workstationsClient.listWorkstationConfigs(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
 
Parameter
NameDescription
parentString

Required. Parent resource name.

Returns
TypeDescription
WorkstationsClient.ListWorkstationConfigsPagedResponse

listWorkstationConfigsCallable()

public final UnaryCallable<ListWorkstationConfigsRequest,ListWorkstationConfigsResponse> listWorkstationConfigsCallable()

Returns all workstation configurations in the specified cluster.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   ListWorkstationConfigsRequest request =
       ListWorkstationConfigsRequest.newBuilder()
           .setParent(
               WorkstationClusterName.of("[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]")
                   .toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   while (true) {
     ListWorkstationConfigsResponse response =
         workstationsClient.listWorkstationConfigsCallable().call(request);
     for (WorkstationConfig element : response.getWorkstationConfigsList()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }
 
Returns
TypeDescription
UnaryCallable<ListWorkstationConfigsRequest,ListWorkstationConfigsResponse>

listWorkstationConfigsPagedCallable()

public final UnaryCallable<ListWorkstationConfigsRequest,WorkstationsClient.ListWorkstationConfigsPagedResponse> listWorkstationConfigsPagedCallable()

Returns all workstation configurations in the specified cluster.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   ListWorkstationConfigsRequest request =
       ListWorkstationConfigsRequest.newBuilder()
           .setParent(
               WorkstationClusterName.of("[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]")
                   .toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   ApiFuture<WorkstationConfig> future =
       workstationsClient.listWorkstationConfigsPagedCallable().futureCall(request);
   // Do something.
   for (WorkstationConfig element : future.get().iterateAll()) {
     // doThingsWith(element);
   }
 }
 
Returns
TypeDescription
UnaryCallable<ListWorkstationConfigsRequest,ListWorkstationConfigsPagedResponse>

listWorkstations(ListWorkstationsRequest request)

public final WorkstationsClient.ListWorkstationsPagedResponse listWorkstations(ListWorkstationsRequest request)

Returns all Workstations using the specified workstation configuration.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   ListWorkstationsRequest request =
       ListWorkstationsRequest.newBuilder()
           .setParent(
               WorkstationConfigName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]")
                   .toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   for (Workstation element : workstationsClient.listWorkstations(request).iterateAll()) {
     // doThingsWith(element);
   }
 }
 
Parameter
NameDescription
requestListWorkstationsRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
WorkstationsClient.ListWorkstationsPagedResponse

listWorkstations(WorkstationConfigName parent)

public final WorkstationsClient.ListWorkstationsPagedResponse listWorkstations(WorkstationConfigName parent)

Returns all Workstations using the specified workstation configuration.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   WorkstationConfigName parent =
       WorkstationConfigName.of(
           "[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]", "[WORKSTATION_CONFIG]");
   for (Workstation element : workstationsClient.listWorkstations(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
 
Parameter
NameDescription
parentWorkstationConfigName

Required. Parent resource name.

Returns
TypeDescription
WorkstationsClient.ListWorkstationsPagedResponse

listWorkstations(String parent)

public final WorkstationsClient.ListWorkstationsPagedResponse listWorkstations(String parent)

Returns all Workstations using the specified workstation configuration.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   String parent =
       WorkstationConfigName.of(
               "[PROJECT]", "[LOCATION]", "[WORKSTATION_CLUSTER]", "[WORKSTATION_CONFIG]")
           .toString();
   for (Workstation element : workstationsClient.listWorkstations(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
 
Parameter
NameDescription
parentString

Required. Parent resource name.

Returns
TypeDescription
WorkstationsClient.ListWorkstationsPagedResponse

listWorkstationsCallable()

public final UnaryCallable<ListWorkstationsRequest,ListWorkstationsResponse> listWorkstationsCallable()

Returns all Workstations using the specified workstation configuration.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   ListWorkstationsRequest request =
       ListWorkstationsRequest.newBuilder()
           .setParent(
               WorkstationConfigName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]")
                   .toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   while (true) {
     ListWorkstationsResponse response =
         workstationsClient.listWorkstationsCallable().call(request);
     for (Workstation element : response.getWorkstationsList()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }
 
Returns
TypeDescription
UnaryCallable<ListWorkstationsRequest,ListWorkstationsResponse>

listWorkstationsPagedCallable()

public final UnaryCallable<ListWorkstationsRequest,WorkstationsClient.ListWorkstationsPagedResponse> listWorkstationsPagedCallable()

Returns all Workstations using the specified workstation configuration.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   ListWorkstationsRequest request =
       ListWorkstationsRequest.newBuilder()
           .setParent(
               WorkstationConfigName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]")
                   .toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   ApiFuture<Workstation> future =
       workstationsClient.listWorkstationsPagedCallable().futureCall(request);
   // Do something.
   for (Workstation element : future.get().iterateAll()) {
     // doThingsWith(element);
   }
 }
 
Returns
TypeDescription
UnaryCallable<ListWorkstationsRequest,ListWorkstationsPagedResponse>

setIamPolicy(SetIamPolicyRequest request)

public final Policy setIamPolicy(SetIamPolicyRequest request)

Sets the access control policy on the specified resource. Replacesany existing policy.

Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIEDerrors.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   SetIamPolicyRequest request =
       SetIamPolicyRequest.newBuilder()
           .setResource(
               WorkstationName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]",
                       "[WORKSTATION]")
                   .toString())
           .setPolicy(Policy.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .build();
   Policy response = workstationsClient.setIamPolicy(request);
 }
 
Parameter
NameDescription
requestcom.google.iam.v1.SetIamPolicyRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
com.google.iam.v1.Policy

setIamPolicyCallable()

public final UnaryCallable<SetIamPolicyRequest,Policy> setIamPolicyCallable()

Sets the access control policy on the specified resource. Replacesany existing policy.

Can return NOT_FOUND, INVALID_ARGUMENT, and PERMISSION_DENIEDerrors.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   SetIamPolicyRequest request =
       SetIamPolicyRequest.newBuilder()
           .setResource(
               WorkstationName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]",
                       "[WORKSTATION]")
                   .toString())
           .setPolicy(Policy.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .build();
   ApiFuture<Policy> future = workstationsClient.setIamPolicyCallable().futureCall(request);
   // Do something.
   Policy response = future.get();
 }
 
Returns
TypeDescription
UnaryCallable<com.google.iam.v1.SetIamPolicyRequest,com.google.iam.v1.Policy>

shutdown()

public void shutdown()

shutdownNow()

public void shutdownNow()

startWorkstationAsync(StartWorkstationRequest request)

public final OperationFuture<Workstation,OperationMetadata> startWorkstationAsync(StartWorkstationRequest request)

Starts running a workstation so that users can connect to it.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   StartWorkstationRequest request =
       StartWorkstationRequest.newBuilder()
           .setName(
               WorkstationName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]",
                       "[WORKSTATION]")
                   .toString())
           .setValidateOnly(true)
           .setEtag("etag3123477")
           .build();
   Workstation response = workstationsClient.startWorkstationAsync(request).get();
 }
 
Parameter
NameDescription
requestStartWorkstationRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
OperationFuture<Workstation,OperationMetadata>

startWorkstationAsync(WorkstationName name)

public final OperationFuture<Workstation,OperationMetadata> startWorkstationAsync(WorkstationName name)

Starts running a workstation so that users can connect to it.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   WorkstationName name =
       WorkstationName.of(
           "[PROJECT]",
           "[LOCATION]",
           "[WORKSTATION_CLUSTER]",
           "[WORKSTATION_CONFIG]",
           "[WORKSTATION]");
   Workstation response = workstationsClient.startWorkstationAsync(name).get();
 }
 
Parameter
NameDescription
nameWorkstationName

Required. Name of the workstation to start.

Returns
TypeDescription
OperationFuture<Workstation,OperationMetadata>

startWorkstationAsync(String name)

public final OperationFuture<Workstation,OperationMetadata> startWorkstationAsync(String name)

Starts running a workstation so that users can connect to it.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   String name =
       WorkstationName.of(
               "[PROJECT]",
               "[LOCATION]",
               "[WORKSTATION_CLUSTER]",
               "[WORKSTATION_CONFIG]",
               "[WORKSTATION]")
           .toString();
   Workstation response = workstationsClient.startWorkstationAsync(name).get();
 }
 
Parameter
NameDescription
nameString

Required. Name of the workstation to start.

Returns
TypeDescription
OperationFuture<Workstation,OperationMetadata>

startWorkstationCallable()

public final UnaryCallable<StartWorkstationRequest,Operation> startWorkstationCallable()

Starts running a workstation so that users can connect to it.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   StartWorkstationRequest request =
       StartWorkstationRequest.newBuilder()
           .setName(
               WorkstationName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]",
                       "[WORKSTATION]")
                   .toString())
           .setValidateOnly(true)
           .setEtag("etag3123477")
           .build();
   ApiFuture<Operation> future =
       workstationsClient.startWorkstationCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 
Returns
TypeDescription
UnaryCallable<StartWorkstationRequest,Operation>

startWorkstationOperationCallable()

public final OperationCallable<StartWorkstationRequest,Workstation,OperationMetadata> startWorkstationOperationCallable()

Starts running a workstation so that users can connect to it.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   StartWorkstationRequest request =
       StartWorkstationRequest.newBuilder()
           .setName(
               WorkstationName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]",
                       "[WORKSTATION]")
                   .toString())
           .setValidateOnly(true)
           .setEtag("etag3123477")
           .build();
   OperationFuture<Workstation, OperationMetadata> future =
       workstationsClient.startWorkstationOperationCallable().futureCall(request);
   // Do something.
   Workstation response = future.get();
 }
 
Returns
TypeDescription
OperationCallable<StartWorkstationRequest,Workstation,OperationMetadata>

stopWorkstationAsync(StopWorkstationRequest request)

public final OperationFuture<Workstation,OperationMetadata> stopWorkstationAsync(StopWorkstationRequest request)

Stops running a workstation, reducing costs.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   StopWorkstationRequest request =
       StopWorkstationRequest.newBuilder()
           .setName(
               WorkstationName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]",
                       "[WORKSTATION]")
                   .toString())
           .setValidateOnly(true)
           .setEtag("etag3123477")
           .build();
   Workstation response = workstationsClient.stopWorkstationAsync(request).get();
 }
 
Parameter
NameDescription
requestStopWorkstationRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
OperationFuture<Workstation,OperationMetadata>

stopWorkstationAsync(WorkstationName name)

public final OperationFuture<Workstation,OperationMetadata> stopWorkstationAsync(WorkstationName name)

Stops running a workstation, reducing costs.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   WorkstationName name =
       WorkstationName.of(
           "[PROJECT]",
           "[LOCATION]",
           "[WORKSTATION_CLUSTER]",
           "[WORKSTATION_CONFIG]",
           "[WORKSTATION]");
   Workstation response = workstationsClient.stopWorkstationAsync(name).get();
 }
 
Parameter
NameDescription
nameWorkstationName

Required. Name of the workstation to stop.

Returns
TypeDescription
OperationFuture<Workstation,OperationMetadata>

stopWorkstationAsync(String name)

public final OperationFuture<Workstation,OperationMetadata> stopWorkstationAsync(String name)

Stops running a workstation, reducing costs.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   String name =
       WorkstationName.of(
               "[PROJECT]",
               "[LOCATION]",
               "[WORKSTATION_CLUSTER]",
               "[WORKSTATION_CONFIG]",
               "[WORKSTATION]")
           .toString();
   Workstation response = workstationsClient.stopWorkstationAsync(name).get();
 }
 
Parameter
NameDescription
nameString

Required. Name of the workstation to stop.

Returns
TypeDescription
OperationFuture<Workstation,OperationMetadata>

stopWorkstationCallable()

public final UnaryCallable<StopWorkstationRequest,Operation> stopWorkstationCallable()

Stops running a workstation, reducing costs.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   StopWorkstationRequest request =
       StopWorkstationRequest.newBuilder()
           .setName(
               WorkstationName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]",
                       "[WORKSTATION]")
                   .toString())
           .setValidateOnly(true)
           .setEtag("etag3123477")
           .build();
   ApiFuture<Operation> future =
       workstationsClient.stopWorkstationCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 
Returns
TypeDescription
UnaryCallable<StopWorkstationRequest,Operation>

stopWorkstationOperationCallable()

public final OperationCallable<StopWorkstationRequest,Workstation,OperationMetadata> stopWorkstationOperationCallable()

Stops running a workstation, reducing costs.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   StopWorkstationRequest request =
       StopWorkstationRequest.newBuilder()
           .setName(
               WorkstationName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]",
                       "[WORKSTATION]")
                   .toString())
           .setValidateOnly(true)
           .setEtag("etag3123477")
           .build();
   OperationFuture<Workstation, OperationMetadata> future =
       workstationsClient.stopWorkstationOperationCallable().futureCall(request);
   // Do something.
   Workstation response = future.get();
 }
 
Returns
TypeDescription
OperationCallable<StopWorkstationRequest,Workstation,OperationMetadata>

testIamPermissions(TestIamPermissionsRequest request)

public final TestIamPermissionsResponse testIamPermissions(TestIamPermissionsRequest request)

Returns permissions that a caller has on the specified resource. If theresource does not exist, this will return an empty set ofpermissions, not a NOT_FOUND error.

Note: This operation is designed to be used for buildingpermission-aware UIs and command-line tools, not for authorizationchecking. This operation may "fail open" without warning.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   TestIamPermissionsRequest request =
       TestIamPermissionsRequest.newBuilder()
           .setResource(
               WorkstationName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]",
                       "[WORKSTATION]")
                   .toString())
           .addAllPermissions(new ArrayList<String>())
           .build();
   TestIamPermissionsResponse response = workstationsClient.testIamPermissions(request);
 }
 
Parameter
NameDescription
requestcom.google.iam.v1.TestIamPermissionsRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
com.google.iam.v1.TestIamPermissionsResponse

testIamPermissionsCallable()

public final UnaryCallable<TestIamPermissionsRequest,TestIamPermissionsResponse> testIamPermissionsCallable()

Returns permissions that a caller has on the specified resource. If theresource does not exist, this will return an empty set ofpermissions, not a NOT_FOUND error.

Note: This operation is designed to be used for buildingpermission-aware UIs and command-line tools, not for authorizationchecking. This operation may "fail open" without warning.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   TestIamPermissionsRequest request =
       TestIamPermissionsRequest.newBuilder()
           .setResource(
               WorkstationName.of(
                       "[PROJECT]",
                       "[LOCATION]",
                       "[WORKSTATION_CLUSTER]",
                       "[WORKSTATION_CONFIG]",
                       "[WORKSTATION]")
                   .toString())
           .addAllPermissions(new ArrayList<String>())
           .build();
   ApiFuture<TestIamPermissionsResponse> future =
       workstationsClient.testIamPermissionsCallable().futureCall(request);
   // Do something.
   TestIamPermissionsResponse response = future.get();
 }
 
Returns
TypeDescription
UnaryCallable<com.google.iam.v1.TestIamPermissionsRequest,com.google.iam.v1.TestIamPermissionsResponse>

updateWorkstationAsync(UpdateWorkstationRequest request)

public final OperationFuture<Workstation,OperationMetadata> updateWorkstationAsync(UpdateWorkstationRequest request)

Updates an existing workstation.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   UpdateWorkstationRequest request =
       UpdateWorkstationRequest.newBuilder()
           .setWorkstation(Workstation.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .setValidateOnly(true)
           .setAllowMissing(true)
           .build();
   Workstation response = workstationsClient.updateWorkstationAsync(request).get();
 }
 
Parameter
NameDescription
requestUpdateWorkstationRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
OperationFuture<Workstation,OperationMetadata>

updateWorkstationAsync(Workstation workstation, FieldMask updateMask)

public final OperationFuture<Workstation,OperationMetadata> updateWorkstationAsync(Workstation workstation, FieldMask updateMask)

Updates an existing workstation.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   Workstation workstation = Workstation.newBuilder().build();
   FieldMask updateMask = FieldMask.newBuilder().build();
   Workstation response =
       workstationsClient.updateWorkstationAsync(workstation, updateMask).get();
 }
 
Parameters
NameDescription
workstationWorkstation

Required. Workstation to update.

updateMaskFieldMask

Required. Mask specifying which fields in the workstation configuration should be updated.

Returns
TypeDescription
OperationFuture<Workstation,OperationMetadata>

updateWorkstationCallable()

public final UnaryCallable<UpdateWorkstationRequest,Operation> updateWorkstationCallable()

Updates an existing workstation.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   UpdateWorkstationRequest request =
       UpdateWorkstationRequest.newBuilder()
           .setWorkstation(Workstation.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .setValidateOnly(true)
           .setAllowMissing(true)
           .build();
   ApiFuture<Operation> future =
       workstationsClient.updateWorkstationCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 
Returns
TypeDescription
UnaryCallable<UpdateWorkstationRequest,Operation>

updateWorkstationClusterAsync(UpdateWorkstationClusterRequest request)

public final OperationFuture<WorkstationCluster,OperationMetadata> updateWorkstationClusterAsync(UpdateWorkstationClusterRequest request)

Updates an existing workstation cluster.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   UpdateWorkstationClusterRequest request =
       UpdateWorkstationClusterRequest.newBuilder()
           .setWorkstationCluster(WorkstationCluster.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .setValidateOnly(true)
           .setAllowMissing(true)
           .build();
   WorkstationCluster response = workstationsClient.updateWorkstationClusterAsync(request).get();
 }
 
Parameter
NameDescription
requestUpdateWorkstationClusterRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
OperationFuture<WorkstationCluster,OperationMetadata>

updateWorkstationClusterAsync(WorkstationCluster workstationCluster, FieldMask updateMask)

public final OperationFuture<WorkstationCluster,OperationMetadata> updateWorkstationClusterAsync(WorkstationCluster workstationCluster, FieldMask updateMask)

Updates an existing workstation cluster.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   WorkstationCluster workstationCluster = WorkstationCluster.newBuilder().build();
   FieldMask updateMask = FieldMask.newBuilder().build();
   WorkstationCluster response =
       workstationsClient.updateWorkstationClusterAsync(workstationCluster, updateMask).get();
 }
 
Parameters
NameDescription
workstationClusterWorkstationCluster

Required. Workstation cluster to update.

updateMaskFieldMask

Required. Mask that specifies which fields in the workstation cluster should be updated.

Returns
TypeDescription
OperationFuture<WorkstationCluster,OperationMetadata>

updateWorkstationClusterCallable()

public final UnaryCallable<UpdateWorkstationClusterRequest,Operation> updateWorkstationClusterCallable()

Updates an existing workstation cluster.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   UpdateWorkstationClusterRequest request =
       UpdateWorkstationClusterRequest.newBuilder()
           .setWorkstationCluster(WorkstationCluster.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .setValidateOnly(true)
           .setAllowMissing(true)
           .build();
   ApiFuture<Operation> future =
       workstationsClient.updateWorkstationClusterCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 
Returns
TypeDescription
UnaryCallable<UpdateWorkstationClusterRequest,Operation>

updateWorkstationClusterOperationCallable()

public final OperationCallable<UpdateWorkstationClusterRequest,WorkstationCluster,OperationMetadata> updateWorkstationClusterOperationCallable()

Updates an existing workstation cluster.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   UpdateWorkstationClusterRequest request =
       UpdateWorkstationClusterRequest.newBuilder()
           .setWorkstationCluster(WorkstationCluster.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .setValidateOnly(true)
           .setAllowMissing(true)
           .build();
   OperationFuture<WorkstationCluster, OperationMetadata> future =
       workstationsClient.updateWorkstationClusterOperationCallable().futureCall(request);
   // Do something.
   WorkstationCluster response = future.get();
 }
 
Returns
TypeDescription
OperationCallable<UpdateWorkstationClusterRequest,WorkstationCluster,OperationMetadata>

updateWorkstationConfigAsync(UpdateWorkstationConfigRequest request)

public final OperationFuture<WorkstationConfig,OperationMetadata> updateWorkstationConfigAsync(UpdateWorkstationConfigRequest request)

Updates an existing workstation configuration.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   UpdateWorkstationConfigRequest request =
       UpdateWorkstationConfigRequest.newBuilder()
           .setWorkstationConfig(WorkstationConfig.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .setValidateOnly(true)
           .setAllowMissing(true)
           .build();
   WorkstationConfig response = workstationsClient.updateWorkstationConfigAsync(request).get();
 }
 
Parameter
NameDescription
requestUpdateWorkstationConfigRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
OperationFuture<WorkstationConfig,OperationMetadata>

updateWorkstationConfigAsync(WorkstationConfig workstationConfig, FieldMask updateMask)

public final OperationFuture<WorkstationConfig,OperationMetadata> updateWorkstationConfigAsync(WorkstationConfig workstationConfig, FieldMask updateMask)

Updates an existing workstation configuration.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   WorkstationConfig workstationConfig = WorkstationConfig.newBuilder().build();
   FieldMask updateMask = FieldMask.newBuilder().build();
   WorkstationConfig response =
       workstationsClient.updateWorkstationConfigAsync(workstationConfig, updateMask).get();
 }
 
Parameters
NameDescription
workstationConfigWorkstationConfig

Required. Config to update.

updateMaskFieldMask

Required. Mask specifying which fields in the workstation configuration should be updated.

Returns
TypeDescription
OperationFuture<WorkstationConfig,OperationMetadata>

updateWorkstationConfigCallable()

public final UnaryCallable<UpdateWorkstationConfigRequest,Operation> updateWorkstationConfigCallable()

Updates an existing workstation configuration.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   UpdateWorkstationConfigRequest request =
       UpdateWorkstationConfigRequest.newBuilder()
           .setWorkstationConfig(WorkstationConfig.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .setValidateOnly(true)
           .setAllowMissing(true)
           .build();
   ApiFuture<Operation> future =
       workstationsClient.updateWorkstationConfigCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
 
Returns
TypeDescription
UnaryCallable<UpdateWorkstationConfigRequest,Operation>

updateWorkstationConfigOperationCallable()

public final OperationCallable<UpdateWorkstationConfigRequest,WorkstationConfig,OperationMetadata> updateWorkstationConfigOperationCallable()

Updates an existing workstation configuration.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   UpdateWorkstationConfigRequest request =
       UpdateWorkstationConfigRequest.newBuilder()
           .setWorkstationConfig(WorkstationConfig.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .setValidateOnly(true)
           .setAllowMissing(true)
           .build();
   OperationFuture<WorkstationConfig, OperationMetadata> future =
       workstationsClient.updateWorkstationConfigOperationCallable().futureCall(request);
   // Do something.
   WorkstationConfig response = future.get();
 }
 
Returns
TypeDescription
OperationCallable<UpdateWorkstationConfigRequest,WorkstationConfig,OperationMetadata>

updateWorkstationOperationCallable()

public final OperationCallable<UpdateWorkstationRequest,Workstation,OperationMetadata> updateWorkstationOperationCallable()

Updates an existing workstation.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (WorkstationsClient workstationsClient = WorkstationsClient.create()) {
   UpdateWorkstationRequest request =
       UpdateWorkstationRequest.newBuilder()
           .setWorkstation(Workstation.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .setValidateOnly(true)
           .setAllowMissing(true)
           .build();
   OperationFuture<Workstation, OperationMetadata> future =
       workstationsClient.updateWorkstationOperationCallable().futureCall(request);
   // Do something.
   Workstation response = future.get();
 }
 
Returns
TypeDescription
OperationCallable<UpdateWorkstationRequest,Workstation,OperationMetadata>