- 1.65.0 (latest)
- 1.64.0
- 1.63.0
- 1.62.0
- 1.61.0
- 1.59.0
- 1.58.0
- 1.57.0
- 1.56.0
- 1.55.0
- 1.54.0
- 1.53.0
- 1.52.0
- 1.51.0
- 1.50.0
- 1.49.0
- 1.47.0
- 1.46.0
- 1.45.0
- 1.44.0
- 1.43.0
- 1.42.0
- 1.41.0
- 1.40.0
- 1.39.0
- 1.38.0
- 1.37.0
- 1.34.0
- 1.33.0
- 1.32.0
- 1.31.0
- 1.30.0
- 1.29.0
- 1.28.0
- 1.27.0
- 1.26.0
- 1.25.0
- 1.24.0
- 1.23.0
- 1.22.0
- 1.21.0
- 1.20.0
- 1.19.0
- 1.18.0
- 1.17.0
- 1.16.0
- 1.15.0
- 1.14.0
- 1.13.0
- 1.12.1
- 1.11.0
- 1.9.1
- 1.8.1
- 1.7.2
- 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:
- 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 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.
Implements
BackgroundResourceStatic Methods
create()
public static final RegionHealthChecksClient create()
Constructs an instance of RegionHealthChecksClient with default settings.
Type | Description |
RegionHealthChecksClient |
Type | Description |
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.
Name | Description |
settings | RegionHealthChecksSettings |
Type | Description |
RegionHealthChecksClient |
Type | Description |
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).
Name | Description |
stub | RegionHealthChecksStub |
Type | Description |
RegionHealthChecksClient |
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.
Name | Description |
settings | RegionHealthChecksSettings |
RegionHealthChecksClient(RegionHealthChecksStub stub)
protected RegionHealthChecksClient(RegionHealthChecksStub stub)
Name | Description |
stub | RegionHealthChecksStub |
Methods
awaitTermination(long duration, TimeUnit unit)
public boolean awaitTermination(long duration, TimeUnit unit)
Name | Description |
duration | long |
unit | TimeUnit |
Type | Description |
boolean |
Type | Description |
InterruptedException |
close()
public final void close()
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();
}
Name | Description |
request | DeleteRegionHealthCheckRequest The request object containing all of the parameters for the API call. |
Type | Description |
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();
}
Name | Description |
project | String Project ID for this request. |
region | String Name of the region scoping this request. |
healthCheck | String Name of the HealthCheck resource to delete. |
Type | Description |
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<Operation> future = regionHealthChecksClient.deleteCallable().futureCall(request);
// Do something.
Operation response = future.get();
}
Type | Description |
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
Type | Description |
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);
}
Name | Description |
request | GetRegionHealthCheckRequest The request object containing all of the parameters for the API call. |
Type | Description |
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);
}
Name | Description |
project | String Project ID for this request. |
region | String Name of the region scoping this request. |
healthCheck | String Name of the HealthCheck resource to return. |
Type | Description |
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
Type | Description |
UnaryCallable<GetRegionHealthCheckRequest,HealthCheck> |
getSettings()
public final RegionHealthChecksSettings getSettings()
Type | Description |
RegionHealthChecksSettings |
getStub()
public RegionHealthChecksStub getStub()
Type | Description |
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();
}
Name | Description |
request | InsertRegionHealthCheckRequest The request object containing all of the parameters for the API call. |
Type | Description |
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();
}
Name | Description |
project | String Project ID for this request. |
region | String Name of the region scoping this request. |
healthCheckResource | HealthCheck The body resource for this request |
Type | Description |
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<Operation> future = regionHealthChecksClient.insertCallable().futureCall(request);
// Do something.
Operation response = future.get();
}
Type | Description |
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
Type | Description |
OperationCallable<InsertRegionHealthCheckRequest,Operation,Operation> |
isShutdown()
public boolean isShutdown()
Type | Description |
boolean |
isTerminated()
public boolean isTerminated()
Type | Description |
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);
}
}
Name | Description |
request | ListRegionHealthChecksRequest The request object containing all of the parameters for the API call. |
Type | Description |
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);
}
}
Name | Description |
project | String Project ID for this request. |
region | String Name of the region scoping this request. |
Type | Description |
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;
}
}
}
Type | Description |
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
Type | Description |
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();
}
Name | Description |
request | PatchRegionHealthCheckRequest The request object containing all of the parameters for the API call. |
Type | Description |
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();
}
Name | Description |
project | String Project ID for this request. |
region | String Name of the region scoping this request. |
healthCheck | String Name of the HealthCheck resource to patch. |
healthCheckResource | HealthCheck The body resource for this request |
Type | Description |
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<Operation> future = regionHealthChecksClient.patchCallable().futureCall(request);
// Do something.
Operation response = future.get();
}
Type | Description |
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
Type | Description |
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();
}
Name | Description |
request | UpdateRegionHealthCheckRequest The request object containing all of the parameters for the API call. |
Type | Description |
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();
}
Name | Description |
project | String Project ID for this request. |
region | String Name of the region scoping this request. |
healthCheck | String Name of the HealthCheck resource to update. |
healthCheckResource | HealthCheck The body resource for this request |
Type | Description |
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<Operation> future = regionHealthChecksClient.updateCallable().futureCall(request);
// Do something.
Operation response = future.get();
}
Type | Description |
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
Type | Description |
OperationCallable<UpdateRegionHealthCheckRequest,Operation,Operation> |