• Elastic Load Balancing

elb
  1. Help Center
  2. Elastic Load Balancing
  3. API Reference
  4. Enhanced Load Balancer APIs
  5. Load Balancer
  6. Querying Details of a Load Balancer

Querying Details of a Load Balancer

Function

This API is used to query details about a load balancer using its ID.

URI

GET /v2.0/lbaas/loadbalancers/{loadbalancer_id}

Table 1 Parameter description

Parameter

Type

Mandatory

Description

loadbalancer_id

Uuid

Yes

Specifies the load balancer ID.

Request

None

Response

Table 2 Parameter description

Parameter

Type

Description

loadbalancer

Dict

Specifies the load balancer. For details, see Table 3.

Table 3 loadbalancer field description

Parameter

Type

Description

id

Uuid

Specifies the load balancer ID.

tenant_id

String (255)

Specifies the ID of the project where the load balancer is used.

name

String (255)

Specifies the load balancer name.

description

String (255)

Provides supplementary information about the load balancer.

vip_subnet_id

Uuid

Specifies the ID of the subnet where the load balancer works.

vip_port_id

Uuid

Specifies the ID of the port bound to the load balancer IP address.

provider

String

Specifies the provider of the load balancer.

vip_address

String (64)

Specifies the IP address of the load balancer.

listeners

List

Lists the IDs of listeners added to the load balancer.

pools

List

Lists the IDs of backend server groups associated with the load balancer.

operating_status

String (16)

Specifies the operating status of the load balancer.

The value can be ONLINE, OFFLINE, DEGRADED, DISABLED, or NO_MONITOR.

This parameter is reserved and has been not used. The default value is ONLINE.

provisioning_status

String (16)

Specifies the provisioning status of the load balancer.

The value can be ACTIVE, PENDING_CREATE, or ERROR.

This parameter is reserved and has been not used. The default value is ACTIVE.

admin_state_up

Bool

Specifies the administrative status of the load balancer.

This parameter is reserved and has been not used. The default value is true.

tags

List

Lists load balancer tags.

created_at

String (19)

Specifies the time when the load balancer was created.

The time is in YYYY-MM-DDTHH:MM:SS format.

updated_at

String (19)

Specifies the time when the load balancer was updated.

The time is in YYYY-MM-DDTHH:MM:SS format.

Example

  • Example request: Querying details about a load balancer using its ID
    GET https://{Endpoint}/v2.0/lbaas/loadbalancers/3d77894d-2ffe-4411-ac0a-0d57689779b8
  • Example response
    {
        "loadbalancer": {
            "description": "",
            "admin_state_up": true,
            "tenant_id": "1867112d054b427e808cc6096d8193a1",
            
            "provisioning_status": "ACTIVE",
            "vip_subnet_id": "4f5e8efe-fbbe-405e-b48c-a41202ef697c",
            "listeners": [
                {
                    "id": "09e64049-2ab0-4763-a8c5-f4207875dc3e"
                }
            ],
            "vip_address": "192.168.2.4",
            "vip_port_id": "c7157e7a-036a-42ca-8474-100be22e3727",
            "provider": "vlb",
            "pools": [
                {
                    "id": "b7e53dbd-62ab-4505-a280-5c066078a5c9"
                }
            ],
            "id": "3d77894d-2ffe-4411-ac0a-0d57689779b8",
            "operating_status": "ONLINE",
            "tags": [],
            "name": "lb-2",
            "created_at": "2018-07-25T01:54:13", 
            "updated_at": "2018-07-25T01:54:14"
        }
    }

Response Codes

For details, see HTTP Status Codes for Enhanced Load Balancers.