Class InstanceAdminClient

  • All Implemented Interfaces:
    com.google.api.gax.core.BackgroundResource, AutoCloseable

    @Generated("by gapic-generator-java")
    public class InstanceAdminClient
    extends Object
    implements com.google.api.gax.core.BackgroundResource
    Service Description: Cloud Spanner Instance Admin API

    The Cloud Spanner Instance Admin API can be used to create, delete, modify and list instances. Instances are dedicated Cloud Spanner serving and storage resources to be used by Cloud Spanner databases.

    Each instance has a "configuration", which dictates where the serving resources for the Cloud Spanner instance are located (e.g., US-central, Europe). Configurations are created by Google based on resource availability.

    Cloud Spanner billing is based on the instances that exist and their sizes. After an instance exists, there are no additional per-database or per-operation charges for use of the instance (though there may be additional network bandwidth charges). Instances offer isolation: problems with databases in one instance will not affect other instances. However, within an instance databases can affect each other. For example, if one database in an instance receives a lot of requests and consumes most of the instance resources, fewer resources are available for other databases in that instance, and their performance may suffer.

    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 for illustrative purposes only.
     // It may require modifications to work in your environment.
     try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
       InstanceConfigName name = InstanceConfigName.of("[PROJECT]", "[INSTANCE_CONFIG]");
       InstanceConfig response = instanceAdminClient.getInstanceConfig(name);
     }
     

    Note: close() needs to be called on the InstanceAdminClient 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 InstanceAdminSettings to create(). For example:

    To customize credentials:

    
     // This snippet has been automatically generated for illustrative purposes only.
     // It may require modifications to work in your environment.
     InstanceAdminSettings instanceAdminSettings =
         InstanceAdminSettings.newBuilder()
             .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
             .build();
     InstanceAdminClient instanceAdminClient = InstanceAdminClient.create(instanceAdminSettings);
     

    To customize the endpoint:

    
     // This snippet has been automatically generated for illustrative purposes only.
     // It may require modifications to work in your environment.
     InstanceAdminSettings instanceAdminSettings =
         InstanceAdminSettings.newBuilder().setEndpoint(myEndpoint).build();
     InstanceAdminClient instanceAdminClient = InstanceAdminClient.create(instanceAdminSettings);
     

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

    
     // This snippet has been automatically generated for illustrative purposes only.
     // It may require modifications to work in your environment.
     InstanceAdminSettings instanceAdminSettings =
         InstanceAdminSettings.newBuilder()
             .setTransportChannelProvider(
                 InstanceAdminSettings.defaultHttpJsonTransportProviderBuilder().build())
             .build();
     InstanceAdminClient instanceAdminClient = InstanceAdminClient.create(instanceAdminSettings);
     

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

    • Constructor Detail

      • InstanceAdminClient

        protected InstanceAdminClient​(InstanceAdminSettings settings)
                               throws IOException
        Constructs an instance of InstanceAdminClient, 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 InstanceAdminClient create​(InstanceAdminSettings settings)
                                                throws IOException
        Constructs an instance of InstanceAdminClient, using the given settings. The channels are created based on the settings passed in, or defaults for any settings that are not set.
        Throws:
        IOException
      • create

        public static final InstanceAdminClient create​(InstanceAdminStub stub)
        Constructs an instance of InstanceAdminClient, using the given stub for making calls. This is for advanced usage - prefer using create(InstanceAdminSettings).
      • 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.
      • getHttpJsonOperationsClient

        @BetaApi
        public final com.google.api.gax.httpjson.longrunning.OperationsClient getHttpJsonOperationsClient()
        Returns the OperationsClient that can be used to query the status of a long-running operation returned by another API method call.
      • listInstanceConfigs

        public final InstanceAdminClient.ListInstanceConfigsPagedResponse listInstanceConfigs​(ProjectName parent)
        Lists the supported instance configurations for a given project.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           ProjectName parent = ProjectName.of("[PROJECT]");
           for (InstanceConfig element : instanceAdminClient.listInstanceConfigs(parent).iterateAll()) {
             // doThingsWith(element);
           }
         }
         
        Parameters:
        parent - Required. The name of the project for which a list of supported instance configurations is requested. Values are of the form `projects/<project>`.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails
      • listInstanceConfigs

        public final InstanceAdminClient.ListInstanceConfigsPagedResponse listInstanceConfigs​(String parent)
        Lists the supported instance configurations for a given project.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           String parent = ProjectName.of("[PROJECT]").toString();
           for (InstanceConfig element : instanceAdminClient.listInstanceConfigs(parent).iterateAll()) {
             // doThingsWith(element);
           }
         }
         
        Parameters:
        parent - Required. The name of the project for which a list of supported instance configurations is requested. Values are of the form `projects/<project>`.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails
      • listInstanceConfigs

        public final InstanceAdminClient.ListInstanceConfigsPagedResponse listInstanceConfigs​(ListInstanceConfigsRequest request)
        Lists the supported instance configurations for a given project.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           ListInstanceConfigsRequest request =
               ListInstanceConfigsRequest.newBuilder()
                   .setParent(ProjectName.of("[PROJECT]").toString())
                   .setPageSize(883849137)
                   .setPageToken("pageToken873572522")
                   .build();
           for (InstanceConfig element : instanceAdminClient.listInstanceConfigs(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
      • listInstanceConfigsPagedCallable

        public final com.google.api.gax.rpc.UnaryCallable<ListInstanceConfigsRequest,​InstanceAdminClient.ListInstanceConfigsPagedResponse> listInstanceConfigsPagedCallable()
        Lists the supported instance configurations for a given project.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           ListInstanceConfigsRequest request =
               ListInstanceConfigsRequest.newBuilder()
                   .setParent(ProjectName.of("[PROJECT]").toString())
                   .setPageSize(883849137)
                   .setPageToken("pageToken873572522")
                   .build();
           ApiFuture<InstanceConfig> future =
               instanceAdminClient.listInstanceConfigsPagedCallable().futureCall(request);
           // Do something.
           for (InstanceConfig element : future.get().iterateAll()) {
             // doThingsWith(element);
           }
         }
         
      • listInstanceConfigsCallable

        public final com.google.api.gax.rpc.UnaryCallable<ListInstanceConfigsRequest,​ListInstanceConfigsResponse> listInstanceConfigsCallable()
        Lists the supported instance configurations for a given project.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           ListInstanceConfigsRequest request =
               ListInstanceConfigsRequest.newBuilder()
                   .setParent(ProjectName.of("[PROJECT]").toString())
                   .setPageSize(883849137)
                   .setPageToken("pageToken873572522")
                   .build();
           while (true) {
             ListInstanceConfigsResponse response =
                 instanceAdminClient.listInstanceConfigsCallable().call(request);
             for (InstanceConfig element : response.getInstanceConfigsList()) {
               // doThingsWith(element);
             }
             String nextPageToken = response.getNextPageToken();
             if (!Strings.isNullOrEmpty(nextPageToken)) {
               request = request.toBuilder().setPageToken(nextPageToken).build();
             } else {
               break;
             }
           }
         }
         
      • getInstanceConfig

        public final InstanceConfig getInstanceConfig​(InstanceConfigName name)
        Gets information about a particular instance configuration.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           InstanceConfigName name = InstanceConfigName.of("[PROJECT]", "[INSTANCE_CONFIG]");
           InstanceConfig response = instanceAdminClient.getInstanceConfig(name);
         }
         
        Parameters:
        name - Required. The name of the requested instance configuration. Values are of the form `projects/<project>/instanceConfigs/<config>`.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails
      • getInstanceConfig

        public final InstanceConfig getInstanceConfig​(String name)
        Gets information about a particular instance configuration.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           String name = InstanceConfigName.of("[PROJECT]", "[INSTANCE_CONFIG]").toString();
           InstanceConfig response = instanceAdminClient.getInstanceConfig(name);
         }
         
        Parameters:
        name - Required. The name of the requested instance configuration. Values are of the form `projects/<project>/instanceConfigs/<config>`.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails
      • getInstanceConfig

        public final InstanceConfig getInstanceConfig​(GetInstanceConfigRequest request)
        Gets information about a particular instance configuration.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           GetInstanceConfigRequest request =
               GetInstanceConfigRequest.newBuilder()
                   .setName(InstanceConfigName.of("[PROJECT]", "[INSTANCE_CONFIG]").toString())
                   .build();
           InstanceConfig response = instanceAdminClient.getInstanceConfig(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
      • getInstanceConfigCallable

        public final com.google.api.gax.rpc.UnaryCallable<GetInstanceConfigRequest,​InstanceConfig> getInstanceConfigCallable()
        Gets information about a particular instance configuration.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           GetInstanceConfigRequest request =
               GetInstanceConfigRequest.newBuilder()
                   .setName(InstanceConfigName.of("[PROJECT]", "[INSTANCE_CONFIG]").toString())
                   .build();
           ApiFuture<InstanceConfig> future =
               instanceAdminClient.getInstanceConfigCallable().futureCall(request);
           // Do something.
           InstanceConfig response = future.get();
         }
         
      • listInstances

        public final InstanceAdminClient.ListInstancesPagedResponse listInstances​(ProjectName parent)
        Lists all instances in the given project.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           ProjectName parent = ProjectName.of("[PROJECT]");
           for (Instance element : instanceAdminClient.listInstances(parent).iterateAll()) {
             // doThingsWith(element);
           }
         }
         
        Parameters:
        parent - Required. The name of the project for which a list of instances is requested. Values are of the form `projects/<project>`.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails
      • listInstances

        public final InstanceAdminClient.ListInstancesPagedResponse listInstances​(String parent)
        Lists all instances in the given project.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           String parent = ProjectName.of("[PROJECT]").toString();
           for (Instance element : instanceAdminClient.listInstances(parent).iterateAll()) {
             // doThingsWith(element);
           }
         }
         
        Parameters:
        parent - Required. The name of the project for which a list of instances is requested. Values are of the form `projects/<project>`.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails
      • listInstances

        public final InstanceAdminClient.ListInstancesPagedResponse listInstances​(ListInstancesRequest request)
        Lists all instances in the given project.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           ListInstancesRequest request =
               ListInstancesRequest.newBuilder()
                   .setParent(ProjectName.of("[PROJECT]").toString())
                   .setPageSize(883849137)
                   .setPageToken("pageToken873572522")
                   .setFilter("filter-1274492040")
                   .build();
           for (Instance element : instanceAdminClient.listInstances(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
      • listInstancesPagedCallable

        public final com.google.api.gax.rpc.UnaryCallable<ListInstancesRequest,​InstanceAdminClient.ListInstancesPagedResponse> listInstancesPagedCallable()
        Lists all instances in the given project.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           ListInstancesRequest request =
               ListInstancesRequest.newBuilder()
                   .setParent(ProjectName.of("[PROJECT]").toString())
                   .setPageSize(883849137)
                   .setPageToken("pageToken873572522")
                   .setFilter("filter-1274492040")
                   .build();
           ApiFuture<Instance> future =
               instanceAdminClient.listInstancesPagedCallable().futureCall(request);
           // Do something.
           for (Instance element : future.get().iterateAll()) {
             // doThingsWith(element);
           }
         }
         
      • listInstancesCallable

        public final com.google.api.gax.rpc.UnaryCallable<ListInstancesRequest,​ListInstancesResponse> listInstancesCallable()
        Lists all instances in the given project.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           ListInstancesRequest request =
               ListInstancesRequest.newBuilder()
                   .setParent(ProjectName.of("[PROJECT]").toString())
                   .setPageSize(883849137)
                   .setPageToken("pageToken873572522")
                   .setFilter("filter-1274492040")
                   .build();
           while (true) {
             ListInstancesResponse response = instanceAdminClient.listInstancesCallable().call(request);
             for (Instance element : response.getInstancesList()) {
               // doThingsWith(element);
             }
             String nextPageToken = response.getNextPageToken();
             if (!Strings.isNullOrEmpty(nextPageToken)) {
               request = request.toBuilder().setPageToken(nextPageToken).build();
             } else {
               break;
             }
           }
         }
         
      • getInstance

        public final Instance getInstance​(InstanceName name)
        Gets information about a particular instance.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           InstanceName name = InstanceName.of("[PROJECT]", "[INSTANCE]");
           Instance response = instanceAdminClient.getInstance(name);
         }
         
        Parameters:
        name - Required. The name of the requested instance. Values are of the form `projects/<project>/instances/<instance>`.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails
      • getInstance

        public final Instance getInstance​(String name)
        Gets information about a particular instance.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           String name = InstanceName.of("[PROJECT]", "[INSTANCE]").toString();
           Instance response = instanceAdminClient.getInstance(name);
         }
         
        Parameters:
        name - Required. The name of the requested instance. Values are of the form `projects/<project>/instances/<instance>`.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails
      • getInstance

        public final Instance getInstance​(GetInstanceRequest request)
        Gets information about a particular instance.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           GetInstanceRequest request =
               GetInstanceRequest.newBuilder()
                   .setName(InstanceName.of("[PROJECT]", "[INSTANCE]").toString())
                   .setFieldMask(FieldMask.newBuilder().build())
                   .build();
           Instance response = instanceAdminClient.getInstance(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
      • getInstanceCallable

        public final com.google.api.gax.rpc.UnaryCallable<GetInstanceRequest,​Instance> getInstanceCallable()
        Gets information about a particular instance.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           GetInstanceRequest request =
               GetInstanceRequest.newBuilder()
                   .setName(InstanceName.of("[PROJECT]", "[INSTANCE]").toString())
                   .setFieldMask(FieldMask.newBuilder().build())
                   .build();
           ApiFuture<Instance> future = instanceAdminClient.getInstanceCallable().futureCall(request);
           // Do something.
           Instance response = future.get();
         }
         
      • createInstanceAsync

        public final com.google.api.gax.longrunning.OperationFuture<Instance,​CreateInstanceMetadata> createInstanceAsync​(ProjectName parent,
                                                                                                                               String instanceId,
                                                                                                                               Instance instance)
        Creates an instance and begins preparing it to begin serving. The returned [long-running operation][google.longrunning.Operation] can be used to track the progress of preparing the new instance. The instance name is assigned by the caller. If the named instance already exists, `CreateInstance` returns `ALREADY_EXISTS`.

        Immediately upon completion of this request:

        * The instance is readable via the API, with all requested attributes but no allocated resources. Its state is `CREATING`.

        Until completion of the returned operation:

        * Cancelling the operation renders the instance immediately unreadable via the API. * The instance can be deleted. * All other attempts to modify the instance are rejected.

        Upon completion of the returned operation:

        * Billing for all successfully-allocated resources begins (some types may have lower than the requested levels). * Databases can be created in the instance. * The instance's allocated resource levels are readable via the API. * The instance's state becomes `READY`.

        The returned [long-running operation][google.longrunning.Operation] will have a name of the format `<instance_name>/operations/<operation_id>` and can be used to track creation of the instance. The [metadata][google.longrunning.Operation.metadata] field type is [CreateInstanceMetadata][google.spanner.admin.instance.v1.CreateInstanceMetadata]. The [response][google.longrunning.Operation.response] field type is [Instance][google.spanner.admin.instance.v1.Instance], if successful.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           ProjectName parent = ProjectName.of("[PROJECT]");
           String instanceId = "instanceId902024336";
           Instance instance = Instance.newBuilder().build();
           Instance response =
               instanceAdminClient.createInstanceAsync(parent, instanceId, instance).get();
         }
         
        Parameters:
        parent - Required. The name of the project in which to create the instance. Values are of the form `projects/<project>`.
        instanceId - Required. The ID of the instance to create. Valid identifiers are of the form `[a-z][-a-z0-9]*[a-z0-9]` and must be between 2 and 64 characters in length.
        instance - Required. The instance to create. The name may be omitted, but if specified must be `<parent>/instances/<instance_id>`.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails
      • createInstanceAsync

        public final com.google.api.gax.longrunning.OperationFuture<Instance,​CreateInstanceMetadata> createInstanceAsync​(String parent,
                                                                                                                               String instanceId,
                                                                                                                               Instance instance)
        Creates an instance and begins preparing it to begin serving. The returned [long-running operation][google.longrunning.Operation] can be used to track the progress of preparing the new instance. The instance name is assigned by the caller. If the named instance already exists, `CreateInstance` returns `ALREADY_EXISTS`.

        Immediately upon completion of this request:

        * The instance is readable via the API, with all requested attributes but no allocated resources. Its state is `CREATING`.

        Until completion of the returned operation:

        * Cancelling the operation renders the instance immediately unreadable via the API. * The instance can be deleted. * All other attempts to modify the instance are rejected.

        Upon completion of the returned operation:

        * Billing for all successfully-allocated resources begins (some types may have lower than the requested levels). * Databases can be created in the instance. * The instance's allocated resource levels are readable via the API. * The instance's state becomes `READY`.

        The returned [long-running operation][google.longrunning.Operation] will have a name of the format `<instance_name>/operations/<operation_id>` and can be used to track creation of the instance. The [metadata][google.longrunning.Operation.metadata] field type is [CreateInstanceMetadata][google.spanner.admin.instance.v1.CreateInstanceMetadata]. The [response][google.longrunning.Operation.response] field type is [Instance][google.spanner.admin.instance.v1.Instance], if successful.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           String parent = ProjectName.of("[PROJECT]").toString();
           String instanceId = "instanceId902024336";
           Instance instance = Instance.newBuilder().build();
           Instance response =
               instanceAdminClient.createInstanceAsync(parent, instanceId, instance).get();
         }
         
        Parameters:
        parent - Required. The name of the project in which to create the instance. Values are of the form `projects/<project>`.
        instanceId - Required. The ID of the instance to create. Valid identifiers are of the form `[a-z][-a-z0-9]*[a-z0-9]` and must be between 2 and 64 characters in length.
        instance - Required. The instance to create. The name may be omitted, but if specified must be `<parent>/instances/<instance_id>`.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails
      • createInstanceAsync

        public final com.google.api.gax.longrunning.OperationFuture<Instance,​CreateInstanceMetadata> createInstanceAsync​(CreateInstanceRequest request)
        Creates an instance and begins preparing it to begin serving. The returned [long-running operation][google.longrunning.Operation] can be used to track the progress of preparing the new instance. The instance name is assigned by the caller. If the named instance already exists, `CreateInstance` returns `ALREADY_EXISTS`.

        Immediately upon completion of this request:

        * The instance is readable via the API, with all requested attributes but no allocated resources. Its state is `CREATING`.

        Until completion of the returned operation:

        * Cancelling the operation renders the instance immediately unreadable via the API. * The instance can be deleted. * All other attempts to modify the instance are rejected.

        Upon completion of the returned operation:

        * Billing for all successfully-allocated resources begins (some types may have lower than the requested levels). * Databases can be created in the instance. * The instance's allocated resource levels are readable via the API. * The instance's state becomes `READY`.

        The returned [long-running operation][google.longrunning.Operation] will have a name of the format `<instance_name>/operations/<operation_id>` and can be used to track creation of the instance. The [metadata][google.longrunning.Operation.metadata] field type is [CreateInstanceMetadata][google.spanner.admin.instance.v1.CreateInstanceMetadata]. The [response][google.longrunning.Operation.response] field type is [Instance][google.spanner.admin.instance.v1.Instance], if successful.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           CreateInstanceRequest request =
               CreateInstanceRequest.newBuilder()
                   .setParent(ProjectName.of("[PROJECT]").toString())
                   .setInstanceId("instanceId902024336")
                   .setInstance(Instance.newBuilder().build())
                   .build();
           Instance response = instanceAdminClient.createInstanceAsync(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
      • createInstanceOperationCallable

        public final com.google.api.gax.rpc.OperationCallable<CreateInstanceRequest,​Instance,​CreateInstanceMetadata> createInstanceOperationCallable()
        Creates an instance and begins preparing it to begin serving. The returned [long-running operation][google.longrunning.Operation] can be used to track the progress of preparing the new instance. The instance name is assigned by the caller. If the named instance already exists, `CreateInstance` returns `ALREADY_EXISTS`.

        Immediately upon completion of this request:

        * The instance is readable via the API, with all requested attributes but no allocated resources. Its state is `CREATING`.

        Until completion of the returned operation:

        * Cancelling the operation renders the instance immediately unreadable via the API. * The instance can be deleted. * All other attempts to modify the instance are rejected.

        Upon completion of the returned operation:

        * Billing for all successfully-allocated resources begins (some types may have lower than the requested levels). * Databases can be created in the instance. * The instance's allocated resource levels are readable via the API. * The instance's state becomes `READY`.

        The returned [long-running operation][google.longrunning.Operation] will have a name of the format `<instance_name>/operations/<operation_id>` and can be used to track creation of the instance. The [metadata][google.longrunning.Operation.metadata] field type is [CreateInstanceMetadata][google.spanner.admin.instance.v1.CreateInstanceMetadata]. The [response][google.longrunning.Operation.response] field type is [Instance][google.spanner.admin.instance.v1.Instance], if successful.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           CreateInstanceRequest request =
               CreateInstanceRequest.newBuilder()
                   .setParent(ProjectName.of("[PROJECT]").toString())
                   .setInstanceId("instanceId902024336")
                   .setInstance(Instance.newBuilder().build())
                   .build();
           OperationFuture<Instance, CreateInstanceMetadata> future =
               instanceAdminClient.createInstanceOperationCallable().futureCall(request);
           // Do something.
           Instance response = future.get();
         }
         
      • createInstanceCallable

        public final com.google.api.gax.rpc.UnaryCallable<CreateInstanceRequest,​com.google.longrunning.Operation> createInstanceCallable()
        Creates an instance and begins preparing it to begin serving. The returned [long-running operation][google.longrunning.Operation] can be used to track the progress of preparing the new instance. The instance name is assigned by the caller. If the named instance already exists, `CreateInstance` returns `ALREADY_EXISTS`.

        Immediately upon completion of this request:

        * The instance is readable via the API, with all requested attributes but no allocated resources. Its state is `CREATING`.

        Until completion of the returned operation:

        * Cancelling the operation renders the instance immediately unreadable via the API. * The instance can be deleted. * All other attempts to modify the instance are rejected.

        Upon completion of the returned operation:

        * Billing for all successfully-allocated resources begins (some types may have lower than the requested levels). * Databases can be created in the instance. * The instance's allocated resource levels are readable via the API. * The instance's state becomes `READY`.

        The returned [long-running operation][google.longrunning.Operation] will have a name of the format `<instance_name>/operations/<operation_id>` and can be used to track creation of the instance. The [metadata][google.longrunning.Operation.metadata] field type is [CreateInstanceMetadata][google.spanner.admin.instance.v1.CreateInstanceMetadata]. The [response][google.longrunning.Operation.response] field type is [Instance][google.spanner.admin.instance.v1.Instance], if successful.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           CreateInstanceRequest request =
               CreateInstanceRequest.newBuilder()
                   .setParent(ProjectName.of("[PROJECT]").toString())
                   .setInstanceId("instanceId902024336")
                   .setInstance(Instance.newBuilder().build())
                   .build();
           ApiFuture<Operation> future =
               instanceAdminClient.createInstanceCallable().futureCall(request);
           // Do something.
           Operation response = future.get();
         }
         
      • updateInstanceAsync

        public final com.google.api.gax.longrunning.OperationFuture<Instance,​UpdateInstanceMetadata> updateInstanceAsync​(Instance instance,
                                                                                                                               com.google.protobuf.FieldMask fieldMask)
        Updates an instance, and begins allocating or releasing resources as requested. The returned [long-running operation][google.longrunning.Operation] can be used to track the progress of updating the instance. If the named instance does not exist, returns `NOT_FOUND`.

        Immediately upon completion of this request:

        * For resource types for which a decrease in the instance's allocation has been requested, billing is based on the newly-requested level.

        Until completion of the returned operation:

        * Cancelling the operation sets its metadata's [cancel_time][google.spanner.admin.instance.v1.UpdateInstanceMetadata.cancel_time], and begins restoring resources to their pre-request values. The operation is guaranteed to succeed at undoing all resource changes, after which point it terminates with a `CANCELLED` status. * All other attempts to modify the instance are rejected. * Reading the instance via the API continues to give the pre-request resource levels.

        Upon completion of the returned operation:

        * Billing begins for all successfully-allocated resources (some types may have lower than the requested levels). * All newly-reserved resources are available for serving the instance's tables. * The instance's new resource levels are readable via the API.

        The returned [long-running operation][google.longrunning.Operation] will have a name of the format `<instance_name>/operations/<operation_id>` and can be used to track the instance modification. The [metadata][google.longrunning.Operation.metadata] field type is [UpdateInstanceMetadata][google.spanner.admin.instance.v1.UpdateInstanceMetadata]. The [response][google.longrunning.Operation.response] field type is [Instance][google.spanner.admin.instance.v1.Instance], if successful.

        Authorization requires `spanner.instances.update` permission on the resource [name][google.spanner.admin.instance.v1.Instance.name].

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           Instance instance = Instance.newBuilder().build();
           FieldMask fieldMask = FieldMask.newBuilder().build();
           Instance response = instanceAdminClient.updateInstanceAsync(instance, fieldMask).get();
         }
         
        Parameters:
        instance - Required. The instance to update, which must always include the instance name. Otherwise, only fields mentioned in [field_mask][google.spanner.admin.instance.v1.UpdateInstanceRequest.field_mask] need be included.
        fieldMask - Required. A mask specifying which fields in [Instance][google.spanner.admin.instance.v1.Instance] should be updated. The field mask must always be specified; this prevents any future fields in [Instance][google.spanner.admin.instance.v1.Instance] from being erased accidentally by clients that do not know about them.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails
      • updateInstanceAsync

        public final com.google.api.gax.longrunning.OperationFuture<Instance,​UpdateInstanceMetadata> updateInstanceAsync​(UpdateInstanceRequest request)
        Updates an instance, and begins allocating or releasing resources as requested. The returned [long-running operation][google.longrunning.Operation] can be used to track the progress of updating the instance. If the named instance does not exist, returns `NOT_FOUND`.

        Immediately upon completion of this request:

        * For resource types for which a decrease in the instance's allocation has been requested, billing is based on the newly-requested level.

        Until completion of the returned operation:

        * Cancelling the operation sets its metadata's [cancel_time][google.spanner.admin.instance.v1.UpdateInstanceMetadata.cancel_time], and begins restoring resources to their pre-request values. The operation is guaranteed to succeed at undoing all resource changes, after which point it terminates with a `CANCELLED` status. * All other attempts to modify the instance are rejected. * Reading the instance via the API continues to give the pre-request resource levels.

        Upon completion of the returned operation:

        * Billing begins for all successfully-allocated resources (some types may have lower than the requested levels). * All newly-reserved resources are available for serving the instance's tables. * The instance's new resource levels are readable via the API.

        The returned [long-running operation][google.longrunning.Operation] will have a name of the format `<instance_name>/operations/<operation_id>` and can be used to track the instance modification. The [metadata][google.longrunning.Operation.metadata] field type is [UpdateInstanceMetadata][google.spanner.admin.instance.v1.UpdateInstanceMetadata]. The [response][google.longrunning.Operation.response] field type is [Instance][google.spanner.admin.instance.v1.Instance], if successful.

        Authorization requires `spanner.instances.update` permission on the resource [name][google.spanner.admin.instance.v1.Instance.name].

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           UpdateInstanceRequest request =
               UpdateInstanceRequest.newBuilder()
                   .setInstance(Instance.newBuilder().build())
                   .setFieldMask(FieldMask.newBuilder().build())
                   .build();
           Instance response = instanceAdminClient.updateInstanceAsync(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
      • updateInstanceOperationCallable

        public final com.google.api.gax.rpc.OperationCallable<UpdateInstanceRequest,​Instance,​UpdateInstanceMetadata> updateInstanceOperationCallable()
        Updates an instance, and begins allocating or releasing resources as requested. The returned [long-running operation][google.longrunning.Operation] can be used to track the progress of updating the instance. If the named instance does not exist, returns `NOT_FOUND`.

        Immediately upon completion of this request:

        * For resource types for which a decrease in the instance's allocation has been requested, billing is based on the newly-requested level.

        Until completion of the returned operation:

        * Cancelling the operation sets its metadata's [cancel_time][google.spanner.admin.instance.v1.UpdateInstanceMetadata.cancel_time], and begins restoring resources to their pre-request values. The operation is guaranteed to succeed at undoing all resource changes, after which point it terminates with a `CANCELLED` status. * All other attempts to modify the instance are rejected. * Reading the instance via the API continues to give the pre-request resource levels.

        Upon completion of the returned operation:

        * Billing begins for all successfully-allocated resources (some types may have lower than the requested levels). * All newly-reserved resources are available for serving the instance's tables. * The instance's new resource levels are readable via the API.

        The returned [long-running operation][google.longrunning.Operation] will have a name of the format `<instance_name>/operations/<operation_id>` and can be used to track the instance modification. The [metadata][google.longrunning.Operation.metadata] field type is [UpdateInstanceMetadata][google.spanner.admin.instance.v1.UpdateInstanceMetadata]. The [response][google.longrunning.Operation.response] field type is [Instance][google.spanner.admin.instance.v1.Instance], if successful.

        Authorization requires `spanner.instances.update` permission on the resource [name][google.spanner.admin.instance.v1.Instance.name].

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           UpdateInstanceRequest request =
               UpdateInstanceRequest.newBuilder()
                   .setInstance(Instance.newBuilder().build())
                   .setFieldMask(FieldMask.newBuilder().build())
                   .build();
           OperationFuture<Instance, UpdateInstanceMetadata> future =
               instanceAdminClient.updateInstanceOperationCallable().futureCall(request);
           // Do something.
           Instance response = future.get();
         }
         
      • updateInstanceCallable

        public final com.google.api.gax.rpc.UnaryCallable<UpdateInstanceRequest,​com.google.longrunning.Operation> updateInstanceCallable()
        Updates an instance, and begins allocating or releasing resources as requested. The returned [long-running operation][google.longrunning.Operation] can be used to track the progress of updating the instance. If the named instance does not exist, returns `NOT_FOUND`.

        Immediately upon completion of this request:

        * For resource types for which a decrease in the instance's allocation has been requested, billing is based on the newly-requested level.

        Until completion of the returned operation:

        * Cancelling the operation sets its metadata's [cancel_time][google.spanner.admin.instance.v1.UpdateInstanceMetadata.cancel_time], and begins restoring resources to their pre-request values. The operation is guaranteed to succeed at undoing all resource changes, after which point it terminates with a `CANCELLED` status. * All other attempts to modify the instance are rejected. * Reading the instance via the API continues to give the pre-request resource levels.

        Upon completion of the returned operation:

        * Billing begins for all successfully-allocated resources (some types may have lower than the requested levels). * All newly-reserved resources are available for serving the instance's tables. * The instance's new resource levels are readable via the API.

        The returned [long-running operation][google.longrunning.Operation] will have a name of the format `<instance_name>/operations/<operation_id>` and can be used to track the instance modification. The [metadata][google.longrunning.Operation.metadata] field type is [UpdateInstanceMetadata][google.spanner.admin.instance.v1.UpdateInstanceMetadata]. The [response][google.longrunning.Operation.response] field type is [Instance][google.spanner.admin.instance.v1.Instance], if successful.

        Authorization requires `spanner.instances.update` permission on the resource [name][google.spanner.admin.instance.v1.Instance.name].

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           UpdateInstanceRequest request =
               UpdateInstanceRequest.newBuilder()
                   .setInstance(Instance.newBuilder().build())
                   .setFieldMask(FieldMask.newBuilder().build())
                   .build();
           ApiFuture<Operation> future =
               instanceAdminClient.updateInstanceCallable().futureCall(request);
           // Do something.
           Operation response = future.get();
         }
         
      • deleteInstance

        public final void deleteInstance​(InstanceName name)
        Deletes an instance.

        Immediately upon completion of the request:

        * Billing ceases for all of the instance's reserved resources.

        Soon afterward:

        * The instance and *all of its databases* immediately and irrevocably disappear from the API. All data in the databases is permanently deleted.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           InstanceName name = InstanceName.of("[PROJECT]", "[INSTANCE]");
           instanceAdminClient.deleteInstance(name);
         }
         
        Parameters:
        name - Required. The name of the instance to be deleted. Values are of the form `projects/<project>/instances/<instance>`
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails
      • deleteInstance

        public final void deleteInstance​(String name)
        Deletes an instance.

        Immediately upon completion of the request:

        * Billing ceases for all of the instance's reserved resources.

        Soon afterward:

        * The instance and *all of its databases* immediately and irrevocably disappear from the API. All data in the databases is permanently deleted.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           String name = InstanceName.of("[PROJECT]", "[INSTANCE]").toString();
           instanceAdminClient.deleteInstance(name);
         }
         
        Parameters:
        name - Required. The name of the instance to be deleted. Values are of the form `projects/<project>/instances/<instance>`
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails
      • deleteInstance

        public final void deleteInstance​(DeleteInstanceRequest request)
        Deletes an instance.

        Immediately upon completion of the request:

        * Billing ceases for all of the instance's reserved resources.

        Soon afterward:

        * The instance and *all of its databases* immediately and irrevocably disappear from the API. All data in the databases is permanently deleted.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           DeleteInstanceRequest request =
               DeleteInstanceRequest.newBuilder()
                   .setName(InstanceName.of("[PROJECT]", "[INSTANCE]").toString())
                   .build();
           instanceAdminClient.deleteInstance(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
      • deleteInstanceCallable

        public final com.google.api.gax.rpc.UnaryCallable<DeleteInstanceRequest,​com.google.protobuf.Empty> deleteInstanceCallable()
        Deletes an instance.

        Immediately upon completion of the request:

        * Billing ceases for all of the instance's reserved resources.

        Soon afterward:

        * The instance and *all of its databases* immediately and irrevocably disappear from the API. All data in the databases is permanently deleted.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           DeleteInstanceRequest request =
               DeleteInstanceRequest.newBuilder()
                   .setName(InstanceName.of("[PROJECT]", "[INSTANCE]").toString())
                   .build();
           ApiFuture<Empty> future = instanceAdminClient.deleteInstanceCallable().futureCall(request);
           // Do something.
           future.get();
         }
         
      • setIamPolicy

        public final com.google.iam.v1.Policy setIamPolicy​(com.google.api.resourcenames.ResourceName resource,
                                                           com.google.iam.v1.Policy policy)
        Sets the access control policy on an instance resource. Replaces any existing policy.

        Authorization requires `spanner.instances.setIamPolicy` on [resource][google.iam.v1.SetIamPolicyRequest.resource].

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           ResourceName resource = InstanceName.of("[PROJECT]", "[INSTANCE]");
           Policy policy = Policy.newBuilder().build();
           Policy response = instanceAdminClient.setIamPolicy(resource, policy);
         }
         
        Parameters:
        resource - REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.
        policy - REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Cloud Platform services (such as Projects) might reject them.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails
      • setIamPolicy

        public final com.google.iam.v1.Policy setIamPolicy​(String resource,
                                                           com.google.iam.v1.Policy policy)
        Sets the access control policy on an instance resource. Replaces any existing policy.

        Authorization requires `spanner.instances.setIamPolicy` on [resource][google.iam.v1.SetIamPolicyRequest.resource].

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           String resource = ProjectName.of("[PROJECT]").toString();
           Policy policy = Policy.newBuilder().build();
           Policy response = instanceAdminClient.setIamPolicy(resource, policy);
         }
         
        Parameters:
        resource - REQUIRED: The resource for which the policy is being specified. See the operation documentation for the appropriate value for this field.
        policy - REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Cloud Platform services (such as Projects) might reject them.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails
      • setIamPolicy

        public final com.google.iam.v1.Policy setIamPolicy​(com.google.iam.v1.SetIamPolicyRequest request)
        Sets the access control policy on an instance resource. Replaces any existing policy.

        Authorization requires `spanner.instances.setIamPolicy` on [resource][google.iam.v1.SetIamPolicyRequest.resource].

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           SetIamPolicyRequest request =
               SetIamPolicyRequest.newBuilder()
                   .setResource(InstanceName.of("[PROJECT]", "[INSTANCE]").toString())
                   .setPolicy(Policy.newBuilder().build())
                   .setUpdateMask(FieldMask.newBuilder().build())
                   .build();
           Policy response = instanceAdminClient.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 an instance resource. Replaces any existing policy.

        Authorization requires `spanner.instances.setIamPolicy` on [resource][google.iam.v1.SetIamPolicyRequest.resource].

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           SetIamPolicyRequest request =
               SetIamPolicyRequest.newBuilder()
                   .setResource(InstanceName.of("[PROJECT]", "[INSTANCE]").toString())
                   .setPolicy(Policy.newBuilder().build())
                   .setUpdateMask(FieldMask.newBuilder().build())
                   .build();
           ApiFuture<Policy> future = instanceAdminClient.setIamPolicyCallable().futureCall(request);
           // Do something.
           Policy response = future.get();
         }
         
      • getIamPolicy

        public final com.google.iam.v1.Policy getIamPolicy​(com.google.api.resourcenames.ResourceName resource)
        Gets the access control policy for an instance resource. Returns an empty policy if an instance exists but does not have a policy set.

        Authorization requires `spanner.instances.getIamPolicy` on [resource][google.iam.v1.GetIamPolicyRequest.resource].

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           ResourceName resource = InstanceName.of("[PROJECT]", "[INSTANCE]");
           Policy response = instanceAdminClient.getIamPolicy(resource);
         }
         
        Parameters:
        resource - REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails
      • getIamPolicy

        public final com.google.iam.v1.Policy getIamPolicy​(String resource)
        Gets the access control policy for an instance resource. Returns an empty policy if an instance exists but does not have a policy set.

        Authorization requires `spanner.instances.getIamPolicy` on [resource][google.iam.v1.GetIamPolicyRequest.resource].

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           String resource = ProjectName.of("[PROJECT]").toString();
           Policy response = instanceAdminClient.getIamPolicy(resource);
         }
         
        Parameters:
        resource - REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field.
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails
      • getIamPolicy

        public final com.google.iam.v1.Policy getIamPolicy​(com.google.iam.v1.GetIamPolicyRequest request)
        Gets the access control policy for an instance resource. Returns an empty policy if an instance exists but does not have a policy set.

        Authorization requires `spanner.instances.getIamPolicy` on [resource][google.iam.v1.GetIamPolicyRequest.resource].

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           GetIamPolicyRequest request =
               GetIamPolicyRequest.newBuilder()
                   .setResource(InstanceName.of("[PROJECT]", "[INSTANCE]").toString())
                   .setOptions(GetPolicyOptions.newBuilder().build())
                   .build();
           Policy response = instanceAdminClient.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 an instance resource. Returns an empty policy if an instance exists but does not have a policy set.

        Authorization requires `spanner.instances.getIamPolicy` on [resource][google.iam.v1.GetIamPolicyRequest.resource].

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           GetIamPolicyRequest request =
               GetIamPolicyRequest.newBuilder()
                   .setResource(InstanceName.of("[PROJECT]", "[INSTANCE]").toString())
                   .setOptions(GetPolicyOptions.newBuilder().build())
                   .build();
           ApiFuture<Policy> future = instanceAdminClient.getIamPolicyCallable().futureCall(request);
           // Do something.
           Policy response = future.get();
         }
         
      • testIamPermissions

        public final com.google.iam.v1.TestIamPermissionsResponse testIamPermissions​(com.google.api.resourcenames.ResourceName resource,
                                                                                     List<String> permissions)
        Returns permissions that the caller has on the specified instance resource.

        Attempting this RPC on a non-existent Cloud Spanner instance resource will result in a NOT_FOUND error if the user has `spanner.instances.list` permission on the containing Google Cloud Project. Otherwise returns an empty set of permissions.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           ResourceName resource = InstanceName.of("[PROJECT]", "[INSTANCE]");
           List<String> permissions = new ArrayList<>();
           TestIamPermissionsResponse response =
               instanceAdminClient.testIamPermissions(resource, permissions);
         }
         
        Parameters:
        resource - REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.
        permissions - The set of permissions to check for the `resource`. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails
      • testIamPermissions

        public final com.google.iam.v1.TestIamPermissionsResponse testIamPermissions​(String resource,
                                                                                     List<String> permissions)
        Returns permissions that the caller has on the specified instance resource.

        Attempting this RPC on a non-existent Cloud Spanner instance resource will result in a NOT_FOUND error if the user has `spanner.instances.list` permission on the containing Google Cloud Project. Otherwise returns an empty set of permissions.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           String resource = ProjectName.of("[PROJECT]").toString();
           List<String> permissions = new ArrayList<>();
           TestIamPermissionsResponse response =
               instanceAdminClient.testIamPermissions(resource, permissions);
         }
         
        Parameters:
        resource - REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field.
        permissions - The set of permissions to check for the `resource`. Permissions with wildcards (such as '*' or 'storage.*') are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
        Throws:
        com.google.api.gax.rpc.ApiException - if the remote call fails
      • testIamPermissions

        public final com.google.iam.v1.TestIamPermissionsResponse testIamPermissions​(com.google.iam.v1.TestIamPermissionsRequest request)
        Returns permissions that the caller has on the specified instance resource.

        Attempting this RPC on a non-existent Cloud Spanner instance resource will result in a NOT_FOUND error if the user has `spanner.instances.list` permission on the containing Google Cloud Project. Otherwise returns an empty set of permissions.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           TestIamPermissionsRequest request =
               TestIamPermissionsRequest.newBuilder()
                   .setResource(InstanceName.of("[PROJECT]", "[INSTANCE]").toString())
                   .addAllPermissions(new ArrayList<String>())
                   .build();
           TestIamPermissionsResponse response = instanceAdminClient.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 the caller has on the specified instance resource.

        Attempting this RPC on a non-existent Cloud Spanner instance resource will result in a NOT_FOUND error if the user has `spanner.instances.list` permission on the containing Google Cloud Project. Otherwise returns an empty set of permissions.

        Sample code:

        
         // This snippet has been automatically generated for illustrative purposes only.
         // It may require modifications to work in your environment.
         try (InstanceAdminClient instanceAdminClient = InstanceAdminClient.create()) {
           TestIamPermissionsRequest request =
               TestIamPermissionsRequest.newBuilder()
                   .setResource(InstanceName.of("[PROJECT]", "[INSTANCE]").toString())
                   .addAllPermissions(new ArrayList<String>())
                   .build();
           ApiFuture<TestIamPermissionsResponse> future =
               instanceAdminClient.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