Class TargetPoolsClient (1.88.0)

GitHub RepositoryProduct Reference

Service Description: The TargetPools API.

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


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (TargetPoolsClient targetPoolsClient = TargetPoolsClient.create()) {
   String project = "project-309310695";
   String region = "region-934795532";
   String targetPool = "targetPool486493517";
   TargetPool response = targetPoolsClient.get(project, region, targetPool);
 }

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

Methods
Method Description Method Variants

AddHealthCheck

Adds health check URLs to a target pool.

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

  • addHealthCheckAsync(AddHealthCheckTargetPoolRequest request)

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

  • addHealthCheckAsync(String project, String region, String targetPool, TargetPoolsAddHealthCheckRequest targetPoolsAddHealthCheckRequestResource)

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

  • addHealthCheckOperationCallable()

  • addHealthCheckCallable()

AddInstance

Adds an instance to a target pool.

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

  • addInstanceAsync(AddInstanceTargetPoolRequest request)

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

  • addInstanceAsync(String project, String region, String targetPool, TargetPoolsAddInstanceRequest targetPoolsAddInstanceRequestResource)

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

  • addInstanceOperationCallable()

  • addInstanceCallable()

AggregatedList

Retrieves an aggregated list of target pools. To prevent failure, Google recommends that you set the returnPartialSuccess parameter to true.

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

  • aggregatedList(AggregatedListTargetPoolsRequest request)

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

  • aggregatedList(String project)

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

  • aggregatedListPagedCallable()

  • aggregatedListCallable()

Delete

Deletes the specified target pool.

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

  • deleteAsync(DeleteTargetPoolRequest request)

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

  • deleteAsync(String project, String region, String targetPool)

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

  • deleteOperationCallable()

  • deleteCallable()

Get

Returns the specified target pool.

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

  • get(GetTargetPoolRequest request)

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

  • get(String project, String region, String targetPool)

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

  • getCallable()

GetHealth

Gets the most recent health check results for each IP for the instance that is referenced by the given target pool.

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

  • getHealth(GetHealthTargetPoolRequest request)

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

  • getHealth(String project, String region, String targetPool, InstanceReference instanceReferenceResource)

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

  • getHealthCallable()

Insert

Creates a target pool in the specified project and region using the data included in the request.

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

  • insertAsync(InsertTargetPoolRequest request)

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

  • insertAsync(String project, String region, TargetPool targetPoolResource)

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

  • insertOperationCallable()

  • insertCallable()

List

Retrieves a list of target pools available to the specified project and region.

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

  • list(ListTargetPoolsRequest request)

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

  • list(String project, String region)

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

  • listPagedCallable()

  • listCallable()

RemoveHealthCheck

Removes health check URL from a target pool.

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

  • removeHealthCheckAsync(RemoveHealthCheckTargetPoolRequest request)

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

  • removeHealthCheckAsync(String project, String region, String targetPool, TargetPoolsRemoveHealthCheckRequest targetPoolsRemoveHealthCheckRequestResource)

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

  • removeHealthCheckOperationCallable()

  • removeHealthCheckCallable()

RemoveInstance

Removes instance URL from a target pool.

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

  • removeInstanceAsync(RemoveInstanceTargetPoolRequest request)

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

  • removeInstanceAsync(String project, String region, String targetPool, TargetPoolsRemoveInstanceRequest targetPoolsRemoveInstanceRequestResource)

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

  • removeInstanceOperationCallable()

  • removeInstanceCallable()

SetBackup

Changes a backup target pool's configurations.

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

  • setBackupAsync(SetBackupTargetPoolRequest request)

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

  • setBackupAsync(String project, String region, String targetPool, TargetReference targetReferenceResource)

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

  • setBackupOperationCallable()

  • setBackupCallable()

SetSecurityPolicy

Sets the Google Cloud Armor security policy for the specified target pool. For more information, see Google Cloud Armor Overview

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

  • setSecurityPolicyAsync(SetSecurityPolicyTargetPoolRequest request)

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

  • setSecurityPolicyAsync(String project, String region, String targetPool, SecurityPolicyReference securityPolicyReferenceResource)

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

  • setSecurityPolicyOperationCallable()

  • setSecurityPolicyCallable()

