更新时间:2024-04-08 GMT+08:00

查询后端云服务器列表

功能介绍

普通用户可查询指定监听器下后端服务器列表。管理员用户查询后端服务器列表为空列表。

URI

GET /v1.0/{project_id}/elbaas/listeners/{listener_id}/members?limit=10&marker=0

可以在URI后面用‘?’和‘&’添加不同的查询条件组合。支持除listeners、server_name、update_time和create_time之外所有响应要素过滤。

表1 参数说明

参数

是否必选

参数类型

描述

project_id

String

操作用户的项目ID

listener_id

String

监听器的ID

marker

String

分页查询起始的资源id,为空时为查询第一页

limit

Integer

每页返回的个数。

请求消息

  • 请求参数

  • 请求样例

响应消息

  • 响应参数
    表2 响应参数

    参数

    参数类型

    描述

    server_address

    String

    后端云服务器私网IP。

    id

    String

    后端云服务器ID。

    address

    String

    分配给后端云服务器的浮动IP。

    status

    String

    后端云服务器状态。状态值:ACTIVE,PENDING,ERROR。

    health_status

    String

    健康检查状态。状态值:NORMAL,ABNORMAL,UNAVAILABLE。

    update_time

    String

    更新时间。

    create_time

    String

    创建时间。

    server_name

    String

    后端云服务器名称。

    server_id

    String

    原始云服务器ID。

    listeners

    Array

    后端云服务器所属监听器。

    表3 listeners字段数据结构说明

    参数

    参数类型

    描述

    id

    String

    后端云服务器所属监听器ID。

  • 响应样例
    [
        {
            "server_address": "172.16.0.16",
            "id": "4ac8777333bc20777147ab160ea61baf",
            "status": "ACTIVE",
            "address": "100.64.27.96",
            "listeners": [
                {
                    "id": "65093734fb966b3d70f6af26cc63e125"
                },
                {
                    "id": "a659fe780a542e1adf204db767a021a3"
                }
            ],
            "update_time": "2015-12-28 10:35:51",
            "create_time": "2015-12-28 10:35:50",
            "server_name": null,
            "server_id": "97444148-7afb-47cc-b4a3-6e1c94d1ade4",
            "health_status": "NORMAL"
        },
        {
            "server_address": "172.16.0.15",
            "id": "d8a21f107a19d7bd1d05a1f764eb623a",
            "status": "ACTIVE",
            "address": "100.64.27.95",
            "listeners": [
                {
                    "id": "65093734fb966b3d70f6af26cc63e125"
                },
                {
                    "id": "a659fe780a542e1adf204db767a021a3"
                }
            ],
            "update_time": "2015-12-28 10:35:51",
            "create_time": "2015-12-28 10:35:50",
            "server_name": null,
            "server_id": "05b731db-d457-41dc-a824-862daba91a59",
            "health_status": "ABNORMAL"
        }
    ]

状态码

  • 正常

    200

  • 异常

    状态码

    编码

    错误码说明

    400

    badRequest

    请求错误

    401

    unauthorized

    鉴权失败

    403

    userDisabled

    没有权限

    404

    Not Found

    请求的页面不存在

    500

    authFault

    内部错误

    503

    serviceUnavailable

    服务不可用