更新时间:2025-02-24 GMT+08:00

查询后端服务器详情

功能介绍

后端服务器详情。

调用方法

请参见如何调用API

URI

GET /v3/{project_id}/elb/pools/{pool_id}/members/{member_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:项目ID。

pool_id

String

参数解释:后端服务器组ID。

member_id

String

后端服务器ID。

说明:

说明:

此处并非ECS服务器的ID,而是ELB为绑定的后端服务器自动生成的member ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:IAM鉴权Token。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

request_id

String

请求ID。

注:自动生成 。

member

Member object

后端服务器对象。

表4 Member

参数

参数类型

描述

id

String

参数解释:后端服务器ID。

说明:

说明:

此处并非ECS服务器的ID,而是ELB为绑定的后端服务器自动生成的member ID。

name

String

参数解释:后端服务器名称。

注意:该名称并非ECS名称。

project_id

String

参数解释:后端服务器所在的项目ID。

admin_state_up

Boolean

参数解释:后端服务器的管理状态。

约束限制:虽然创建、更新请求支持该字段,但实际取值决定于后端服务器对应的弹性云服务器是否存在。若存在,该值为true,否则,该值为false。

取值范围:true、false。

subnet_cidr_id

String

参数解释:后端服务器所在的子网,可以是IPv4或IPv6子网。若是IPv4子网,使用对应子网的子网ID(neutron_subnet_id);若是IPv6子网,使用对应子网的网络ID(neutron_network_id)。

ipv4子网的子网ID可以通过GET

https://{VPC_Endpoint}/v1/{project_id}/subnets

响应参数中的neutron_subnet_id得到

ipv6子网的网络ID可以通过GET

https://{VPC_Endpoint}/v1/{project_id}/subnets

响应参数中的neutron_network_id得到

约束限制:

  • 该子网和关联的负载均衡器的子网必须在同一VPC下。

  • 若所属LB的跨VPC后端转发特性已开启,则该字段可以不传,表示添加跨VPC的后端服务器。此时address必须为IPv4地址,所在的pool的协议必须为UDP/TCP/TLS/HTTP/HTTPS/QUIC/GRPC。

protocol_port

Integer

参数解释:后端服务器业务端口。

说明:

在开启端口透传的pool下创建member传该字段不生效,可不传该字段。

weight

Integer

参数解释:后端服务器的权重,请求将根据pool配置的负载均衡算法和后端服务器的权重进行负载分发。

权重值越大,分发的请求越多。权重为0的后端不再接受新的请求。

约束限制:若所在pool的lb_algorithm取值为SOURCE_IP或QUIC_CID,该字段无效。

取值范围:0-100

默认取值:1。

address

String

参数解释:后端服务器对应的IP地址。

约束限制:

  • 若subnet_cidr_id为空,表示添加跨VPC后端,此时address必须为IPv4地址。

  • 若subnet_cidr_id不为空,表示是一个关联到ECS的后端服务器。该IP地址可以是私网IPv4或IPv6。

    但必须在subnet_cidr_id对应的子网网段中。

ip_version

String

参数解释:当前后端服务器的IP地址版本,由后端系统自动根据传入的address字段确定。

取值范围:v4、v6。

operating_status

String

参数解释:后端服务器的健康状态。当status非空时,以status字段中监听器粒度的健康检查状态优先。

取值范围:

  • ONLINE:后端服务器正常。

  • NO_MONITOR:后端服务器所在的服务器组没有健康检查器。

  • OFFLINE:后端服务器关联的ECS服务器不存在或已关机。

status

Array of MemberStatus objects

参数解释:后端服务器监听器粒度的的健康状态。

约束限制:

  • 若绑定的监听器在该字段中,则以该字段中监听器对应的operating_stauts为准。

  • 若绑定的监听器不在该字段中,则以外层的operating_status为准。

reason

MemberHealthCheckFailedReason object

健康检查异常的原因。

created_at

String

参数解释:创建时间。格式:yyyy-MM-dd'T'HH:mm:ss'Z',UTC时区。

注意:独享型实例的历史数据以及共享型实例下的资源,不返回该字段。

updated_at

String

参数解释:更新时间。格式:yyyy-MM-dd'T'HH:mm:ss'Z',UTC时区。

注意:独享型实例的历史数据以及共享型实例下的资源,不返回该字段。

member_type

String

参数解释:后端服务器的类型。

取值范围:

  • ip:跨VPC的member。

  • instance:关联到ECS的member。

instance_id

String

参数解释:member关联的实例ID。空表示member关联的实例为非真实设备 (如:跨VPC场景)

表5 MemberStatus

参数

参数类型

描述

listener_id

String

参数解释:监听器ID

operating_status

String

参数解释:后端服务器的健康状态。

取值范围:

  • ONLINE:后端服务器正常。

  • NO_MONITOR:后端服务器所在的服务器组没有健康检查器。

  • OFFLINE:后端服务器关联的ECS服务器不存在或已关机。

reason

MemberHealthCheckFailedReason object

健康检查异常的原因。

表6 MemberHealthCheckFailedReason

参数

参数类型

描述

reason_code

String

参数解释:健康检查异常原因码。

取值范围:

  • CONNECT_TIMEOUT: 负载均衡健康检查时向后端服务器建立连接超时。

  • CONNECT_REFUSED: 负载均衡健康检查时向后端服务器拒绝连接。

  • CONNECT_FAILED: 负载均衡健康检查时向后端服务器建立连接失败。

  • CONNECT_INTERRUPT: 负载均衡健康检查与后端服务器连接中断。

  • SSL_HANDSHAKE_ERROR: 负载均衡健康检查时与后端服务器SSL握手失败。

  • RECV_RESPONSE_FAILED: 负载均衡健康检查时从后端服务器接收响应失败。

  • RECV_RESPONSE_TIMEOUT: 负载均衡健康检查时从后端服务器接收响应超时。

  • SEND_REQUEST_FAILED: 负载均衡健康检查时向后端服务器发送请求失败。

  • SEND_REQUEST_TIMEOUT: 负载均衡健康检查时向后端服务器发送请求超时。

  • RESPONSE_FORMAT_ERROR: 负载均衡健康检查时从后端服务器接收响应格式错误。

  • RESPONSE_MISMATCH: 负载均衡健康检查时从后端服务器接收的响应码与预期配置返回码不一致。

expected_response

String

参数解释:健康检查预期响应状态码。

支持HTTP,HTTPS,GRPC健康检查。

只有reason_code为RESPONSE_MISMATCH时,支持非null取值。

取值范围:

  • 单值:单个返回码。当type为GRPC时,取值范围为0-99;当type为其他协议时,取值范围为200-599。例如:"0"或"200"。

  • 列表:多个特定返回码,逗号分隔,最多支持5个返回码。例如:"200,202"或"0,1"。

  • 区间:一个返回码区间,区间内"-"分隔,区间之间逗号分隔,最多支持5个区间。例如"200-204,300-399"或"0-5,10-12,20-30"。

healthcheck_response

String

参数解释:健康检查探测实际响应状态码。

支持HTTP,HTTPS,GRPC健康检查。

只有reason_code为RESPONSE_MISMATCH时,支持非null取值。

取值范围:

  • 单个返回码。当type为GRPC时,取值范围为0-99;当type为其他协议时,取值范围为200-599。例如:"0"或"200"。

请求示例

查询后端服务器详情

GET https://{ELB_Endpoint}/v3/99a3fff0d03c428eac3678da6a7d0f24/elb/pools/36ce7086-a496-4666-9064-5ba0e6840c75/members/1923923e-fe8a-484f-bdbc-e11559b1f48f

响应示例

状态码:200

操作正常返回。

{
  "member" : {
    "name" : "My member",
    "weight" : 10,
    "admin_state_up" : false,
    "subnet_cidr_id" : "c09f620e-3492-4429-ac15-445d5dd9ca74",
    "project_id" : "99a3fff0d03c428eac3678da6a7d0f24",
    "address" : "120.10.10.16",
    "protocol_port" : 89,
    "id" : "1923923e-fe8a-484f-bdbc-e11559b1f48f",
    "operating_status" : "NO_MONITOR",
    "ip_version" : "v4"
  },
  "request_id" : "45688823-45f1-40cd-9d24-e51a9574a45b"
}

状态码

状态码

描述

200

操作正常返回。

错误码

请参见错误码