InstanceAdminClient (Google Cloud Spanner Parent 6.25.1 API)

java.lang.Object
- com.google.cloud.spanner.admin.instance.v1.InstanceAdminClient

All Implemented Interfaces:

BackgroundResource, AutoCloseable
```
@Generated(value="by gapic-generator-java")
public class InstanceAdminClient
extends Object
implements 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);
 
```
Please refer to the GitHub repository's samples for more quickstart code snippets.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`InstanceAdminClient.ListInstanceConfigsFixedSizeCollection`
`static class`	`InstanceAdminClient.ListInstanceConfigsPage`
`static class`	`InstanceAdminClient.ListInstanceConfigsPagedResponse`
`static class`	`InstanceAdminClient.ListInstancesFixedSizeCollection`
`static class`	`InstanceAdminClient.ListInstancesPage`
`static class`	`InstanceAdminClient.ListInstancesPagedResponse`

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`InstanceAdminClient(InstanceAdminSettings settings)` Constructs an instance of InstanceAdminClient, using the given settings.
`protected`	`InstanceAdminClient(InstanceAdminStub stub)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`awaitTermination(long duration, TimeUnit unit)`
`void`	`close()`
`static InstanceAdminClient`	`create()` Constructs an instance of InstanceAdminClient with default settings.
`static InstanceAdminClient`	`create(InstanceAdminSettings settings)` Constructs an instance of InstanceAdminClient, using the given settings.
`static InstanceAdminClient`	`create(InstanceAdminStub stub)` Constructs an instance of InstanceAdminClient, using the given stub for making calls.
`OperationFuture<Instance,CreateInstanceMetadata>`	`createInstanceAsync(CreateInstanceRequest request)` Creates an instance and begins preparing it to begin serving.
`OperationFuture<Instance,CreateInstanceMetadata>`	`createInstanceAsync(ProjectName parent, String instanceId, Instance instance)` Creates an instance and begins preparing it to begin serving.
`OperationFuture<Instance,CreateInstanceMetadata>`	`createInstanceAsync(String parent, String instanceId, Instance instance)` Creates an instance and begins preparing it to begin serving.
`UnaryCallable<CreateInstanceRequest,Operation>`	`createInstanceCallable()` Creates an instance and begins preparing it to begin serving.
`OperationCallable<CreateInstanceRequest,Instance,CreateInstanceMetadata>`	`createInstanceOperationCallable()` Creates an instance and begins preparing it to begin serving.
`void`	`deleteInstance(DeleteInstanceRequest request)` Deletes an instance.
`void`	`deleteInstance(InstanceName name)` Deletes an instance.
`void`	`deleteInstance(String name)` Deletes an instance.
`UnaryCallable<DeleteInstanceRequest,Empty>`	`deleteInstanceCallable()` Deletes an instance.
`com.google.iam.v1.Policy`	`getIamPolicy(com.google.iam.v1.GetIamPolicyRequest request)` Gets the access control policy for an instance resource.
`com.google.iam.v1.Policy`	`getIamPolicy(com.google.api.resourcenames.ResourceName resource)` Gets the access control policy for an instance resource.
`com.google.iam.v1.Policy`	`getIamPolicy(String resource)` Gets the access control policy for an instance resource.
`UnaryCallable<com.google.iam.v1.GetIamPolicyRequest,com.google.iam.v1.Policy>`	`getIamPolicyCallable()` Gets the access control policy for an instance resource.
`Instance`	`getInstance(GetInstanceRequest request)` Gets information about a particular instance.
`Instance`	`getInstance(InstanceName name)` Gets information about a particular instance.
`Instance`	`getInstance(String name)` Gets information about a particular instance.
`UnaryCallable<GetInstanceRequest,Instance>`	`getInstanceCallable()` Gets information about a particular instance.
`InstanceConfig`	`getInstanceConfig(GetInstanceConfigRequest request)` Gets information about a particular instance configuration.
`InstanceConfig`	`getInstanceConfig(InstanceConfigName name)` Gets information about a particular instance configuration.
`InstanceConfig`	`getInstanceConfig(String name)` Gets information about a particular instance configuration.
`UnaryCallable<GetInstanceConfigRequest,InstanceConfig>`	`getInstanceConfigCallable()` Gets information about a particular instance configuration.
`OperationsClient`	`getOperationsClient()` Returns the OperationsClient that can be used to query the status of a long-running operation returned by another API method call.
`InstanceAdminSettings`	`getSettings()`
`InstanceAdminStub`	`getStub()`
`boolean`	`isShutdown()`
`boolean`	`isTerminated()`
`InstanceAdminClient.ListInstanceConfigsPagedResponse`	`listInstanceConfigs(ListInstanceConfigsRequest request)` Lists the supported instance configurations for a given project.
`InstanceAdminClient.ListInstanceConfigsPagedResponse`	`listInstanceConfigs(ProjectName parent)` Lists the supported instance configurations for a given project.
`InstanceAdminClient.ListInstanceConfigsPagedResponse`	`listInstanceConfigs(String parent)` Lists the supported instance configurations for a given project.
`UnaryCallable<ListInstanceConfigsRequest,ListInstanceConfigsResponse>`	`listInstanceConfigsCallable()` Lists the supported instance configurations for a given project.
`UnaryCallable<ListInstanceConfigsRequest,InstanceAdminClient.ListInstanceConfigsPagedResponse>`	`listInstanceConfigsPagedCallable()` Lists the supported instance configurations for a given project.
`InstanceAdminClient.ListInstancesPagedResponse`	`listInstances(ListInstancesRequest request)` Lists all instances in the given project.
`InstanceAdminClient.ListInstancesPagedResponse`	`listInstances(ProjectName parent)` Lists all instances in the given project.
`InstanceAdminClient.ListInstancesPagedResponse`	`listInstances(String parent)` Lists all instances in the given project.
`UnaryCallable<ListInstancesRequest,ListInstancesResponse>`	`listInstancesCallable()` Lists all instances in the given project.
`UnaryCallable<ListInstancesRequest,InstanceAdminClient.ListInstancesPagedResponse>`	`listInstancesPagedCallable()` Lists all instances in the given project.
`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.
`com.google.iam.v1.Policy`	`setIamPolicy(com.google.iam.v1.SetIamPolicyRequest request)` Sets the access control policy on an instance resource.
`com.google.iam.v1.Policy`	`setIamPolicy(String resource, com.google.iam.v1.Policy policy)` Sets the access control policy on an instance resource.
`UnaryCallable<com.google.iam.v1.SetIamPolicyRequest,com.google.iam.v1.Policy>`	`setIamPolicyCallable()` Sets the access control policy on an instance resource.
`void`	`shutdown()`
`void`	`shutdownNow()`
`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.
`com.google.iam.v1.TestIamPermissionsResponse`	`testIamPermissions(String resource, List<String> permissions)` Returns permissions that the caller has on the specified instance resource.
`com.google.iam.v1.TestIamPermissionsResponse`	`testIamPermissions(com.google.iam.v1.TestIamPermissionsRequest request)` Returns permissions that the caller has on the specified instance resource.
`UnaryCallable<com.google.iam.v1.TestIamPermissionsRequest,com.google.iam.v1.TestIamPermissionsResponse>`	`testIamPermissionsCallable()` Returns permissions that the caller has on the specified instance resource.
`OperationFuture<Instance,UpdateInstanceMetadata>`	`updateInstanceAsync(Instance instance, FieldMask fieldMask)` Updates an instance, and begins allocating or releasing resources as requested.
`OperationFuture<Instance,UpdateInstanceMetadata>`	`updateInstanceAsync(UpdateInstanceRequest request)` Updates an instance, and begins allocating or releasing resources as requested.
`UnaryCallable<UpdateInstanceRequest,Operation>`	`updateInstanceCallable()` Updates an instance, and begins allocating or releasing resources as requested.
`OperationCallable<UpdateInstanceRequest,Instance,UpdateInstanceMetadata>`	`updateInstanceOperationCallable()` Updates an instance, and begins allocating or releasing resources as requested.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 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
  - InstanceAdminClient
```
@BetaApi(value="A restructuring of stub classes is planned, so this may break in the future")
protected InstanceAdminClient(InstanceAdminStub stub)
```
- Method Detail
  - create
```
public static final InstanceAdminClient create()
                                        throws IOException
