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

查询负载均衡器列表

功能介绍

查询某用户下所有的负载均衡器的信息。

URI

GET /v1.0/{project_id}/elbaas/loadbalancers

表1 参数说明

参数

是否必选

参数类型

描述

project_id

String

操作用户的项目ID。

请求消息

  • 请求参数

  • 请求样例

响应消息

  • 响应参数
    表2 响应参数

    参数

    参数类型

    描述

    loadbalancers

    Array

    负载均衡器信息列表。

    instance_num

    String

    负载均衡器的个数。

    表3 loadbalancers字段数据结构说明

    参数

    参数类型

    描述

    vip_address

    String

    ELB对外服务IP。

    update_time

    String

    更新时间。

    create_time

    String

    创建时间。

    id

    String

    负载均衡器的ID。

    status

    String

    • 负载均衡器的状态。
    • 取值范围:ACTIVE,PENDING_CREATE,ERROR。

    bandwidth

    Integer

    带宽大小。

    vpc_id

    String

    VPC ID。

    admin_state_up

    Integer

    • 弹性负载均衡器的管理状态。
    • 取值范围:

      0:停用。

      1:正常。

      2:冻结。

    vip_subnet_id

    String

    该参数暂不支持。

    type

    String

    负载均衡器类型: External。

    name

    String

    负载均衡器名称。

    description

    String

    描述。

    security_group_id

    String

    • 字段含义:安全组的ID。
    • 说明:参数type的值为External时,该字段返回值为null
  • 响应样例
    {
        "loadbalancers": [
            {
                "vip_address": "192.144.62.114",
                "update_time": "2015-09-14 02:34:32",
                "create_time": "2015-09-14 02:34:32",
                "id": "0b07acf06d243925bc24a0ac7445267a",
                "status": "ACTIVE",
                "bandwidth": 1,
                "security_group_id": null,
                "vpc_id": "f54a3ffd-7a55-4568-9e3d-f0ff2d46a107",
                "admin_state_up": 1,
                "vip_subnet_id": null,
                "type": "External",
                "name": "MY_ELB",
                "description": null
            }
        ],
        "instance_num": "1"
    }

状态码

  • 正常

    200

  • 异常

    状态码

    编码

    错误码说明

    400

    badRequest

    请求错误

    401

    unauthorized

    鉴权失败

    403

    userDisabled

    没有权限

    404

    Not Found

    请求的页面不存在

    500

    authFault

    内部错误

    503

    serviceUnavailable

    服务不可用