Package com.google.cloud.notebooks.v1

Class ManagedNotebookServiceClient

  • All Implemented Interfaces:
    com.google.api.gax.core.BackgroundResource, AutoCloseable
    @Generated("by gapic-generator-java")
public class ManagedNotebookServiceClient
extends Object
implements com.google.api.gax.core.BackgroundResource
    Service Description: API v1 service for Managed Notebooks.

    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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   RuntimeName name = RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]");
   Runtime response = managedNotebookServiceClient.getRuntime(name);
 }

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

    The surface of this class includes several types of Java methods for each of the API's methods:

    1. A "flattened" method. With this type of method, the fields of the request type have been converted into function parameters. It may be the case that not all fields are available as parameters, and not every API method will have a flattened method entry point.
    2. A "request object" method. This type of method only takes one parameter, a request object, which must be constructed before the call. Not every API method will have a request object method.
    3. A "callable" method. This type of method takes no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    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 ManagedNotebookServiceSettings 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
 ManagedNotebookServiceSettings managedNotebookServiceSettings =
     ManagedNotebookServiceSettings.newBuilder()
         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
         .build();
 ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create(managedNotebookServiceSettings);

    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
 ManagedNotebookServiceSettings managedNotebookServiceSettings =
     ManagedNotebookServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
 ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create(managedNotebookServiceSettings);

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

    • Constructor Detail

      • ManagedNotebookServiceClient

        protected ManagedNotebookServiceClient​(ManagedNotebookServiceSettings settings)
                                throws IOException
        Constructs an instance of ManagedNotebookServiceClient, 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.
        Throws:
        IOException

    • Method Detail

      • create

        public static final ManagedNotebookServiceClient create​(ManagedNotebookServiceStub stub)
        Constructs an instance of ManagedNotebookServiceClient, using the given stub for making calls. This is for advanced usage - prefer using create(ManagedNotebookServiceSettings).

      • getOperationsClient

        public final com.google.longrunning.OperationsClient getOperationsClient()
        Returns the OperationsClient that can be used to query the status of a long-running operation returned by another API method call.

      • listRuntimes

        public final ManagedNotebookServiceClient.ListRuntimesPagedResponse listRuntimes​(LocationName parent)
        Lists Runtimes in a given project and 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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
   for (Runtime element : managedNotebookServiceClient.listRuntimes(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
        Parameters:
        parent - Required. Format: `parent=projects/{project_id}/locations/{location}`
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • listRuntimes

        public final ManagedNotebookServiceClient.ListRuntimesPagedResponse listRuntimes​(String parent)
        Lists Runtimes in a given project and 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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
   for (Runtime element : managedNotebookServiceClient.listRuntimes(parent).iterateAll()) {
     // doThingsWith(element);
   }
 }
        Parameters:
        parent - Required. Format: `parent=projects/{project_id}/locations/{location}`
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • listRuntimes

        public final ManagedNotebookServiceClient.ListRuntimesPagedResponse listRuntimes​(ListRuntimesRequest request)
        Lists Runtimes in a given project and 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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   ListRuntimesRequest request =
       ListRuntimesRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   for (Runtime element : managedNotebookServiceClient.listRuntimes(request).iterateAll()) {
     // doThingsWith(element);
   }
 }
        Parameters:
        request - The request object containing all of the parameters for the API call.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • listRuntimesPagedCallable

        public final com.google.api.gax.rpc.UnaryCallable<ListRuntimesRequest,​ManagedNotebookServiceClient.ListRuntimesPagedResponse> listRuntimesPagedCallable()
        Lists Runtimes in a given project and 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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   ListRuntimesRequest request =
       ListRuntimesRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   ApiFuture<Runtime> future =
       managedNotebookServiceClient.listRuntimesPagedCallable().futureCall(request);
   // Do something.
   for (Runtime element : future.get().iterateAll()) {
     // doThingsWith(element);
   }
 }

      • listRuntimesCallable

        public final com.google.api.gax.rpc.UnaryCallable<ListRuntimesRequest,​ListRuntimesResponse> listRuntimesCallable()
        Lists Runtimes in a given project and 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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   ListRuntimesRequest request =
       ListRuntimesRequest.newBuilder()
           .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   while (true) {
     ListRuntimesResponse response =
         managedNotebookServiceClient.listRuntimesCallable().call(request);
     for (Runtime element : response.getRuntimesList()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }

      • getRuntime

        public final Runtime getRuntime​(RuntimeName name)
        Gets details of a single Runtime. The location must be a regional endpoint rather than zonal.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   RuntimeName name = RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]");
   Runtime response = managedNotebookServiceClient.getRuntime(name);
 }
        Parameters:
        name - Required. Format: `projects/{project_id}/locations/{location}/runtimes/{runtime_id}`
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • getRuntime

        public final Runtime getRuntime​(String name)
        Gets details of a single Runtime. The location must be a regional endpoint rather than zonal.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   String name = RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString();
   Runtime response = managedNotebookServiceClient.getRuntime(name);
 }
        Parameters:
        name - Required. Format: `projects/{project_id}/locations/{location}/runtimes/{runtime_id}`
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • getRuntime

        public final Runtime getRuntime​(GetRuntimeRequest request)
        Gets details of a single Runtime. The location must be a regional endpoint rather than zonal.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   GetRuntimeRequest request =
       GetRuntimeRequest.newBuilder()
           .setName(RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString())
           .build();
   Runtime response = managedNotebookServiceClient.getRuntime(request);
 }
        Parameters:
        request - The request object containing all of the parameters for the API call.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • getRuntimeCallable

        public final com.google.api.gax.rpc.UnaryCallable<GetRuntimeRequest,​Runtime> getRuntimeCallable()
        Gets details of a single Runtime. The location must be a regional endpoint rather than zonal.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   GetRuntimeRequest request =
       GetRuntimeRequest.newBuilder()
           .setName(RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString())
           .build();
   ApiFuture<Runtime> future =
       managedNotebookServiceClient.getRuntimeCallable().futureCall(request);
   // Do something.
   Runtime response = future.get();
 }

      • createRuntimeAsync

        public final com.google.api.gax.longrunning.OperationFuture<Runtime,​OperationMetadata> createRuntimeAsync​(RuntimeName parent,
                                                                                                                String runtimeId,
                                                                                                                Runtime runtime)
        Creates a new Runtime in a given project and 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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   RuntimeName parent = RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]");
   String runtimeId = "runtimeId121455379";
   Runtime runtime = Runtime.newBuilder().build();
   Runtime response =
       managedNotebookServiceClient.createRuntimeAsync(parent, runtimeId, runtime).get();
 }
        Parameters:
        parent - Required. Format: `parent=projects/{project_id}/locations/{location}`
        runtimeId - Required. User-defined unique ID of this Runtime.
        runtime - Required. The Runtime to be created.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • createRuntimeAsync

        public final com.google.api.gax.longrunning.OperationFuture<Runtime,​OperationMetadata> createRuntimeAsync​(String parent,
                                                                                                                String runtimeId,
                                                                                                                Runtime runtime)
        Creates a new Runtime in a given project and 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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   String parent = RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString();
   String runtimeId = "runtimeId121455379";
   Runtime runtime = Runtime.newBuilder().build();
   Runtime response =
       managedNotebookServiceClient.createRuntimeAsync(parent, runtimeId, runtime).get();
 }
        Parameters:
        parent - Required. Format: `parent=projects/{project_id}/locations/{location}`
        runtimeId - Required. User-defined unique ID of this Runtime.
        runtime - Required. The Runtime to be created.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • createRuntimeAsync

        public final com.google.api.gax.longrunning.OperationFuture<Runtime,​OperationMetadata> createRuntimeAsync​(CreateRuntimeRequest request)
        Creates a new Runtime in a given project and 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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   CreateRuntimeRequest request =
       CreateRuntimeRequest.newBuilder()
           .setParent(RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString())
           .setRuntimeId("runtimeId121455379")
           .setRuntime(Runtime.newBuilder().build())
           .setRequestId("requestId693933066")
           .build();
   Runtime response = managedNotebookServiceClient.createRuntimeAsync(request).get();
 }
        Parameters:
        request - The request object containing all of the parameters for the API call.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • createRuntimeOperationCallable

        public final com.google.api.gax.rpc.OperationCallable<CreateRuntimeRequest,​Runtime,​OperationMetadata> createRuntimeOperationCallable()
        Creates a new Runtime in a given project and 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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   CreateRuntimeRequest request =
       CreateRuntimeRequest.newBuilder()
           .setParent(RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString())
           .setRuntimeId("runtimeId121455379")
           .setRuntime(Runtime.newBuilder().build())
           .setRequestId("requestId693933066")
           .build();
   OperationFuture<Runtime, OperationMetadata> future =
       managedNotebookServiceClient.createRuntimeOperationCallable().futureCall(request);
   // Do something.
   Runtime response = future.get();
 }

      • createRuntimeCallable

        public final com.google.api.gax.rpc.UnaryCallable<CreateRuntimeRequest,​com.google.longrunning.Operation> createRuntimeCallable()
        Creates a new Runtime in a given project and 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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   CreateRuntimeRequest request =
       CreateRuntimeRequest.newBuilder()
           .setParent(RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString())
           .setRuntimeId("runtimeId121455379")
           .setRuntime(Runtime.newBuilder().build())
           .setRequestId("requestId693933066")
           .build();
   ApiFuture<Operation> future =
       managedNotebookServiceClient.createRuntimeCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }

      • updateRuntimeAsync

        public final com.google.api.gax.longrunning.OperationFuture<Runtime,​OperationMetadata> updateRuntimeAsync​(Runtime runtime,
                                                                                                                com.google.protobuf.FieldMask updateMask)
        Update Notebook Runtime 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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   Runtime runtime = Runtime.newBuilder().build();
   FieldMask updateMask = FieldMask.newBuilder().build();
   Runtime response = managedNotebookServiceClient.updateRuntimeAsync(runtime, updateMask).get();
 }
        Parameters:
        runtime - Required. The Runtime to be updated.
        updateMask - Required. Specifies the path, relative to `Runtime`, of the field to update. For example, to change the software configuration kernels, the `update_mask` parameter would be specified as `software_config.kernels`, and the `PATCH` request body would specify the new value, as follows:

        { "software_config":{ "kernels": [{ 'repository': 'gcr.io/deeplearning-platform-release/pytorch-gpu', 'tag': 'latest' }], } }

        Currently, only the following fields can be updated: - `software_config.kernels` - `software_config.post_startup_script` - `software_config.custom_gpu_driver_path` - `software_config.idle_shutdown` - `software_config.idle_shutdown_timeout` - `software_config.disable_terminal`

        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • updateRuntimeAsync

        public final com.google.api.gax.longrunning.OperationFuture<Runtime,​OperationMetadata> updateRuntimeAsync​(UpdateRuntimeRequest request)
        Update Notebook Runtime 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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   UpdateRuntimeRequest request =
       UpdateRuntimeRequest.newBuilder()
           .setRuntime(Runtime.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .setRequestId("requestId693933066")
           .build();
   Runtime response = managedNotebookServiceClient.updateRuntimeAsync(request).get();
 }
        Parameters:
        request - The request object containing all of the parameters for the API call.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • updateRuntimeOperationCallable

        public final com.google.api.gax.rpc.OperationCallable<UpdateRuntimeRequest,​Runtime,​OperationMetadata> updateRuntimeOperationCallable()
        Update Notebook Runtime 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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   UpdateRuntimeRequest request =
       UpdateRuntimeRequest.newBuilder()
           .setRuntime(Runtime.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .setRequestId("requestId693933066")
           .build();
   OperationFuture<Runtime, OperationMetadata> future =
       managedNotebookServiceClient.updateRuntimeOperationCallable().futureCall(request);
   // Do something.
   Runtime response = future.get();
 }

      • updateRuntimeCallable

        public final com.google.api.gax.rpc.UnaryCallable<UpdateRuntimeRequest,​com.google.longrunning.Operation> updateRuntimeCallable()
        Update Notebook Runtime 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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   UpdateRuntimeRequest request =
       UpdateRuntimeRequest.newBuilder()
           .setRuntime(Runtime.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .setRequestId("requestId693933066")
           .build();
   ApiFuture<Operation> future =
       managedNotebookServiceClient.updateRuntimeCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }

      • deleteRuntimeAsync

        public final com.google.api.gax.longrunning.OperationFuture<com.google.protobuf.Empty,​OperationMetadata> deleteRuntimeAsync​(RuntimeName name)
        Deletes a single Runtime.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   RuntimeName name = RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]");
   managedNotebookServiceClient.deleteRuntimeAsync(name).get();
 }
        Parameters:
        name - Required. Format: `projects/{project_id}/locations/{location}/runtimes/{runtime_id}`
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • deleteRuntimeAsync

        public final com.google.api.gax.longrunning.OperationFuture<com.google.protobuf.Empty,​OperationMetadata> deleteRuntimeAsync​(String name)
        Deletes a single Runtime.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   String name = RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString();
   managedNotebookServiceClient.deleteRuntimeAsync(name).get();
 }
        Parameters:
        name - Required. Format: `projects/{project_id}/locations/{location}/runtimes/{runtime_id}`
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • deleteRuntimeAsync

        public final com.google.api.gax.longrunning.OperationFuture<com.google.protobuf.Empty,​OperationMetadata> deleteRuntimeAsync​(DeleteRuntimeRequest request)
        Deletes a single Runtime.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   DeleteRuntimeRequest request =
       DeleteRuntimeRequest.newBuilder()
           .setName(RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString())
           .setRequestId("requestId693933066")
           .build();
   managedNotebookServiceClient.deleteRuntimeAsync(request).get();
 }
        Parameters:
        request - The request object containing all of the parameters for the API call.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • deleteRuntimeOperationCallable

        public final com.google.api.gax.rpc.OperationCallable<DeleteRuntimeRequest,​com.google.protobuf.Empty,​OperationMetadata> deleteRuntimeOperationCallable()
        Deletes a single Runtime.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   DeleteRuntimeRequest request =
       DeleteRuntimeRequest.newBuilder()
           .setName(RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString())
           .setRequestId("requestId693933066")
           .build();
   OperationFuture<Empty, OperationMetadata> future =
       managedNotebookServiceClient.deleteRuntimeOperationCallable().futureCall(request);
   // Do something.
   future.get();
 }

      • deleteRuntimeCallable

        public final com.google.api.gax.rpc.UnaryCallable<DeleteRuntimeRequest,​com.google.longrunning.Operation> deleteRuntimeCallable()
        Deletes a single Runtime.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   DeleteRuntimeRequest request =
       DeleteRuntimeRequest.newBuilder()
           .setName(RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString())
           .setRequestId("requestId693933066")
           .build();
   ApiFuture<Operation> future =
       managedNotebookServiceClient.deleteRuntimeCallable().futureCall(request);
   // Do something.
   future.get();
 }

      • startRuntimeAsync

        public final com.google.api.gax.longrunning.OperationFuture<Runtime,​OperationMetadata> startRuntimeAsync​(String name)
        Starts a Managed Notebook Runtime. Perform "Start" on GPU instances; "Resume" on CPU instances See: https://cloud.google.com/compute/docs/instances/stop-start-instance https://cloud.google.com/compute/docs/instances/suspend-resume-instance

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   String name = "name3373707";
   Runtime response = managedNotebookServiceClient.startRuntimeAsync(name).get();
 }
        Parameters:
        name - Required. Format: `projects/{project_id}/locations/{location}/runtimes/{runtime_id}`
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • startRuntimeAsync

        public final com.google.api.gax.longrunning.OperationFuture<Runtime,​OperationMetadata> startRuntimeAsync​(StartRuntimeRequest request)
        Starts a Managed Notebook Runtime. Perform "Start" on GPU instances; "Resume" on CPU instances See: https://cloud.google.com/compute/docs/instances/stop-start-instance https://cloud.google.com/compute/docs/instances/suspend-resume-instance

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   StartRuntimeRequest request =
       StartRuntimeRequest.newBuilder()
           .setName("name3373707")
           .setRequestId("requestId693933066")
           .build();
   Runtime response = managedNotebookServiceClient.startRuntimeAsync(request).get();
 }
        Parameters:
        request - The request object containing all of the parameters for the API call.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • startRuntimeOperationCallable

        public final com.google.api.gax.rpc.OperationCallable<StartRuntimeRequest,​Runtime,​OperationMetadata> startRuntimeOperationCallable()
        Starts a Managed Notebook Runtime. Perform "Start" on GPU instances; "Resume" on CPU instances See: https://cloud.google.com/compute/docs/instances/stop-start-instance https://cloud.google.com/compute/docs/instances/suspend-resume-instance

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   StartRuntimeRequest request =
       StartRuntimeRequest.newBuilder()
           .setName("name3373707")
           .setRequestId("requestId693933066")
           .build();
   OperationFuture<Runtime, OperationMetadata> future =
       managedNotebookServiceClient.startRuntimeOperationCallable().futureCall(request);
   // Do something.
   Runtime response = future.get();
 }

      • startRuntimeCallable

        public final com.google.api.gax.rpc.UnaryCallable<StartRuntimeRequest,​com.google.longrunning.Operation> startRuntimeCallable()
        Starts a Managed Notebook Runtime. Perform "Start" on GPU instances; "Resume" on CPU instances See: https://cloud.google.com/compute/docs/instances/stop-start-instance https://cloud.google.com/compute/docs/instances/suspend-resume-instance

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   StartRuntimeRequest request =
       StartRuntimeRequest.newBuilder()
           .setName("name3373707")
           .setRequestId("requestId693933066")
           .build();
   ApiFuture<Operation> future =
       managedNotebookServiceClient.startRuntimeCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }

      • stopRuntimeAsync

        public final com.google.api.gax.longrunning.OperationFuture<Runtime,​OperationMetadata> stopRuntimeAsync​(String name)
        Stops a Managed Notebook Runtime. Perform "Stop" on GPU instances; "Suspend" on CPU instances See: https://cloud.google.com/compute/docs/instances/stop-start-instance https://cloud.google.com/compute/docs/instances/suspend-resume-instance

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   String name = "name3373707";
   Runtime response = managedNotebookServiceClient.stopRuntimeAsync(name).get();
 }
        Parameters:
        name - Required. Format: `projects/{project_id}/locations/{location}/runtimes/{runtime_id}`
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • stopRuntimeAsync

        public final com.google.api.gax.longrunning.OperationFuture<Runtime,​OperationMetadata> stopRuntimeAsync​(StopRuntimeRequest request)
        Stops a Managed Notebook Runtime. Perform "Stop" on GPU instances; "Suspend" on CPU instances See: https://cloud.google.com/compute/docs/instances/stop-start-instance https://cloud.google.com/compute/docs/instances/suspend-resume-instance

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   StopRuntimeRequest request =
       StopRuntimeRequest.newBuilder()
           .setName("name3373707")
           .setRequestId("requestId693933066")
           .build();
   Runtime response = managedNotebookServiceClient.stopRuntimeAsync(request).get();
 }
        Parameters:
        request - The request object containing all of the parameters for the API call.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • stopRuntimeOperationCallable

        public final com.google.api.gax.rpc.OperationCallable<StopRuntimeRequest,​Runtime,​OperationMetadata> stopRuntimeOperationCallable()
        Stops a Managed Notebook Runtime. Perform "Stop" on GPU instances; "Suspend" on CPU instances See: https://cloud.google.com/compute/docs/instances/stop-start-instance https://cloud.google.com/compute/docs/instances/suspend-resume-instance

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   StopRuntimeRequest request =
       StopRuntimeRequest.newBuilder()
           .setName("name3373707")
           .setRequestId("requestId693933066")
           .build();
   OperationFuture<Runtime, OperationMetadata> future =
       managedNotebookServiceClient.stopRuntimeOperationCallable().futureCall(request);
   // Do something.
   Runtime response = future.get();
 }

      • stopRuntimeCallable

        public final com.google.api.gax.rpc.UnaryCallable<StopRuntimeRequest,​com.google.longrunning.Operation> stopRuntimeCallable()
        Stops a Managed Notebook Runtime. Perform "Stop" on GPU instances; "Suspend" on CPU instances See: https://cloud.google.com/compute/docs/instances/stop-start-instance https://cloud.google.com/compute/docs/instances/suspend-resume-instance

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   StopRuntimeRequest request =
       StopRuntimeRequest.newBuilder()
           .setName("name3373707")
           .setRequestId("requestId693933066")
           .build();
   ApiFuture<Operation> future =
       managedNotebookServiceClient.stopRuntimeCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }

      • switchRuntimeAsync

        public final com.google.api.gax.longrunning.OperationFuture<Runtime,​OperationMetadata> switchRuntimeAsync​(String name)
        Switch a Managed Notebook Runtime.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   String name = "name3373707";
   Runtime response = managedNotebookServiceClient.switchRuntimeAsync(name).get();
 }
        Parameters:
        name - Required. Format: `projects/{project_id}/locations/{location}/runtimes/{runtime_id}`
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • switchRuntimeAsync

        public final com.google.api.gax.longrunning.OperationFuture<Runtime,​OperationMetadata> switchRuntimeAsync​(SwitchRuntimeRequest request)
        Switch a Managed Notebook Runtime.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   SwitchRuntimeRequest request =
       SwitchRuntimeRequest.newBuilder()
           .setName("name3373707")
           .setMachineType("machineType-218117087")
           .setAcceleratorConfig(RuntimeAcceleratorConfig.newBuilder().build())
           .setRequestId("requestId693933066")
           .build();
   Runtime response = managedNotebookServiceClient.switchRuntimeAsync(request).get();
 }
        Parameters:
        request - The request object containing all of the parameters for the API call.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • switchRuntimeOperationCallable

        public final com.google.api.gax.rpc.OperationCallable<SwitchRuntimeRequest,​Runtime,​OperationMetadata> switchRuntimeOperationCallable()
        Switch a Managed Notebook Runtime.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   SwitchRuntimeRequest request =
       SwitchRuntimeRequest.newBuilder()
           .setName("name3373707")
           .setMachineType("machineType-218117087")
           .setAcceleratorConfig(RuntimeAcceleratorConfig.newBuilder().build())
           .setRequestId("requestId693933066")
           .build();
   OperationFuture<Runtime, OperationMetadata> future =
       managedNotebookServiceClient.switchRuntimeOperationCallable().futureCall(request);
   // Do something.
   Runtime response = future.get();
 }

      • switchRuntimeCallable

        public final com.google.api.gax.rpc.UnaryCallable<SwitchRuntimeRequest,​com.google.longrunning.Operation> switchRuntimeCallable()
        Switch a Managed Notebook Runtime.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   SwitchRuntimeRequest request =
       SwitchRuntimeRequest.newBuilder()
           .setName("name3373707")
           .setMachineType("machineType-218117087")
           .setAcceleratorConfig(RuntimeAcceleratorConfig.newBuilder().build())
           .setRequestId("requestId693933066")
           .build();
   ApiFuture<Operation> future =
       managedNotebookServiceClient.switchRuntimeCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }

      • resetRuntimeAsync

        public final com.google.api.gax.longrunning.OperationFuture<Runtime,​OperationMetadata> resetRuntimeAsync​(String name)
        Resets a Managed Notebook Runtime.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   String name = "name3373707";
   Runtime response = managedNotebookServiceClient.resetRuntimeAsync(name).get();
 }
        Parameters:
        name - Required. Format: `projects/{project_id}/locations/{location}/runtimes/{runtime_id}`
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • resetRuntimeAsync

        public final com.google.api.gax.longrunning.OperationFuture<Runtime,​OperationMetadata> resetRuntimeAsync​(ResetRuntimeRequest request)
        Resets a Managed Notebook Runtime.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   ResetRuntimeRequest request =
       ResetRuntimeRequest.newBuilder()
           .setName("name3373707")
           .setRequestId("requestId693933066")
           .build();
   Runtime response = managedNotebookServiceClient.resetRuntimeAsync(request).get();
 }
        Parameters:
        request - The request object containing all of the parameters for the API call.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • resetRuntimeOperationCallable

        public final com.google.api.gax.rpc.OperationCallable<ResetRuntimeRequest,​Runtime,​OperationMetadata> resetRuntimeOperationCallable()
        Resets a Managed Notebook Runtime.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   ResetRuntimeRequest request =
       ResetRuntimeRequest.newBuilder()
           .setName("name3373707")
           .setRequestId("requestId693933066")
           .build();
   OperationFuture<Runtime, OperationMetadata> future =
       managedNotebookServiceClient.resetRuntimeOperationCallable().futureCall(request);
   // Do something.
   Runtime response = future.get();
 }

      • resetRuntimeCallable

        public final com.google.api.gax.rpc.UnaryCallable<ResetRuntimeRequest,​com.google.longrunning.Operation> resetRuntimeCallable()
        Resets a Managed Notebook Runtime.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   ResetRuntimeRequest request =
       ResetRuntimeRequest.newBuilder()
           .setName("name3373707")
           .setRequestId("requestId693933066")
           .build();
   ApiFuture<Operation> future =
       managedNotebookServiceClient.resetRuntimeCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }

      • upgradeRuntimeAsync

        public final com.google.api.gax.longrunning.OperationFuture<Runtime,​OperationMetadata> upgradeRuntimeAsync​(String name)
        Upgrades a Managed Notebook Runtime to the latest version.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   String name = "name3373707";
   Runtime response = managedNotebookServiceClient.upgradeRuntimeAsync(name).get();
 }
        Parameters:
        name - Required. Format: `projects/{project_id}/locations/{location}/runtimes/{runtime_id}`
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • upgradeRuntimeAsync

        public final com.google.api.gax.longrunning.OperationFuture<Runtime,​OperationMetadata> upgradeRuntimeAsync​(UpgradeRuntimeRequest request)
        Upgrades a Managed Notebook Runtime to the latest version.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   UpgradeRuntimeRequest request =
       UpgradeRuntimeRequest.newBuilder()
           .setName("name3373707")
           .setRequestId("requestId693933066")
           .build();
   Runtime response = managedNotebookServiceClient.upgradeRuntimeAsync(request).get();
 }
        Parameters:
        request - The request object containing all of the parameters for the API call.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • upgradeRuntimeOperationCallable

        public final com.google.api.gax.rpc.OperationCallable<UpgradeRuntimeRequest,​Runtime,​OperationMetadata> upgradeRuntimeOperationCallable()
        Upgrades a Managed Notebook Runtime to the latest version.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   UpgradeRuntimeRequest request =
       UpgradeRuntimeRequest.newBuilder()
           .setName("name3373707")
           .setRequestId("requestId693933066")
           .build();
   OperationFuture<Runtime, OperationMetadata> future =
       managedNotebookServiceClient.upgradeRuntimeOperationCallable().futureCall(request);
   // Do something.
   Runtime response = future.get();
 }

      • upgradeRuntimeCallable

        public final com.google.api.gax.rpc.UnaryCallable<UpgradeRuntimeRequest,​com.google.longrunning.Operation> upgradeRuntimeCallable()
        Upgrades a Managed Notebook Runtime to the latest version.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   UpgradeRuntimeRequest request =
       UpgradeRuntimeRequest.newBuilder()
           .setName("name3373707")
           .setRequestId("requestId693933066")
           .build();
   ApiFuture<Operation> future =
       managedNotebookServiceClient.upgradeRuntimeCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }

      • reportRuntimeEventAsync

        public final com.google.api.gax.longrunning.OperationFuture<Runtime,​OperationMetadata> reportRuntimeEventAsync​(RuntimeName name)
        Report and process a runtime event.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   RuntimeName name = RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]");
   Runtime response = managedNotebookServiceClient.reportRuntimeEventAsync(name).get();
 }
        Parameters:
        name - Required. Format: `projects/{project_id}/locations/{location}/runtimes/{runtime_id}`
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • reportRuntimeEventAsync

        public final com.google.api.gax.longrunning.OperationFuture<Runtime,​OperationMetadata> reportRuntimeEventAsync​(String name)
        Report and process a runtime event.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   String name = RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString();
   Runtime response = managedNotebookServiceClient.reportRuntimeEventAsync(name).get();
 }
        Parameters:
        name - Required. Format: `projects/{project_id}/locations/{location}/runtimes/{runtime_id}`
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • reportRuntimeEventAsync

        public final com.google.api.gax.longrunning.OperationFuture<Runtime,​OperationMetadata> reportRuntimeEventAsync​(ReportRuntimeEventRequest request)
        Report and process a runtime event.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   ReportRuntimeEventRequest request =
       ReportRuntimeEventRequest.newBuilder()
           .setName(RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString())
           .setVmId("vmId3622450")
           .setEvent(Event.newBuilder().build())
           .build();
   Runtime response = managedNotebookServiceClient.reportRuntimeEventAsync(request).get();
 }
        Parameters:
        request - The request object containing all of the parameters for the API call.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • reportRuntimeEventOperationCallable

        public final com.google.api.gax.rpc.OperationCallable<ReportRuntimeEventRequest,​Runtime,​OperationMetadata> reportRuntimeEventOperationCallable()
        Report and process a runtime event.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   ReportRuntimeEventRequest request =
       ReportRuntimeEventRequest.newBuilder()
           .setName(RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString())
           .setVmId("vmId3622450")
           .setEvent(Event.newBuilder().build())
           .build();
   OperationFuture<Runtime, OperationMetadata> future =
       managedNotebookServiceClient.reportRuntimeEventOperationCallable().futureCall(request);
   // Do something.
   Runtime response = future.get();
 }

      • reportRuntimeEventCallable

        public final com.google.api.gax.rpc.UnaryCallable<ReportRuntimeEventRequest,​com.google.longrunning.Operation> reportRuntimeEventCallable()
        Report and process a runtime event.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   ReportRuntimeEventRequest request =
       ReportRuntimeEventRequest.newBuilder()
           .setName(RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString())
           .setVmId("vmId3622450")
           .setEvent(Event.newBuilder().build())
           .build();
   ApiFuture<Operation> future =
       managedNotebookServiceClient.reportRuntimeEventCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }

      • refreshRuntimeTokenInternal

        public final RefreshRuntimeTokenInternalResponse refreshRuntimeTokenInternal​(RuntimeName name,
                                                                             String vmId)
        Gets an access token for the consumer service account that the customer attached to the runtime. Only accessible from the tenant instance.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   RuntimeName name = RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]");
   String vmId = "vmId3622450";
   RefreshRuntimeTokenInternalResponse response =
       managedNotebookServiceClient.refreshRuntimeTokenInternal(name, vmId);
 }
        Parameters:
        name - Required. Format: `projects/{project_id}/locations/{location}/runtimes/{runtime_id}`
        vmId - Required. The VM hardware token for authenticating the VM. https://cloud.google.com/compute/docs/instances/verifying-instance-identity
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • refreshRuntimeTokenInternal

        public final RefreshRuntimeTokenInternalResponse refreshRuntimeTokenInternal​(String name,
                                                                             String vmId)
        Gets an access token for the consumer service account that the customer attached to the runtime. Only accessible from the tenant instance.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   String name = RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString();
   String vmId = "vmId3622450";
   RefreshRuntimeTokenInternalResponse response =
       managedNotebookServiceClient.refreshRuntimeTokenInternal(name, vmId);
 }
        Parameters:
        name - Required. Format: `projects/{project_id}/locations/{location}/runtimes/{runtime_id}`
        vmId - Required. The VM hardware token for authenticating the VM. https://cloud.google.com/compute/docs/instances/verifying-instance-identity
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • refreshRuntimeTokenInternal

        public final RefreshRuntimeTokenInternalResponse refreshRuntimeTokenInternal​(RefreshRuntimeTokenInternalRequest request)
        Gets an access token for the consumer service account that the customer attached to the runtime. Only accessible from the tenant instance.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   RefreshRuntimeTokenInternalRequest request =
       RefreshRuntimeTokenInternalRequest.newBuilder()
           .setName(RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString())
           .setVmId("vmId3622450")
           .build();
   RefreshRuntimeTokenInternalResponse response =
       managedNotebookServiceClient.refreshRuntimeTokenInternal(request);
 }
        Parameters:
        request - The request object containing all of the parameters for the API call.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • refreshRuntimeTokenInternalCallable

        public final com.google.api.gax.rpc.UnaryCallable<RefreshRuntimeTokenInternalRequest,​RefreshRuntimeTokenInternalResponse> refreshRuntimeTokenInternalCallable()
        Gets an access token for the consumer service account that the customer attached to the runtime. Only accessible from the tenant instance.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   RefreshRuntimeTokenInternalRequest request =
       RefreshRuntimeTokenInternalRequest.newBuilder()
           .setName(RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString())
           .setVmId("vmId3622450")
           .build();
   ApiFuture<RefreshRuntimeTokenInternalResponse> future =
       managedNotebookServiceClient.refreshRuntimeTokenInternalCallable().futureCall(request);
   // Do something.
   RefreshRuntimeTokenInternalResponse response = future.get();
 }

      • diagnoseRuntimeAsync

        public final com.google.api.gax.longrunning.OperationFuture<Runtime,​OperationMetadata> diagnoseRuntimeAsync​(RuntimeName name,
                                                                                                                  DiagnosticConfig diagnosticConfig)
        Creates a Diagnostic File and runs Diagnostic Tool given a Runtime.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   RuntimeName name = RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]");
   DiagnosticConfig diagnosticConfig = DiagnosticConfig.newBuilder().build();
   Runtime response =
       managedNotebookServiceClient.diagnoseRuntimeAsync(name, diagnosticConfig).get();
 }
        Parameters:
        name - Required. Format: `projects/{project_id}/locations/{location}/runtimes/{runtimes_id}`
        diagnosticConfig - Required. Defines flags that are used to run the diagnostic tool
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • diagnoseRuntimeAsync

        public final com.google.api.gax.longrunning.OperationFuture<Runtime,​OperationMetadata> diagnoseRuntimeAsync​(String name,
                                                                                                                  DiagnosticConfig diagnosticConfig)
        Creates a Diagnostic File and runs Diagnostic Tool given a Runtime.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   String name = RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString();
   DiagnosticConfig diagnosticConfig = DiagnosticConfig.newBuilder().build();
   Runtime response =
       managedNotebookServiceClient.diagnoseRuntimeAsync(name, diagnosticConfig).get();
 }
        Parameters:
        name - Required. Format: `projects/{project_id}/locations/{location}/runtimes/{runtimes_id}`
        diagnosticConfig - Required. Defines flags that are used to run the diagnostic tool
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • diagnoseRuntimeAsync

        public final com.google.api.gax.longrunning.OperationFuture<Runtime,​OperationMetadata> diagnoseRuntimeAsync​(DiagnoseRuntimeRequest request)
        Creates a Diagnostic File and runs Diagnostic Tool given a Runtime.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   DiagnoseRuntimeRequest request =
       DiagnoseRuntimeRequest.newBuilder()
           .setName(RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString())
           .setDiagnosticConfig(DiagnosticConfig.newBuilder().build())
           .build();
   Runtime response = managedNotebookServiceClient.diagnoseRuntimeAsync(request).get();
 }
        Parameters:
        request - The request object containing all of the parameters for the API call.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • diagnoseRuntimeOperationCallable

        public final com.google.api.gax.rpc.OperationCallable<DiagnoseRuntimeRequest,​Runtime,​OperationMetadata> diagnoseRuntimeOperationCallable()
        Creates a Diagnostic File and runs Diagnostic Tool given a Runtime.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   DiagnoseRuntimeRequest request =
       DiagnoseRuntimeRequest.newBuilder()
           .setName(RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString())
           .setDiagnosticConfig(DiagnosticConfig.newBuilder().build())
           .build();
   OperationFuture<Runtime, OperationMetadata> future =
       managedNotebookServiceClient.diagnoseRuntimeOperationCallable().futureCall(request);
   // Do something.
   Runtime response = future.get();
 }

      • diagnoseRuntimeCallable

        public final com.google.api.gax.rpc.UnaryCallable<DiagnoseRuntimeRequest,​com.google.longrunning.Operation> diagnoseRuntimeCallable()
        Creates a Diagnostic File and runs Diagnostic Tool given a Runtime.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   DiagnoseRuntimeRequest request =
       DiagnoseRuntimeRequest.newBuilder()
           .setName(RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString())
           .setDiagnosticConfig(DiagnosticConfig.newBuilder().build())
           .build();
   ApiFuture<Operation> future =
       managedNotebookServiceClient.diagnoseRuntimeCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }

      • listLocations

        public final ManagedNotebookServiceClient.ListLocationsPagedResponse listLocations​(com.google.cloud.location.ListLocationsRequest request)
        Lists information about the supported locations for this service.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   ListLocationsRequest request =
       ListLocationsRequest.newBuilder()
           .setName("name3373707")
           .setFilter("filter-1274492040")
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   for (Location element : managedNotebookServiceClient.listLocations(request).iterateAll()) {
     // doThingsWith(element);
   }
 }
        Parameters:
        request - The request object containing all of the parameters for the API call.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • listLocationsPagedCallable

        public final com.google.api.gax.rpc.UnaryCallable<com.google.cloud.location.ListLocationsRequest,​ManagedNotebookServiceClient.ListLocationsPagedResponse> listLocationsPagedCallable()
        Lists information about the supported locations for this service.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   ListLocationsRequest request =
       ListLocationsRequest.newBuilder()
           .setName("name3373707")
           .setFilter("filter-1274492040")
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   ApiFuture<Location> future =
       managedNotebookServiceClient.listLocationsPagedCallable().futureCall(request);
   // Do something.
   for (Location element : future.get().iterateAll()) {
     // doThingsWith(element);
   }
 }

      • listLocationsCallable

        public final com.google.api.gax.rpc.UnaryCallable<com.google.cloud.location.ListLocationsRequest,​com.google.cloud.location.ListLocationsResponse> listLocationsCallable()
        Lists information about the supported locations for this service.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   ListLocationsRequest request =
       ListLocationsRequest.newBuilder()
           .setName("name3373707")
           .setFilter("filter-1274492040")
           .setPageSize(883849137)
           .setPageToken("pageToken873572522")
           .build();
   while (true) {
     ListLocationsResponse response =
         managedNotebookServiceClient.listLocationsCallable().call(request);
     for (Location element : response.getLocationsList()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }

      • getLocation

        public final com.google.cloud.location.Location getLocation​(com.google.cloud.location.GetLocationRequest request)
        Gets information about a 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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   GetLocationRequest request = GetLocationRequest.newBuilder().setName("name3373707").build();
   Location response = managedNotebookServiceClient.getLocation(request);
 }
        Parameters:
        request - The request object containing all of the parameters for the API call.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • getLocationCallable

        public final com.google.api.gax.rpc.UnaryCallable<com.google.cloud.location.GetLocationRequest,​com.google.cloud.location.Location> getLocationCallable()
        Gets information about a 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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   GetLocationRequest request = GetLocationRequest.newBuilder().setName("name3373707").build();
   ApiFuture<Location> future =
       managedNotebookServiceClient.getLocationCallable().futureCall(request);
   // Do something.
   Location response = future.get();
 }

      • setIamPolicy

        public final com.google.iam.v1.Policy setIamPolicy​(com.google.iam.v1.SetIamPolicyRequest request)
        Sets the access control policy on the specified resource. Replacesany existing policy.

        Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED`errors.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   SetIamPolicyRequest request =
       SetIamPolicyRequest.newBuilder()
           .setResource(RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString())
           .setPolicy(Policy.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .build();
   Policy response = managedNotebookServiceClient.setIamPolicy(request);
 }
        Parameters:
        request - The request object containing all of the parameters for the API call.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • setIamPolicyCallable

        public final com.google.api.gax.rpc.UnaryCallable<com.google.iam.v1.SetIamPolicyRequest,​com.google.iam.v1.Policy> setIamPolicyCallable()
        Sets the access control policy on the specified resource. Replacesany existing policy.

        Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED`errors.

        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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   SetIamPolicyRequest request =
       SetIamPolicyRequest.newBuilder()
           .setResource(RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString())
           .setPolicy(Policy.newBuilder().build())
           .setUpdateMask(FieldMask.newBuilder().build())
           .build();
   ApiFuture<Policy> future =
       managedNotebookServiceClient.setIamPolicyCallable().futureCall(request);
   // Do something.
   Policy response = future.get();
 }

      • getIamPolicy

        public final com.google.iam.v1.Policy getIamPolicy​(com.google.iam.v1.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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   GetIamPolicyRequest request =
       GetIamPolicyRequest.newBuilder()
           .setResource(RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString())
           .setOptions(GetPolicyOptions.newBuilder().build())
           .build();
   Policy response = managedNotebookServiceClient.getIamPolicy(request);
 }
        Parameters:
        request - The request object containing all of the parameters for the API call.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • getIamPolicyCallable

        public final com.google.api.gax.rpc.UnaryCallable<com.google.iam.v1.GetIamPolicyRequest,​com.google.iam.v1.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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   GetIamPolicyRequest request =
       GetIamPolicyRequest.newBuilder()
           .setResource(RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString())
           .setOptions(GetPolicyOptions.newBuilder().build())
           .build();
   ApiFuture<Policy> future =
       managedNotebookServiceClient.getIamPolicyCallable().futureCall(request);
   // Do something.
   Policy response = future.get();
 }

      • testIamPermissions

        public final com.google.iam.v1.TestIamPermissionsResponse testIamPermissions​(com.google.iam.v1.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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   TestIamPermissionsRequest request =
       TestIamPermissionsRequest.newBuilder()
           .setResource(RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString())
           .addAllPermissions(new ArrayList<String>())
           .build();
   TestIamPermissionsResponse response =
       managedNotebookServiceClient.testIamPermissions(request);
 }
        Parameters:
        request - The request object containing all of the parameters for the API call.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails

      • testIamPermissionsCallable

        public final com.google.api.gax.rpc.UnaryCallable<com.google.iam.v1.TestIamPermissionsRequest,​com.google.iam.v1.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 (ManagedNotebookServiceClient managedNotebookServiceClient =
     ManagedNotebookServiceClient.create()) {
   TestIamPermissionsRequest request =
       TestIamPermissionsRequest.newBuilder()
           .setResource(RuntimeName.of("[PROJECT]", "[LOCATION]", "[RUNTIME]").toString())
           .addAllPermissions(new ArrayList<String>())
           .build();
   ApiFuture<TestIamPermissionsResponse> future =
       managedNotebookServiceClient.testIamPermissionsCallable().futureCall(request);
   // Do something.
   TestIamPermissionsResponse response = future.get();
 }

      • shutdown

        public void shutdown()
        Specified by:
        shutdown in interface com.google.api.gax.core.BackgroundResource

      • isShutdown

        public boolean isShutdown()
        Specified by:
        isShutdown in interface com.google.api.gax.core.BackgroundResource

      • isTerminated

        public boolean isTerminated()
        Specified by:
        isTerminated in interface com.google.api.gax.core.BackgroundResource

      • shutdownNow

        public void shutdownNow()
        Specified by:
        shutdownNow in interface com.google.api.gax.core.BackgroundResource