TestIamPermissions

Returns permissions that a caller has on the specified resource.

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

  • testIamPermissions(TestIamPermissionsTargetPoolRequest request)

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

  • testIamPermissions(String project, String region, String resource, TestPermissionsRequest testPermissionsRequestResource)

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

  • testIamPermissionsCallable()

See the individual methods for example code.

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

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

To customize credentials:


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

To customize the endpoint:


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

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

Inheritance

java.lang.Object > TargetPoolsClient

Static Methods

create()

public static final TargetPoolsClient create()

Constructs an instance of TargetPoolsClient with default settings.

Returns
Type Description
TargetPoolsClient
Exceptions
Type Description
IOException

create(TargetPoolsSettings settings)

public static final TargetPoolsClient create(TargetPoolsSettings settings)

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

Parameter
Name Description
settings TargetPoolsSettings
Returns
Type Description
TargetPoolsClient
Exceptions
Type Description
IOException

create(TargetPoolsStub stub)

public static final TargetPoolsClient create(TargetPoolsStub stub)

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

Parameter
Name Description
stub TargetPoolsStub
Returns
Type Description
TargetPoolsClient

Constructors

TargetPoolsClient(TargetPoolsSettings settings)

protected TargetPoolsClient(TargetPoolsSettings settings)

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

Parameter
Name Description
settings TargetPoolsSettings

TargetPoolsClient(TargetPoolsStub stub)

protected TargetPoolsClient(TargetPoolsStub stub)
Parameter
Name Description
stub TargetPoolsStub

Methods

addHealthCheckAsync(AddHealthCheckTargetPoolRequest request)

public final OperationFuture<Operation,Operation> addHealthCheckAsync(AddHealthCheckTargetPoolRequest request)

Adds health check URLs to a target pool.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (TargetPoolsClient targetPoolsClient = TargetPoolsClient.create()) {
   AddHealthCheckTargetPoolRequest request =
       AddHealthCheckTargetPoolRequest.newBuilder()
           .setProject("project-309310695")
           .setRegion("region-934795532")
           .setRequestId("requestId693933066")
           .setTargetPool("targetPool486493517")
           .setTargetPoolsAddHealthCheckRequestResource(
               TargetPoolsAddHealthCheckRequest.newBuilder().build())
           .build();
   Operation response = targetPoolsClient.addHealthCheckAsync(request).get();
 }
Parameter
Name Description
request AddHealthCheckTargetPoolRequest

The request object containing all of the parameters for the API call.
Returns
Type Description
OperationFuture<Operation,Operation>

addHealthCheckAsync(String project, String region, String targetPool, TargetPoolsAddHealthCheckRequest targetPoolsAddHealthCheckRequestResource)

public final OperationFuture<Operation,Operation> addHealthCheckAsync(String project, String region, String targetPool, TargetPoolsAddHealthCheckRequest targetPoolsAddHealthCheckRequestResource)

Adds health check URLs to a target pool.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (TargetPoolsClient targetPoolsClient = TargetPoolsClient.create()) {
   String project = "project-309310695";
   String region = "region-934795532";
   String targetPool = "targetPool486493517";
   TargetPoolsAddHealthCheckRequest targetPoolsAddHealthCheckRequestResource =
       TargetPoolsAddHealthCheckRequest.newBuilder().build();
   Operation response =
       targetPoolsClient
           .addHealthCheckAsync(
               project, region, targetPool, targetPoolsAddHealthCheckRequestResource)
           .get();
 }
Parameters
Name Description
project String

Project ID for this request.
region String

Name of the region scoping this request.
targetPool String

Name of the target pool to add a health check to.
targetPoolsAddHealthCheckRequestResource TargetPoolsAddHealthCheckRequest

The body resource for this request
Returns
Type Description
OperationFuture<Operation,Operation>

