Liệt kê load balancer

GET/v2/lbaas/loadbalancers

Liệt kê các load balancer trong project của bạn kèm VIP, trạng thái provisioning và các listener, pool gắn với chúng.

info

Nguồn: list-load-balancers

Request

Tham số query

project_idstring

Project cần query. Chỉ admin mới có thể query project khác.

fieldsstring

Chỉ trả về các thuộc tính được liệt kê. Có thể lặp lại, ví dụ fields=id&fields=name.

Request mẫu

curl -ks -H 'Content-Type: application/json' -H 'X-Auth-Token: gAAAAA<...>' \
https://api.vietnix.cloud:9888/v2/lbaas/loadbalancers

Response

loadbalancersarraybắt buộc

Danh sách object load balancer.

idstringbắt buộc

ID của load balancer.

namestringbắt buộc

Tên dễ đọc.

descriptionstringbắt buộc

Mô tả tự do.

provisioning_statusstringbắt buộc

PENDING_CREATE, ACTIVE, PENDING_UPDATE, PENDING_DELETE, ERROR và các giá trị tương tự.

operating_statusstringbắt buộc

ONLINE, OFFLINE, DEGRADED, ERROR và các giá trị tương tự.

vip_addressstringbắt buộc

Địa chỉ IP của virtual IP (VIP).

vip_subnet_idstringbắt buộc

Subnet của VIP.

vip_network_idstringbắt buộc

Network của VIP.

vip_port_idstringbắt buộc

Port mang VIP.

listenersarraybắt buộc

Danh sách ID listener gắn với load balancer.

poolsarraybắt buộc

Danh sách ID pool gắn với load balancer.

providerstringbắt buộc

Driver provider, ví dụ amphora.

admin_state_upbooleanbắt buộc

Trạng thái quản trị.

tagsarraybắt buộc

Các tag trên tài nguyên.

created_at / updated_atstringbắt buộc

Timestamp ISO 8601.

Response mẫu

Response body

{
  "loadbalancers": [
    {
      "id": "3f2a1b9c-6d4e-4f70-8a11-2c3d4e5f6a70",
      "name": "lb2",
      "description": "",
      "provisioning_status": "ACTIVE",
      "operating_status": "ONLINE",
      "provider": "amphora",
      "vip_address": "192.168.10.5",
      "vip_subnet_id": "fd2de462-f93b-43a6-9b5c-254f1e690bf1",
      "vip_network_id": "15f7dc0a-712c-422f-bfd3-31dc351d9026",
      "vip_port_id": "fb0e8e3e-2a71-420a-885c-94f6d2c2f2b7",
      "listeners": [
        {
          "id": "1dc8539c-7545-4ae8-8081-3140a47b6342"
        }
      ],
      "pools": [
        {
          "id": "bd04cc50-0575-45cc-a965-514357a4b62d"
        }
      ],
      "admin_state_up": true,
      "tags": [],
      "created_at": "2026-03-20T12:58:20",
      "updated_at": null
    }
  ]
}

Mã trạng thái

Thành công

Mã	Mô tả
200 - OK	Request thành công.

Lỗi

Mã	Mô tả
401 - Unauthorized	Cần xác thực trước khi gửi request.
403 - Forbidden	Policy không cho phép user hiện tại thực hiện thao tác này.
500 - Internal Server Error	Service xử lý request thất bại.
503 - Service Unavailable	Dịch vụ cân bằng tải không khả dụng.

note

Load balancer ở trạng thái PENDING_CREATE hoặc PENDING_UPDATE vẫn đang được provisioning. Chờ đến khi ACTIVE trước khi thêm hoặc xoá member.