```
    Constructs an instance of InstanceAdminClient with default settings.
    
    Throws:
    
    IOException
  - 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
```
@BetaApi(value="A restructuring of stub classes is planned, so this may break in the future")
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).
  - getSettings
```
public final InstanceAdminSettings getSettings()
```
  - getStub
```
@BetaApi(value="A restructuring of stub classes is planned, so this may break in the future")
public InstanceAdminStub getStub()
```
  - getOperationsClient
```
public final OperationsClient getOperationsClient()
```
    Returns the OperationsClient that can be used to query the status of a long-running operation returned by another API method call.
  - 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:
    
    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:
    
    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:
    
    ApiException - if the remote call fails
  - listInstanceConfigsPagedCallable
```
public final 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 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.getResponsesList()) {
       // 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:
    
    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:
    
    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:
    
    ApiException - if the remote call fails
  - getInstanceConfigCallable
```
public final 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:
    
    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:
    
    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:
    
    ApiException - if the remote call fails
  - listInstancesPagedCallable
```
public final 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 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.getResponsesList()) {
       // 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:
    
    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:
    
    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:
    
    ApiException - if the remote call fails
  - getInstanceCallable
```
public final 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 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:
    
    ApiException - if the remote call fails
  - createInstanceAsync
```
public final 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:
    
    ApiException - if the remote call fails
  - createInstanceAsync
```
public final 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:
    
    ApiException - if the remote call fails
  - createInstanceOperationCallable
