Query the health status of the backend servers.

Request parameters

Name  Parameters Required Description
Action String Yes The action to perform. Valid value:

DescribeHealthStatus

RegionId String  Yes The region ID of the SLB instance.
LoadBalancerId String   Yes The ID of the SLB instance.
ListenerPort Integer No  The front-end port of the listener. Valid value:

Valid value: 1-65535

Note If no port is specified, the health check status of all ports is returned.

Response parameters

Name Type Description
RequestId String The ID of the request.
BackendServers List A list of backend servers.
Table 1. BackendServer
Name  Type Description
ServerId String The ID of the ECS instance
ServerHealthStatus String The health check status of the backend server:
  • normal: The backend server is healthy.
  • abnormal: The backend server is unhealthy.
  • unavailable: The health check is not completed yet.

Examples

Request example

https://slb.aliyuncs.com/?Action=DescribeHealthStatus
&LoadBalancerId=lb-t4nj5vuz8ish9emfk1f20
&ListenerPort=80
&CommonParameters

Response example

  • XML format
    <? xml version="1.0" encoding="UTF-8"? >
    <DescribeHealthStatusResponse>
    	<RequestId>365F4154-92F6-4AE4-92F8-7FF34B540710</RequestId>
    	<BackendServers>
    		<BackendServer>
    			<ServerId>vm-233</ServerId>
    			<ServerHealthStatus>normal</ServerHealthStatus>
    		</BackendServer>
    		<BackendServer>
    			<ServerId>vm-234</ServerId>
    			<ServerHealthStatus>abnormal</ServerHealthStatus>
    		</BackendServer>
    	</BackendServers>
    </DescribeHealthStatusResponse>
  • JSON format
    {
      "RequestId": "365F4154-92F6-4AE4-92F8-7FF34B540710",
      "LoadBalancerId": "139a00604ad-cn-east-hangzhou-01",
      "BackendServers": {
        "BackendServer": [
          {
            "ServerId": "vm-233",
            "ServerHealthStatus": "normal"
          },
          {
            "ServerId": "vm-234",
            "ServerHealthStatus": "abnormal"
          }
        ]
      }
    }