Class HealthChecksClient (1.6.0-beta)

public class HealthChecksClient implements BackgroundResource

Service Description: The HealthChecks 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 (HealthChecksClient healthChecksClient = HealthChecksClient.create()) {
   String project = "project-309310695";
   String healthCheck = "healthCheck-1938093044";
   HealthCheck response = healthChecksClient.get(project, healthCheck);
 }
 

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

To customize credentials:


 HealthChecksSettings healthChecksSettings =
     HealthChecksSettings.newBuilder()
         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
         .build();
 HealthChecksClient healthChecksClient = HealthChecksClient.create(healthChecksSettings);
 

To customize the endpoint:


 HealthChecksSettings healthChecksSettings =
     HealthChecksSettings.newBuilder().setEndpoint(myEndpoint).build();
 HealthChecksClient healthChecksClient = HealthChecksClient.create(healthChecksSettings);
 

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

Inheritance

java.lang.Object > HealthChecksClient

Implements

BackgroundResource

Constructors

HealthChecksClient(HealthChecksSettings settings)

protected HealthChecksClient(HealthChecksSettings settings)

Constructs an instance of HealthChecksClient, 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
settingsHealthChecksSettings

HealthChecksClient(HealthChecksStub stub)

protected HealthChecksClient(HealthChecksStub stub)
Parameter
NameDescription
stubHealthChecksStub

Methods

aggregatedList(AggregatedListHealthChecksRequest request)

public final HealthChecksClient.AggregatedListPagedResponse aggregatedList(AggregatedListHealthChecksRequest request)

Retrieves the list of all HealthCheck resources, regional and global, available to the specified project.

