- HTTP request
- Path parameters
- Request body
- Response body
- Authorization Scopes
- IAM Permissions
- Examples
- Try it!
Gets the most recent health check results for each IP for the instance that is referenced by the given target pool.
HTTP request
POST https://compute.googleapis.com/compute/v1/projects/{project}/regions/{region}/targetPools/{resourceId}/getHealth
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
project |
Project ID for this request. |
region |
Name of the region scoping this request. |
resourceId |
Name of the TargetPool resource to which the queried instance belongs. |
Request body
The request body contains data with the following structure:
JSON representation | |
---|---|
{ "instance": string } |
Fields | |
---|---|
instance |
The URL for a specific instance. @required compute.instancegroups.addInstances/removeInstances |
Response body
If successful, the response body contains data with the following structure:
JSON representation | |
---|---|
{ "healthStatus": [ { "ipAddress": string, "port": integer, "instance": string, "healthState": enum, "annotations": { string: string, ... }, "weight": string, "weightError": enum } ], "kind": string } |
Fields | |
---|---|
healthStatus[] |
|
healthStatus[].ipAddress |
A forwarding rule IP address assigned to this instance. |
healthStatus[].port |
The named port of the instance group, not necessarily the port that is health-checked. |
healthStatus[].instance |
URL of the instance resource. |
healthStatus[].healthState |
Health state of the instance. |
healthStatus[].annotations |
Metadata defined as annotations for network endpoint. An object containing a list of |
healthStatus[].weight |
|
healthStatus[].weightError |
|
kind |
[Output Only] Type of resource. Always |
Authorization Scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/compute
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.
IAM Permissions
In addition to any permissions specified on the fields above, authorization requires one or more of the following IAM permissions:
compute.targetPools.get