Class InstanceAdminClient
- java.lang.Object
-
- com.google.cloud.spanner.admin.instance.v1.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 APIThe 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:
- 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.
- 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.
- 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.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class 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 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 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.com.google.api.gax.longrunning.OperationFuture<Instance,CreateInstanceMetadata>
createInstanceAsync(CreateInstanceRequest request)
Creates an instance and begins preparing it to begin serving.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.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.com.google.api.gax.rpc.UnaryCallable<CreateInstanceRequest,com.google.longrunning.Operation>
createInstanceCallable()
Creates an instance and begins preparing it to begin serving.com.google.api.gax.rpc.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.com.google.api.gax.rpc.UnaryCallable<DeleteInstanceRequest,com.google.protobuf.Empty>
deleteInstanceCallable()
Deletes an instance.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.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(com.google.iam.v1.GetIamPolicyRequest request)
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.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.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.com.google.api.gax.rpc.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.com.google.api.gax.rpc.UnaryCallable<GetInstanceConfigRequest,InstanceConfig>
getInstanceConfigCallable()
Gets information about a particular instance configuration.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.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.com.google.api.gax.rpc.UnaryCallable<ListInstanceConfigsRequest,ListInstanceConfigsResponse>
listInstanceConfigsCallable()
Lists the supported instance configurations for a given project.com.google.api.gax.rpc.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.com.google.api.gax.rpc.UnaryCallable<ListInstancesRequest,ListInstancesResponse>
listInstancesCallable()
Lists all instances in the given project.com.google.api.gax.rpc.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.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.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(com.google.iam.v1.TestIamPermissionsRequest request)
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.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.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.com.google.api.gax.longrunning.OperationFuture<Instance,UpdateInstanceMetadata>
updateInstanceAsync(UpdateInstanceRequest request)
Updates an instance, and begins allocating or releasing resources as requested.com.google.api.gax.rpc.UnaryCallable<UpdateInstanceRequest,com.google.longrunning.Operation>
updateInstanceCallable()
Updates an instance, and begins allocating or releasing resources as requested.com.google.api.gax.rpc.OperationCallable<UpdateInstanceRequest,Instance,UpdateInstanceMetadata>
updateInstanceOperationCallable()
Updates an instance, and begins allocating or releasing resources as requested.
-
-
-
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
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
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
public InstanceAdminStub getStub()
-
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(); }
-
close
public final void close()
- Specified by:
close
in interfaceAutoCloseable
-
shutdown
public void shutdown()
- Specified by:
shutdown
in interfacecom.google.api.gax.core.BackgroundResource
-
isShutdown
public boolean isShutdown()
- Specified by:
isShutdown
in interfacecom.google.api.gax.core.BackgroundResource
-
isTerminated
public boolean isTerminated()
- Specified by:
isTerminated
in interfacecom.google.api.gax.core.BackgroundResource
-
shutdownNow
public void shutdownNow()
- Specified by:
shutdownNow
in interfacecom.google.api.gax.core.BackgroundResource
-
awaitTermination
public boolean awaitTermination(long duration, TimeUnit unit) throws InterruptedException
- Specified by:
awaitTermination
in interfacecom.google.api.gax.core.BackgroundResource
- Throws:
InterruptedException
-
-