Class RegionHealthChecksClient (1.6.0-beta)

public class RegionHealthChecksClient implements BackgroundResource

Service Description: The RegionHealthChecks 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:


 try (RegionHealthChecksClient regionHealthChecksClient = RegionHealthChecksClient.create()) {
   String project = "project-309310695";
   String region = "region-934795532";
   String healthCheck = "healthCheck-1938093044";
   HealthCheck response = regionHealthChecksClient.get(project, region, healthCheck);
 }
 

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

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

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

See the individual methods for example code.

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

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

To customize credentials:


 RegionHealthChecksSettings regionHealthChecksSettings =
     RegionHealthChecksSettings.newBuilder()
         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
         .build();
 RegionHealthChecksClient regionHealthChecksClient =
     RegionHealthChecksClient.create(regionHealthChecksSettings);
 

To customize the endpoint:


 RegionHealthChecksSettings regionHealthChecksSettings =
     RegionHealthChecksSettings.newBuilder().setEndpoint(myEndpoint).build();
 RegionHealthChecksClient regionHealthChecksClient =
     RegionHealthChecksClient.create(regionHealthChecksSettings);
 

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

Inheritance

java.lang.Object > RegionHealthChecksClient

Implements

BackgroundResource

Constructors

RegionHealthChecksClient(RegionHealthChecksSettings settings)

protected RegionHealthChecksClient(RegionHealthChecksSettings settings)

Constructs an instance of RegionHealthChecksClient, 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
NameDescription
settingsRegionHealthChecksSettings

RegionHealthChecksClient(RegionHealthChecksStub stub)

protected RegionHealthChecksClient(RegionHealthChecksStub stub)
Parameter
NameDescription
stubRegionHealthChecksStub

Methods

awaitTermination(long duration, TimeUnit unit)

public boolean awaitTermination(long duration, TimeUnit unit)
Parameters
NameDescription
durationlong
unitTimeUnit
Returns
TypeDescription
boolean
Exceptions
TypeDescription
InterruptedException

close()

public final void close()

create()

public static final RegionHealthChecksClient create()

Constructs an instance of RegionHealthChecksClient with default settings.

Returns
TypeDescription
RegionHealthChecksClient
Exceptions
TypeDescription
IOException

create(RegionHealthChecksSettings settings)

public static final RegionHealthChecksClient create(RegionHealthChecksSettings settings)

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

Parameter
NameDescription
settingsRegionHealthChecksSettings
Returns
TypeDescription
RegionHealthChecksClient
Exceptions
TypeDescription
IOException

create(RegionHealthChecksStub stub)

public static final RegionHealthChecksClient create(RegionHealthChecksStub stub)

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

Parameter
NameDescription
stubRegionHealthChecksStub
Returns
TypeDescription
RegionHealthChecksClient

deleteAsync(DeleteRegionHealthCheckRequest request)

public final OperationFuture<Operation,Operation> deleteAsync(DeleteRegionHealthCheckRequest request)

Deletes the specified HealthCheck resource.

Sample code:


 try (RegionHealthChecksClient regionHealthChecksClient = RegionHealthChecksClient.create()) {
   DeleteRegionHealthCheckRequest request =
       DeleteRegionHealthCheckRequest.newBuilder()
           .setHealthCheck("healthCheck-1938093044")
           .setProject("project-309310695")
           .setRegion("region-934795532")
           .setRequestId("requestId693933066")
           .build();
   Operation response = regionHealthChecksClient.deleteAsync(request).get();
 }
 
Parameter
NameDescription
requestDeleteRegionHealthCheckRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
OperationFuture<Operation,Operation>

deleteAsync(String project, String region, String healthCheck)

public final OperationFuture<Operation,Operation> deleteAsync(String project, String region, String healthCheck)

Deletes the specified HealthCheck resource.

Sample code:


 try (RegionHealthChecksClient regionHealthChecksClient = RegionHealthChecksClient.create()) {
   String project = "project-309310695";
   String region = "region-934795532";
   String healthCheck = "healthCheck-1938093044";
   Operation response = regionHealthChecksClient.deleteAsync(project, region, healthCheck).get();
 }
 
Parameters
NameDescription
projectString

Project ID for this request.

regionString

Name of the region scoping this request.

healthCheckString

Name of the HealthCheck resource to delete.

Returns
TypeDescription
OperationFuture<Operation,Operation>

deleteCallable()

public final UnaryCallable<DeleteRegionHealthCheckRequest,Operation> deleteCallable()

