# 查询后端云服务器列表 - ListMembers #### 功能介绍 查询指定后端云服务器组的后端云服务器。支持过滤查询和分页查询。如未特殊说明，匹配规则为精确匹配。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=ELB&api=ListMembers&version=v2)中直接运行调试该接口。 #### URI GET /v2/{project_id}/elb/pools/{pool_id}/members 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 操作用户的项目ID。 获取方法详见[获取项目ID](https://support.huaweicloud.com/api-elb/elb_fl_0008.html)。 | | 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](https://support.huaweicloud.com/api-elb/elb_fl_0008.html)。 | | project_id | 否 | String | 此参数和tenant_id参数含义一样，均指后端云服务器所在的项目ID。 获取方法详见[获取项目ID](https://support.huaweicloud.com/api-elb/elb_fl_0008.html)。 | | 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]。 | 表4members字段说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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" } ] } ``` #### 返回码 请参见[状态码](https://support.huaweicloud.com/api-elb/elb_gc_1102.html)。