文档首页/ 弹性负载均衡 ELB/ API参考/ API（V2）/ 后端云服务器/ 查询后端云服务器列表
更新时间：2025-04-30 GMT+08:00
查看PDF
分享

查询后端云服务器列表

功能介绍

查询指定后端云服务器组的后端云服务器。支持过滤查询和分页查询。如未特殊说明，匹配规则为精确匹配。

调试

您可以在API Explorer中直接运行调试该接口。

URI

GET /v2/{project_id}/elb/pools/{pool_id}/members

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

操作用户的项目ID。

获取方法详见获取项目ID。

pool_id

是

String

后端云服务器组id。
表2 查询参数

参数

是否必选

参数类型

描述

marker

否

String

分页查询的起始的资源ID，表示上一页最后一条查询记录的后端云服务器的ID。不指定时表示查询第一页。

必须与limit一起使用。

limit

否

Integer

分页查询每页的后端云服务器个数。如果不设置，则默认不分页查询所有后端云服务器。

page_reverse

否

Boolean

分页的顺序，true表示从后往前分页，false表示从前往后分页，默认为false。

必须与limit一起使用。

id

否

String

后端云服务器的ID。

说明：

此处并非服务器的ID，而是ELB添加后端服务器之后自动生成的member ID。

tenant_id

否

String

后端云服务器所属的项目ID。

支持的最大字符长度：255

获取方法详见获取项目ID。

project_id

否

String

此参数和tenant_id参数含义一样，均指后端云服务器所在的项目ID。

获取方法详见获取项目ID。

name

否

String

后端云服务器的名称。

支持的最大字符长度：255

说明：

此处并非服务器的名称，而是ELB添加后端服务器之后生成的member名称。

address

否

String

后端云服务器对应的IP地址。

支持的最大字符长度：64

protocol_port

否

Integer

后端云服务器后端端口的协议号。

subnet_id

否

String

后端云服务器所在的子网ID。

admin_state_up

否

Boolean

后端云服务器的管理状态。

该字段为预留字段，暂未启用。默认为true。

weight

否

Integer

后端云服务器的权重。

enterprise_project_id

否

String

企业项目ID。

  • 如果enterprise_project_id不传值，默认查询所有企业项目下的资源，鉴权按照细粒度权限鉴权，必须在用户组下分配elb:*list权限。
  • 如果enterprise_project_id传值，分为传具体eps_id和all_granted_eps两种场景，前者查询指定eps_id的eps下的资源，后者查询的是所有有list权限的eps下的资源。

请求消息

无

响应消息

表3 响应参数

参数

参数类型

描述

members

Array of Members objects

属于某个后端云服务器组的后端云服务器对象列表。对象详见表4。
表4 members字段说明

参数

参数类型

描述

id

String

后端云服务器的 ID。

说明：

此处并非服务器的ID，而是ELB添加后端服务器之后自动生成的member ID。

tenant_id

String

后端云服务器所在的项目ID。

支持的最大字符长度：255

project_id

String

此参数和tenant_id参数含义一样，均指后端云服务器所在的项目ID。

name

String

后端云服务器的名称。

支持的最大字符长度：255

address

String

后端云服务器对应的IP地址，该IP必须在subnet_id字段指定子网的网段中，例如192.168.3.11。

只能对应主网卡的IP。

支持的最大字符长度：64

protocol_port

Integer

后端端口和协议号，取值范围[1，65535]。

subnet_id

String

后端云服务器所在的子网ID。后端云服务器的IP地址在该子网的网段中。

不支持开启了ipv6的子网。

admin_state_up

Boolean

后端云服务器的管理状态。

该字段为预留字段，暂未启用。取值范围：true/false。

  • true表示开启。
  • false表示关闭。

weight

Integer

后端云服务器的权重，取值范围[0，100]。

权重为0的后端不再接受新的请求。默认为1。

operating_status

String

后端云服务器的健康状态，取值：

  • ONLINE，后端服务器正常运行。
  • NO_MONITOR，后端服务器无健康检查。
  • OFFLINE，已下线。

请求示例

  • 请求样例1 全量查询后端云服务器 
    GET https://{Endpoint}/v2/1a3e005cf9ce40308c900bcb08e5320c/elb/pools/5a9a3e9e-d1aa-448e-af37-a70171f2a332/members
  • 请求样例2 过滤查询ip为10.0.0.8且端口为80的后端云服务器 
    GET https://{Endpoint}/v2/1a3e005cf9ce40308c900bcb08e5320c/elb/pools/5a9a3e9e-d1aa-448e-af37-a70171f2a332/members?address=10.0.0.8&protocol_port=80

响应示例

  • 响应样例1 
    {
    "members": [
        {
            "address": "10.0.0.8", 
            "admin_state_up": true, 
            "id": "9a7aff27-fd41-4ec1-ba4c-3eb92c629313", 
            "protocol_port": 80, 
            "subnet_id": "013d3059-87a4-45a5-91e9-d721068ae0b2", 
            "tenant_id": "1a3e005cf9ce40308c900bcb08e5320c",
            "project_id": "1a3e005cf9ce40308c900bcb08e5320c",
            "weight": 1, 
            "operating_status": "ONLINE", 
            "name": "member-name"
        }
    ]
}
  • 响应样例2 
    {
    "members": [
        {
            "address": "10.0.0.8", 
            "admin_state_up": true, 
            "id": "9a7aff27-fd41-4ec1-ba4c-3eb92c629313", 
            "protocol_port": 80, 
            "subnet_id": "013d3059-87a4-45a5-91e9-d721068ae0b2", 
            "tenant_id": "1a3e005cf9ce40308c900bcb08e5320c",
            "project_id": "1a3e005cf9ce40308c900bcb08e5320c",
            "weight": 1, 
            "operating_status": "ONLINE", 
            "name": "member-name"
        }
    ]
}

返回码

请参见状态码。

父主题： 后端云服务器

相关文档