addHealthCheckCallable()

public final UnaryCallable<AddHealthCheckTargetPoolRequest,Operation> addHealthCheckCallable()

Adds health check URLs to a target pool.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (TargetPoolsClient targetPoolsClient = TargetPoolsClient.create()) {
   AddHealthCheckTargetPoolRequest request =
       AddHealthCheckTargetPoolRequest.newBuilder()
           .setProject("project-309310695")
           .setRegion("region-934795532")
           .setRequestId("requestId693933066")
           .setTargetPool("targetPool486493517")
           .setTargetPoolsAddHealthCheckRequestResource(
               TargetPoolsAddHealthCheckRequest.newBuilder().build())
           .build();
   ApiFuture<Operation> future = targetPoolsClient.addHealthCheckCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
Returns
Type Description
UnaryCallable<AddHealthCheckTargetPoolRequest,Operation>

addHealthCheckOperationCallable()

public final OperationCallable<AddHealthCheckTargetPoolRequest,Operation,Operation> addHealthCheckOperationCallable()

Adds health check URLs to a target pool.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (TargetPoolsClient targetPoolsClient = TargetPoolsClient.create()) {
   AddHealthCheckTargetPoolRequest request =
       AddHealthCheckTargetPoolRequest.newBuilder()
           .setProject("project-309310695")
           .setRegion("region-934795532")
           .setRequestId("requestId693933066")
           .setTargetPool("targetPool486493517")
           .setTargetPoolsAddHealthCheckRequestResource(
               TargetPoolsAddHealthCheckRequest.newBuilder().build())
           .build();
   OperationFuture<Operation, Operation> future =
       targetPoolsClient.addHealthCheckOperationCallable().futureCall(request);
   // Do something.
   Operation response = future.get();
 }
Returns
Type Description
OperationCallable<AddHealthCheckTargetPoolRequest,Operation,Operation>

addInstanceAsync(AddInstanceTargetPoolRequest request)

public final OperationFuture<Operation,Operation> addInstanceAsync(AddInstanceTargetPoolRequest request)

Adds an instance to a target pool.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (TargetPoolsClient targetPoolsClient = TargetPoolsClient.create()) {
   AddInstanceTargetPoolRequest request =
       AddInstanceTargetPoolRequest.newBuilder()
           .setProject("project-309310695")
           .setRegion("region-934795532")
           .setRequestId("requestId693933066")
           .setTargetPool("targetPool486493517")
           .setTargetPoolsAddInstanceRequestResource(
               TargetPoolsAddInstanceRequest.newBuilder().build())
           .build();
   Operation response = targetPoolsClient.addInstanceAsync(request).get();
 }
Parameter
Name Description
request AddInstanceTargetPoolRequest

The request object containing all of the parameters for the API call.
Returns
Type Description
OperationFuture<Operation,Operation>

addInstanceAsync(String project, String region, String targetPool, TargetPoolsAddInstanceRequest targetPoolsAddInstanceRequestResource)

public final OperationFuture<Operation,Operation> addInstanceAsync(String project, String region, String targetPool, TargetPoolsAddInstanceRequest targetPoolsAddInstanceRequestResource)

Adds an instance to a target pool.

Sample code:


 // This snippet has been automatically generated and should be regarded as a code template only.
 // It will require modifications to work:
 // - It may require correct/in-range values for request initialization.
 // - It may require specifying regional endpoints when creating the service client as shown in
 // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
 try (TargetPoolsClient targetPoolsClient = TargetPoolsClient.create()) {
   String project = "project-309310695";
   String region = "region-934795532";
   String targetPool = "targetPool486493517";
   TargetPoolsAddInstanceRequest targetPoolsAddInstanceRequestResource =
       TargetPoolsAddInstanceRequest.newBuilder().build();
   Operation response =
       targetPoolsClient
           .addInstanceAsync(project, region, targetPool, targetPoolsAddInstanceRequestResource)
           .get();
 }
Parameters
Name Description
project String

Project ID for this request.
region String

Name of the region scoping this request.