```
public final 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 UnaryCallable<CreateInstanceRequest,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 OperationFuture<Instance,UpdateInstanceMetadata> updateInstanceAsync(Instance instance,
                                                                                  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 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:
    
    ApiException - if the remote call fails
  - updateInstanceAsync
```
public final 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 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:
    
    ApiException - if the remote call fails
  - updateInstanceOperationCallable
```
public final 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 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 UnaryCallable<UpdateInstanceRequest,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 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:
    
    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:
    
    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:
    
    ApiException - if the remote call fails
  - deleteInstanceCallable
```
public final UnaryCallable<DeleteInstanceRequest,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 = ProjectName.of("[PROJECT]");
   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:
    
    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:
    
    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(ProjectName.of("[PROJECT]").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:
    
    ApiException - if the remote call fails
  - setIamPolicyCallable
```
public final 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(ProjectName.of("[PROJECT]").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 = ProjectName.of("[PROJECT]");
   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:
    
    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:
    
    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(ProjectName.of("[PROJECT]").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:
    
    ApiException - if the remote call fails
  - getIamPolicyCallable
```
public final 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(ProjectName.of("[PROJECT]").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 = ProjectName.of("[PROJECT]");
   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:
    
    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:
    
    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(ProjectName.of("[PROJECT]").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:
    
    ApiException - if the remote call fails
  - testIamPermissionsCallable
```
public final 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(ProjectName.of("[PROJECT]").toString())
           .addAllPermissions(new ArrayList<String>())
           .build();
   ApiFuture<TestIamPermissionsResponse> future =
       instanceAdminClient.testIamPermissionsCallable().futureCall(request);
   // Do something.
   TestIamPermissionsResponse response = future.get();
 }
 
```
  - close
```
public final void close()
```
    Specified by:
    
    close in interface AutoCloseable
  - shutdown
```
public void shutdown()
```
    Specified by:
    
    shutdown in interface BackgroundResource
  - isShutdown
```
public boolean isShutdown()
```
    Specified by:
    
    isShutdown in interface BackgroundResource
  - isTerminated
```
public boolean isTerminated()
```
    Specified by:
    
    isTerminated in interface BackgroundResource
  - shutdownNow
```
public void shutdownNow()
```
    Specified by:
    
    shutdownNow in interface BackgroundResource
  - awaitTermination
```
public boolean awaitTermination(long duration,
                                TimeUnit unit)
                         throws InterruptedException
```
    Specified by:
    
    awaitTermination in interface BackgroundResource
    
    Throws:
    
    InterruptedException

Class InstanceAdminClient

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

InstanceAdminClient

InstanceAdminClient

Method Detail

create

create

create

getSettings

getStub

getOperationsClient

listInstanceConfigs

listInstanceConfigs

listInstanceConfigs

listInstanceConfigsPagedCallable

listInstanceConfigsCallable

getInstanceConfig

getInstanceConfig

getInstanceConfig

getInstanceConfigCallable

listInstances

listInstances

listInstances

listInstancesPagedCallable

listInstancesCallable

getInstance

getInstance

getInstance

getInstanceCallable

createInstanceAsync

createInstanceAsync

createInstanceAsync

createInstanceOperationCallable

createInstanceCallable

updateInstanceAsync

updateInstanceAsync

updateInstanceOperationCallable

updateInstanceCallable

deleteInstance

deleteInstance

deleteInstance

deleteInstanceCallable

setIamPolicy

setIamPolicy

setIamPolicy

setIamPolicyCallable

getIamPolicy

getIamPolicy

getIamPolicy

getIamPolicyCallable

testIamPermissions

testIamPermissions

testIamPermissions

testIamPermissionsCallable

close

shutdown

isShutdown

isTerminated

shutdownNow

awaitTermination