Deletes the specified HealthCheck resource.

Sample code:


 try (RegionHealthChecksClient regionHealthChecksClient = RegionHealthChecksClient.create()) {
   DeleteRegionHealthCheckRequest request =
       DeleteRegionHealthCheckRequest.newBuilder()
           .setHealthCheck("healthCheck-1938093044")
           .setProject("project-309310695")
           .setRegion("region-934795532")
           .setRequestId("requestId693933066")
           .build();
   ApiFuture
Returns
TypeDescription
UnaryCallable<DeleteRegionHealthCheckRequest,Operation>

deleteOperationCallable()

public final OperationCallable<DeleteRegionHealthCheckRequest,Operation,Operation> deleteOperationCallable()

Deletes the specified HealthCheck resource.

Sample code:


 try (RegionHealthChecksClient regionHealthChecksClient = RegionHealthChecksClient.create()) {
   DeleteRegionHealthCheckRequest request =
       DeleteRegionHealthCheckRequest.newBuilder()
           .setHealthCheck("healthCheck-1938093044")
           .setProject("project-309310695")
           .setRegion("region-934795532")
           .setRequestId("requestId693933066")
           .build();
   OperationFuture
Returns
TypeDescription
OperationCallable<DeleteRegionHealthCheckRequest,Operation,Operation>

get(GetRegionHealthCheckRequest request)

public final HealthCheck get(GetRegionHealthCheckRequest request)

Returns the specified HealthCheck resource. Gets a list of available health checks by making a list() request.

Sample code:


 try (RegionHealthChecksClient regionHealthChecksClient = RegionHealthChecksClient.create()) {
   GetRegionHealthCheckRequest request =
       GetRegionHealthCheckRequest.newBuilder()
           .setHealthCheck("healthCheck-1938093044")
           .setProject("project-309310695")
           .setRegion("region-934795532")
           .build();
   HealthCheck response = regionHealthChecksClient.get(request);
 }
 
Parameter
NameDescription
requestGetRegionHealthCheckRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
HealthCheck

get(String project, String region, String healthCheck)

public final HealthCheck get(String project, String region, String healthCheck)

Returns the specified HealthCheck resource. Gets a list of available health checks by making a list() request.

Sample code:


 try (RegionHealthChecksClient regionHealthChecksClient = RegionHealthChecksClient.create()) {
   String project = "project-309310695";
   String region = "region-934795532";
   String healthCheck = "healthCheck-1938093044";
   HealthCheck response = regionHealthChecksClient.get(project, region, healthCheck);
 }
 
Parameters
NameDescription
projectString

Project ID for this request.

regionString

Name of the region scoping this request.

healthCheckString

Name of the HealthCheck resource to return.

Returns
TypeDescription
HealthCheck

getCallable()

public final UnaryCallable<GetRegionHealthCheckRequest,HealthCheck> getCallable()

Returns the specified HealthCheck resource. Gets a list of available health checks by making a list() request.

Sample code:


 try (RegionHealthChecksClient regionHealthChecksClient = RegionHealthChecksClient.create()) {
   GetRegionHealthCheckRequest request =
       GetRegionHealthCheckRequest.newBuilder()
           .setHealthCheck("healthCheck-1938093044")
           .setProject("project-309310695")
           .setRegion("region-934795532")
           .build();
   ApiFuture
Returns
TypeDescription
UnaryCallable<GetRegionHealthCheckRequest,HealthCheck>

getSettings()

public final RegionHealthChecksSettings getSettings()
Returns
TypeDescription
RegionHealthChecksSettings

getStub()

public RegionHealthChecksStub getStub()
Returns
TypeDescription
RegionHealthChecksStub

insertAsync(InsertRegionHealthCheckRequest request)

public final OperationFuture<Operation,Operation> insertAsync(InsertRegionHealthCheckRequest request)

Creates a HealthCheck resource in the specified project using the data included in the request.

Sample code:


 try (RegionHealthChecksClient regionHealthChecksClient = RegionHealthChecksClient.create()) {
   InsertRegionHealthCheckRequest request =
       InsertRegionHealthCheckRequest.newBuilder()
           .setHealthCheckResource(HealthCheck.newBuilder().build())
           .setProject("project-309310695")
           .setRegion("region-934795532")
           .setRequestId("requestId693933066")
           .build();
   Operation response = regionHealthChecksClient.insertAsync(request).get();
 }
 
Parameter
NameDescription
requestInsertRegionHealthCheckRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
OperationFuture<Operation,Operation>

insertAsync(String project, String region, HealthCheck healthCheckResource)

public final OperationFuture<Operation,Operation> insertAsync(String project, String region, HealthCheck healthCheckResource)

Creates a HealthCheck resource in the specified project using the data included in the request.

Sample code:


 try (RegionHealthChecksClient regionHealthChecksClient = RegionHealthChecksClient.create()) {
   String project = "project-309310695";
   String region = "region-934795532";
   HealthCheck healthCheckResource = HealthCheck.newBuilder().build();
   Operation response =
       regionHealthChecksClient.insertAsync(project, region, healthCheckResource).get();
 }
 
Parameters
NameDescription
projectString

Project ID for this request.

regionString

Name of the region scoping this request.

healthCheckResourceHealthCheck

The body resource for this request

Returns
TypeDescription
OperationFuture<Operation,Operation>

insertCallable()

public final UnaryCallable<InsertRegionHealthCheckRequest,Operation> insertCallable()

Creates a HealthCheck resource in the specified project using the data included in the request.

Sample code:


 try (RegionHealthChecksClient regionHealthChecksClient = RegionHealthChecksClient.create()) {
   InsertRegionHealthCheckRequest request =
       InsertRegionHealthCheckRequest.newBuilder()
           .setHealthCheckResource(HealthCheck.newBuilder().build())
           .setProject("project-309310695")
           .setRegion("region-934795532")
           .setRequestId("requestId693933066")
           .build();
   ApiFuture
Returns
TypeDescription
UnaryCallable<InsertRegionHealthCheckRequest,Operation>

insertOperationCallable()

public final OperationCallable<InsertRegionHealthCheckRequest,Operation,Operation> insertOperationCallable()

Creates a HealthCheck resource in the specified project using the data included in the request.

Sample code:


 try (RegionHealthChecksClient regionHealthChecksClient = RegionHealthChecksClient.create()) {
   InsertRegionHealthCheckRequest request =
       InsertRegionHealthCheckRequest.newBuilder()
           .setHealthCheckResource(HealthCheck.newBuilder().build())
           .setProject("project-309310695")
           .setRegion("region-934795532")
           .setRequestId("requestId693933066")
           .build();
   OperationFuture
Returns
TypeDescription
OperationCallable<InsertRegionHealthCheckRequest,Operation,Operation>

isShutdown()

public boolean isShutdown()
Returns
TypeDescription
boolean

isTerminated()

public boolean isTerminated()
Returns
TypeDescription
boolean

list(ListRegionHealthChecksRequest request)

public final RegionHealthChecksClient.ListPagedResponse list(ListRegionHealthChecksRequest request)

Retrieves the list of HealthCheck resources available to the specified project.

Sample code:


 try (RegionHealthChecksClient regionHealthChecksClient = RegionHealthChecksClient.create()) {
   ListRegionHealthChecksRequest request =
       ListRegionHealthChecksRequest.newBuilder()
           .setFilter("filter-1274492040")
           .setMaxResults(1128457243)
           .setOrderBy("orderBy-1207110587")
           .setPageToken("pageToken873572522")
           .setProject("project-309310695")
           .setRegion("region-934795532")
           .setReturnPartialSuccess(true)
           .build();
   for (HealthCheck element : regionHealthChecksClient.list(request).iterateAll()) {
     // doThingsWith(element);
   }
 }
 
Parameter
NameDescription
requestListRegionHealthChecksRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
RegionHealthChecksClient.ListPagedResponse

list(String project, String region)

public final RegionHealthChecksClient.ListPagedResponse list(String project, String region)

Retrieves the list of HealthCheck resources available to the specified project.

Sample code:


 try (RegionHealthChecksClient regionHealthChecksClient = RegionHealthChecksClient.create()) {
   String project = "project-309310695";
   String region = "region-934795532";
   for (HealthCheck element : regionHealthChecksClient.list(project, region).iterateAll()) {
     // doThingsWith(element);
   }
 }
 
Parameters
NameDescription
projectString

Project ID for this request.

regionString

Name of the region scoping this request.

Returns
TypeDescription
RegionHealthChecksClient.ListPagedResponse

listCallable()

public final UnaryCallable<ListRegionHealthChecksRequest,HealthCheckList> listCallable()

Retrieves the list of HealthCheck resources available to the specified project.

Sample code:


 try (RegionHealthChecksClient regionHealthChecksClient = RegionHealthChecksClient.create()) {
   ListRegionHealthChecksRequest request =
       ListRegionHealthChecksRequest.newBuilder()
           .setFilter("filter-1274492040")
           .setMaxResults(1128457243)
           .setOrderBy("orderBy-1207110587")
           .setPageToken("pageToken873572522")
           .setProject("project-309310695")
           .setRegion("region-934795532")
           .setReturnPartialSuccess(true)
           .build();
   while (true) {
     HealthCheckList response = regionHealthChecksClient.listCallable().call(request);
     for (HealthCheck element : response.getResponsesList()) {
       // doThingsWith(element);
     }
     String nextPageToken = response.getNextPageToken();
     if (!Strings.isNullOrEmpty(nextPageToken)) {
       request = request.toBuilder().setPageToken(nextPageToken).build();
     } else {
       break;
     }
   }
 }
 
Returns
TypeDescription
UnaryCallable<ListRegionHealthChecksRequest,HealthCheckList>

listPagedCallable()

public final UnaryCallable<ListRegionHealthChecksRequest,RegionHealthChecksClient.ListPagedResponse> listPagedCallable()

Retrieves the list of HealthCheck resources available to the specified project.

Sample code:


 try (RegionHealthChecksClient regionHealthChecksClient = RegionHealthChecksClient.create()) {
   ListRegionHealthChecksRequest request =
       ListRegionHealthChecksRequest.newBuilder()
           .setFilter("filter-1274492040")
           .setMaxResults(1128457243)
           .setOrderBy("orderBy-1207110587")
           .setPageToken("pageToken873572522")
           .setProject("project-309310695")
           .setRegion("region-934795532")
           .setReturnPartialSuccess(true)
           .build();
   ApiFuture
Returns
TypeDescription
UnaryCallable<ListRegionHealthChecksRequest,ListPagedResponse>

patchAsync(PatchRegionHealthCheckRequest request)

public final OperationFuture<Operation,Operation> patchAsync(PatchRegionHealthCheckRequest request)

Updates a HealthCheck resource in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.

Sample code:


 try (RegionHealthChecksClient regionHealthChecksClient = RegionHealthChecksClient.create()) {
   PatchRegionHealthCheckRequest request =
       PatchRegionHealthCheckRequest.newBuilder()
           .setHealthCheck("healthCheck-1938093044")
           .setHealthCheckResource(HealthCheck.newBuilder().build())
           .setProject("project-309310695")
           .setRegion("region-934795532")
           .setRequestId("requestId693933066")
           .build();
   Operation response = regionHealthChecksClient.patchAsync(request).get();
 }
 
Parameter
NameDescription
requestPatchRegionHealthCheckRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
OperationFuture<Operation,Operation>

patchAsync(String project, String region, String healthCheck, HealthCheck healthCheckResource)

public final OperationFuture<Operation,Operation> patchAsync(String project, String region, String healthCheck, HealthCheck healthCheckResource)

Updates a HealthCheck resource in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.

Sample code:


 try (RegionHealthChecksClient regionHealthChecksClient = RegionHealthChecksClient.create()) {
   String project = "project-309310695";
   String region = "region-934795532";
   String healthCheck = "healthCheck-1938093044";
   HealthCheck healthCheckResource = HealthCheck.newBuilder().build();
   Operation response =
       regionHealthChecksClient
           .patchAsync(project, region, healthCheck, healthCheckResource)
           .get();
 }
 
Parameters
NameDescription
projectString

Project ID for this request.

regionString

Name of the region scoping this request.

healthCheckString

Name of the HealthCheck resource to patch.

healthCheckResourceHealthCheck

The body resource for this request

Returns
TypeDescription
OperationFuture<Operation,Operation>

patchCallable()

public final UnaryCallable<PatchRegionHealthCheckRequest,Operation> patchCallable()

Updates a HealthCheck resource in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.

Sample code:


 try (RegionHealthChecksClient regionHealthChecksClient = RegionHealthChecksClient.create()) {
   PatchRegionHealthCheckRequest request =
       PatchRegionHealthCheckRequest.newBuilder()
           .setHealthCheck("healthCheck-1938093044")
           .setHealthCheckResource(HealthCheck.newBuilder().build())
           .setProject("project-309310695")
           .setRegion("region-934795532")
           .setRequestId("requestId693933066")
           .build();
   ApiFuture
Returns
TypeDescription
UnaryCallable<PatchRegionHealthCheckRequest,Operation>

patchOperationCallable()

public final OperationCallable<PatchRegionHealthCheckRequest,Operation,Operation> patchOperationCallable()

Updates a HealthCheck resource in the specified project using the data included in the request. This method supports PATCH semantics and uses the JSON merge patch format and processing rules.

Sample code:


 try (RegionHealthChecksClient regionHealthChecksClient = RegionHealthChecksClient.create()) {
   PatchRegionHealthCheckRequest request =
       PatchRegionHealthCheckRequest.newBuilder()
           .setHealthCheck("healthCheck-1938093044")
           .setHealthCheckResource(HealthCheck.newBuilder().build())
           .setProject("project-309310695")
           .setRegion("region-934795532")
           .setRequestId("requestId693933066")
           .build();
   OperationFuture
Returns
TypeDescription
OperationCallable<PatchRegionHealthCheckRequest,Operation,Operation>

shutdown()

public void shutdown()

shutdownNow()

public void shutdownNow()

updateAsync(UpdateRegionHealthCheckRequest request)

public final OperationFuture<Operation,Operation> updateAsync(UpdateRegionHealthCheckRequest request)

Updates a HealthCheck resource in the specified project using the data included in the request.

Sample code:


 try (RegionHealthChecksClient regionHealthChecksClient = RegionHealthChecksClient.create()) {
   UpdateRegionHealthCheckRequest request =
       UpdateRegionHealthCheckRequest.newBuilder()
           .setHealthCheck("healthCheck-1938093044")
           .setHealthCheckResource(HealthCheck.newBuilder().build())
           .setProject("project-309310695")
           .setRegion("region-934795532")
           .setRequestId("requestId693933066")
           .build();
   Operation response = regionHealthChecksClient.updateAsync(request).get();
 }
 
Parameter
NameDescription
requestUpdateRegionHealthCheckRequest

The request object containing all of the parameters for the API call.

Returns
TypeDescription
OperationFuture<Operation,Operation>

updateAsync(String project, String region, String healthCheck, HealthCheck healthCheckResource)

public final OperationFuture<Operation,Operation> updateAsync(String project, String region, String healthCheck, HealthCheck healthCheckResource)

Updates a HealthCheck resource in the specified project using the data included in the request.

Sample code:


 try (RegionHealthChecksClient regionHealthChecksClient = RegionHealthChecksClient.create()) {
   String project = "project-309310695";
   String region = "region-934795532";
   String healthCheck = "healthCheck-1938093044";
   HealthCheck healthCheckResource = HealthCheck.newBuilder().build();
   Operation response =
       regionHealthChecksClient
           .updateAsync(project, region, healthCheck, healthCheckResource)
           .get();
 }
 
Parameters
NameDescription
projectString

Project ID for this request.

regionString

Name of the region scoping this request.

healthCheckString

Name of the HealthCheck resource to update.

healthCheckResourceHealthCheck

The body resource for this request

Returns
TypeDescription
OperationFuture<Operation,Operation>

updateCallable()

public final UnaryCallable<UpdateRegionHealthCheckRequest,Operation> updateCallable()

Updates a HealthCheck resource in the specified project using the data included in the request.

Sample code:


 try (RegionHealthChecksClient regionHealthChecksClient = RegionHealthChecksClient.create()) {
   UpdateRegionHealthCheckRequest request =
       UpdateRegionHealthCheckRequest.newBuilder()
           .setHealthCheck("healthCheck-1938093044")
           .setHealthCheckResource(HealthCheck.newBuilder().build())
           .setProject("project-309310695")
           .setRegion("region-934795532")
           .setRequestId("requestId693933066")
           .build();
   ApiFuture
Returns
TypeDescription
UnaryCallable<UpdateRegionHealthCheckRequest,Operation>

updateOperationCallable()

public final OperationCallable<UpdateRegionHealthCheckRequest,Operation,Operation> updateOperationCallable()

Updates a HealthCheck resource in the specified project using the data included in the request.

Sample code:


 try (RegionHealthChecksClient regionHealthChecksClient = RegionHealthChecksClient.create()) {
   UpdateRegionHealthCheckRequest request =
       UpdateRegionHealthCheckRequest.newBuilder()
           .setHealthCheck("healthCheck-1938093044")
           .setHealthCheckResource(HealthCheck.newBuilder().build())
           .setProject("project-309310695")
           .setRegion("region-934795532")
           .setRequestId("requestId693933066")
           .build();
   OperationFuture
Returns
TypeDescription
OperationCallable<UpdateRegionHealthCheckRequest,Operation,Operation>