Sample code:


 try (HealthChecksClient healthChecksClient = HealthChecksClient.create()) {
   AggregatedListHealthChecksRequest request =
       AggregatedListHealthChecksRequest.newBuilder()
           .setFilter("filter-1274492040")
           .setIncludeAllScopes(true)
           .setMaxResults(1128457243)
           .setOrderBy("orderBy-1207110587")
           .setPageToken("pageToken873572522")
           .setProject("project-309310695")
           .setReturnPartialSuccess(true)
           .build();
   for (Map.Entry
Parameter
NameDescription
requestAggregatedListHealthChecksRequest

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

Returns
TypeDescription
HealthChecksClient.AggregatedListPagedResponse

aggregatedList(String project)

public final HealthChecksClient.AggregatedListPagedResponse aggregatedList(String project)

Retrieves the list of all HealthCheck resources, regional and global, available to the specified project.

Sample code:


 try (HealthChecksClient healthChecksClient = HealthChecksClient.create()) {
   String project = "project-309310695";
   for (Map.Entry
Parameter
NameDescription
projectString

Name of the project scoping this request.

Returns
TypeDescription
HealthChecksClient.AggregatedListPagedResponse

aggregatedListCallable()

public final UnaryCallable<AggregatedListHealthChecksRequest,HealthChecksAggregatedList> aggregatedListCallable()

Retrieves the list of all HealthCheck resources, regional and global, available to the specified project.

Sample code:


 try (HealthChecksClient healthChecksClient = HealthChecksClient.create()) {
   AggregatedListHealthChecksRequest request =
       AggregatedListHealthChecksRequest.newBuilder()
           .setFilter("filter-1274492040")
           .setIncludeAllScopes(true)
           .setMaxResults(1128457243)
           .setOrderBy("orderBy-1207110587")
           .setPageToken("pageToken873572522")
           .setProject("project-309310695")
           .setReturnPartialSuccess(true)
           .build();
   while (true) {
     HealthChecksAggregatedList response =
         healthChecksClient.aggregatedListCallable().call(request);
     for (Map.Entry
Returns
TypeDescription
UnaryCallable<AggregatedListHealthChecksRequest,HealthChecksAggregatedList>

aggregatedListPagedCallable()

public final UnaryCallable<AggregatedListHealthChecksRequest,HealthChecksClient.AggregatedListPagedResponse> aggregatedListPagedCallable()

Retrieves the list of all HealthCheck resources, regional and global, available to the specified project.

Sample code:


 try (HealthChecksClient healthChecksClient = HealthChecksClient.create()) {
   AggregatedListHealthChecksRequest request =
       AggregatedListHealthChecksRequest.newBuilder()
           .setFilter("filter-1274492040")
           .setIncludeAllScopes(true)
           .setMaxResults(1128457243)
           .setOrderBy("orderBy-1207110587")
           .setPageToken("pageToken873572522")
           .setProject("project-309310695")
           .setReturnPartialSuccess(true)
           .build();
   ApiFuture<>
Returns
TypeDescription
UnaryCallable<AggregatedListHealthChecksRequest,AggregatedListPagedResponse>

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 HealthChecksClient create()

Constructs an instance of HealthChecksClient with default settings.

Returns
TypeDescription
HealthChecksClient
Exceptions
TypeDescription
IOException

create(HealthChecksSettings settings)

public static final HealthChecksClient create(HealthChecksSettings settings)

Constructs an instance of HealthChecksClient, 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
settingsHealthChecksSettings
Returns
TypeDescription
HealthChecksClient
Exceptions
TypeDescription
IOException

create(HealthChecksStub stub)

public static final HealthChecksClient create(HealthChecksStub stub)

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

Parameter
NameDescription
stubHealthChecksStub
Returns
TypeDescription
HealthChecksClient

deleteAsync(DeleteHealthCheckRequest request)

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

Deletes the specified HealthCheck resource.

Sample code:


 try (HealthChecksClient healthChecksClient = HealthChecksClient.create()) {
   DeleteHealthCheckRequest request =
       DeleteHealthCheckRequest.newBuilder()
           .setHealthCheck("healthCheck-1938093044")
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .build();
   Operation response = healthChecksClient.deleteAsync(request).get();
 }
 
Parameter
NameDescription
requestDeleteHealthCheckRequest

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

Returns
TypeDescription
OperationFuture<Operation,Operation>

deleteAsync(String project, String healthCheck)

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

Deletes the specified HealthCheck resource.

Sample code:


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

Project ID for this request.

healthCheckString

Name of the HealthCheck resource to delete.

Returns
TypeDescription
OperationFuture<Operation,Operation>

deleteCallable()

public final UnaryCallable<DeleteHealthCheckRequest,Operation> deleteCallable()

Deletes the specified HealthCheck resource.

Sample code:


 try (HealthChecksClient healthChecksClient = HealthChecksClient.create()) {
   DeleteHealthCheckRequest request =
       DeleteHealthCheckRequest.newBuilder()
           .setHealthCheck("healthCheck-1938093044")
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .build();
   ApiFuture
Returns
TypeDescription
UnaryCallable<DeleteHealthCheckRequest,Operation>

deleteOperationCallable()

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

Deletes the specified HealthCheck resource.

Sample code:


 try (HealthChecksClient healthChecksClient = HealthChecksClient.create()) {
   DeleteHealthCheckRequest request =
       DeleteHealthCheckRequest.newBuilder()
           .setHealthCheck("healthCheck-1938093044")
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .build();
   OperationFuture
Returns
TypeDescription
OperationCallable<DeleteHealthCheckRequest,Operation,Operation>

get(GetHealthCheckRequest request)

public final HealthCheck get(GetHealthCheckRequest request)

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

Sample code:


 try (HealthChecksClient healthChecksClient = HealthChecksClient.create()) {
   GetHealthCheckRequest request =
       GetHealthCheckRequest.newBuilder()
           .setHealthCheck("healthCheck-1938093044")
           .setProject("project-309310695")
           .build();
   HealthCheck response = healthChecksClient.get(request);
 }
 
Parameter
NameDescription
requestGetHealthCheckRequest

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

Returns
TypeDescription
HealthCheck

get(String project, String healthCheck)

public final HealthCheck get(String project, String healthCheck)

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

Sample code:


 try (HealthChecksClient healthChecksClient = HealthChecksClient.create()) {
   String project = "project-309310695";
   String healthCheck = "healthCheck-1938093044";
   HealthCheck response = healthChecksClient.get(project, healthCheck);
 }
 
Parameters
NameDescription
projectString

Project ID for this request.

healthCheckString

Name of the HealthCheck resource to return.

Returns
TypeDescription
HealthCheck

getCallable()

public final UnaryCallable<GetHealthCheckRequest,HealthCheck> getCallable()

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

Sample code:


 try (HealthChecksClient healthChecksClient = HealthChecksClient.create()) {
   GetHealthCheckRequest request =
       GetHealthCheckRequest.newBuilder()
           .setHealthCheck("healthCheck-1938093044")
           .setProject("project-309310695")
           .build();
   ApiFuture
Returns
TypeDescription
UnaryCallable<GetHealthCheckRequest,HealthCheck>

getSettings()

public final HealthChecksSettings getSettings()
Returns
TypeDescription
HealthChecksSettings

getStub()

public HealthChecksStub getStub()
Returns
TypeDescription
HealthChecksStub

insertAsync(InsertHealthCheckRequest request)

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

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

Sample code:


 try (HealthChecksClient healthChecksClient = HealthChecksClient.create()) {
   InsertHealthCheckRequest request =
       InsertHealthCheckRequest.newBuilder()
           .setHealthCheckResource(HealthCheck.newBuilder().build())
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .build();
   Operation response = healthChecksClient.insertAsync(request).get();
 }
 
Parameter
NameDescription
requestInsertHealthCheckRequest

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

Returns
TypeDescription
OperationFuture<Operation,Operation>

insertAsync(String project, HealthCheck healthCheckResource)

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

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

Sample code:


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

Project ID for this request.

healthCheckResourceHealthCheck

The body resource for this request

Returns
TypeDescription
OperationFuture<Operation,Operation>

insertCallable()

public final UnaryCallable<InsertHealthCheckRequest,Operation> insertCallable()

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

Sample code:


 try (HealthChecksClient healthChecksClient = HealthChecksClient.create()) {
   InsertHealthCheckRequest request =
       InsertHealthCheckRequest.newBuilder()
           .setHealthCheckResource(HealthCheck.newBuilder().build())
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .build();
   ApiFuture
Returns
TypeDescription
UnaryCallable<InsertHealthCheckRequest,Operation>

insertOperationCallable()

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

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

Sample code:


 try (HealthChecksClient healthChecksClient = HealthChecksClient.create()) {
   InsertHealthCheckRequest request =
       InsertHealthCheckRequest.newBuilder()
           .setHealthCheckResource(HealthCheck.newBuilder().build())
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .build();
   OperationFuture
Returns
TypeDescription
OperationCallable<InsertHealthCheckRequest,Operation,Operation>

isShutdown()

public boolean isShutdown()
Returns
TypeDescription
boolean

isTerminated()

public boolean isTerminated()
Returns
TypeDescription
boolean

list(ListHealthChecksRequest request)

public final HealthChecksClient.ListPagedResponse list(ListHealthChecksRequest request)

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

Sample code:


 try (HealthChecksClient healthChecksClient = HealthChecksClient.create()) {
   ListHealthChecksRequest request =
       ListHealthChecksRequest.newBuilder()
           .setFilter("filter-1274492040")
           .setMaxResults(1128457243)
           .setOrderBy("orderBy-1207110587")
           .setPageToken("pageToken873572522")
           .setProject("project-309310695")
           .setReturnPartialSuccess(true)
           .build();
   for (HealthCheck element : healthChecksClient.list(request).iterateAll()) {
     // doThingsWith(element);
   }
 }
 
Parameter
NameDescription
requestListHealthChecksRequest

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

Returns
TypeDescription
HealthChecksClient.ListPagedResponse

list(String project)

public final HealthChecksClient.ListPagedResponse list(String project)

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

Sample code:


 try (HealthChecksClient healthChecksClient = HealthChecksClient.create()) {
   String project = "project-309310695";
   for (HealthCheck element : healthChecksClient.list(project).iterateAll()) {
     // doThingsWith(element);
   }
 }
 
Parameter
NameDescription
projectString

Project ID for this request.

Returns
TypeDescription
HealthChecksClient.ListPagedResponse

listCallable()

public final UnaryCallable<ListHealthChecksRequest,HealthCheckList> listCallable()

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

Sample code:


 try (HealthChecksClient healthChecksClient = HealthChecksClient.create()) {
   ListHealthChecksRequest request =
       ListHealthChecksRequest.newBuilder()
           .setFilter("filter-1274492040")
           .setMaxResults(1128457243)
           .setOrderBy("orderBy-1207110587")
           .setPageToken("pageToken873572522")
           .setProject("project-309310695")
           .setReturnPartialSuccess(true)
           .build();
   while (true) {
     HealthCheckList response = healthChecksClient.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<ListHealthChecksRequest,HealthCheckList>

listPagedCallable()

public final UnaryCallable<ListHealthChecksRequest,HealthChecksClient.ListPagedResponse> listPagedCallable()

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

Sample code:


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

patchAsync(PatchHealthCheckRequest request)

public final OperationFuture<Operation,Operation> patchAsync(PatchHealthCheckRequest 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 (HealthChecksClient healthChecksClient = HealthChecksClient.create()) {
   PatchHealthCheckRequest request =
       PatchHealthCheckRequest.newBuilder()
           .setHealthCheck("healthCheck-1938093044")
           .setHealthCheckResource(HealthCheck.newBuilder().build())
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .build();
   Operation response = healthChecksClient.patchAsync(request).get();
 }
 
Parameter
NameDescription
requestPatchHealthCheckRequest

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

Returns
TypeDescription
OperationFuture<Operation,Operation>

patchAsync(String project, String healthCheck, HealthCheck healthCheckResource)

public final OperationFuture<Operation,Operation> patchAsync(String project, 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 (HealthChecksClient healthChecksClient = HealthChecksClient.create()) {
   String project = "project-309310695";
   String healthCheck = "healthCheck-1938093044";
   HealthCheck healthCheckResource = HealthCheck.newBuilder().build();
   Operation response =
       healthChecksClient.patchAsync(project, healthCheck, healthCheckResource).get();
 }
 
Parameters
NameDescription
projectString

Project ID for 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<PatchHealthCheckRequest,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 (HealthChecksClient healthChecksClient = HealthChecksClient.create()) {
   PatchHealthCheckRequest request =
       PatchHealthCheckRequest.newBuilder()
           .setHealthCheck("healthCheck-1938093044")
           .setHealthCheckResource(HealthCheck.newBuilder().build())
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .build();
   ApiFuture
Returns
TypeDescription
UnaryCallable<PatchHealthCheckRequest,Operation>

patchOperationCallable()

public final OperationCallable<PatchHealthCheckRequest,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 (HealthChecksClient healthChecksClient = HealthChecksClient.create()) {
   PatchHealthCheckRequest request =
       PatchHealthCheckRequest.newBuilder()
           .setHealthCheck("healthCheck-1938093044")
           .setHealthCheckResource(HealthCheck.newBuilder().build())
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .build();
   OperationFuture
Returns
TypeDescription
OperationCallable<PatchHealthCheckRequest,Operation,Operation>

shutdown()

public void shutdown()

shutdownNow()

public void shutdownNow()

updateAsync(UpdateHealthCheckRequest request)

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

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

Sample code:


 try (HealthChecksClient healthChecksClient = HealthChecksClient.create()) {
   UpdateHealthCheckRequest request =
       UpdateHealthCheckRequest.newBuilder()
           .setHealthCheck("healthCheck-1938093044")
           .setHealthCheckResource(HealthCheck.newBuilder().build())
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .build();
   Operation response = healthChecksClient.updateAsync(request).get();
 }
 
Parameter
NameDescription
requestUpdateHealthCheckRequest

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

Returns
TypeDescription
OperationFuture<Operation,Operation>

updateAsync(String project, String healthCheck, HealthCheck healthCheckResource)

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

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

Sample code:


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

Project ID for 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<UpdateHealthCheckRequest,Operation> updateCallable()

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

Sample code:


 try (HealthChecksClient healthChecksClient = HealthChecksClient.create()) {
   UpdateHealthCheckRequest request =
       UpdateHealthCheckRequest.newBuilder()
           .setHealthCheck("healthCheck-1938093044")
           .setHealthCheckResource(HealthCheck.newBuilder().build())
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .build();
   ApiFuture
Returns
TypeDescription
UnaryCallable<UpdateHealthCheckRequest,Operation>

updateOperationCallable()

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

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

Sample code:


 try (HealthChecksClient healthChecksClient = HealthChecksClient.create()) {
   UpdateHealthCheckRequest request =
       UpdateHealthCheckRequest.newBuilder()
           .setHealthCheck("healthCheck-1938093044")
           .setHealthCheckResource(HealthCheck.newBuilder().build())
           .setProject("project-309310695")
           .setRequestId("requestId693933066")
           .build();
   OperationFuture
Returns
TypeDescription
OperationCallable<UpdateHealthCheckRequest,Operation,Operation>