Showing load balancer details

GET /v2/lbaas/loadbalancers/{loadbalancer_id}

Show the details of a load balancer with the specified ID.

If you are not an administrative user and the load balancer object does not belong to your project, the service returns the HTTP Forbidden (403) response code.

Source: https://docs.openstack.org/api-ref/load-balancer/v2/index.html?expanded=show-load-balancer-details-detail#show-load-balancer-details

Request

Parameters

Name	In	Type	Description
`loadbalancer_id`	path	uuid	The ID of the load balancer to query.
`fields` (Optional)	query	string	The fields that you want the server to return. If no `fields` query parameter is specified, the networking API returns all attributes allowed by the policy settings. By using the `fields` parameter, the API returns only the requested set of attributes. The `fields` parameter can be specified multiple times. For example, if you specify `fields=id&fields=name` in the request URL, only the `id` and `name` attributes will be returned.

Example

# curl -ks -H 'Content-Type: application/json' -H 'X-Auth-Token: gAAAAA<...>' \
https://<node_IP_addr>:9888/v2/lbaas/loadbalancers/601be015-0753-4221-931c-d26d81248551

Response

Parameters

Name	In	Type	Description
`loadbalancer`	body	object	A `loadbalancer` object.
`admin_state_up`	body	boolean	The administrative state of the resource, which is up (`true`) or down (`false`).
`created_at`	body	string	The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm For example, `2015-08-27T09:49:58-05:00`. The `±hh:mm` value, if included, is the time zone as an offset from UTC. In this example, the offset value is `-05:00`.
`description`	body	string	A human-readable description for the resource.
`flavor_id`	body	uuid	The ID of the flavor.
`id`	body	uuid	The ID of the load balancer.
`listeners`	body	array	The associated listener IDs, if any.
`name`	body	string	Human-readable name of the resource.
`operating_status`	body	string	The operating status of the resource.
`pools`	body	array	The associated pool IDs, if any.
`project_id`	body	string	The ID of the project owning this resource.
`provider`	body	string	Provider name for the load balancer.
`provisioning_status`	body	string	The provisioning status of the resource.
`tags`	body	list	A list of simple strings assigned to the resource. New in version 2.5
`updated_at`	body	string	The date and time when the resource was updated. If the resource has not been updated, this field will be `null`. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm For example, `2015-08-27T09:49:58-05:00`. The `±hh:mm` value, if included, is the time zone as an offset from UTC. In this example, the offset value is `-05:00`.
`vip_address`	body	string	The IP address of the Virtual IP (VIP).
`vip_network_id`	body	uuid	The ID of the network for the Virtual IP (VIP).
`vip_port_id`	body	uuid	The ID of the Virtual IP (VIP) port.
`vip_qos_policy_id`	body	uuid	The ID of the QoS Policy which will apply to the Virtual IP (VIP).
`vip_subnet_id`	body	uuid	The ID of the subnet for the Virtual IP (VIP).

Status codes

Success

Code	Reason
`200 - OK`	Request was successful.

Error

Code	Reason
`401 - Unauthorized`	User must authenticate before making a request.
`403 - Forbidden`	Policy does not allow current user to do this operation.
`404 - Not Found`	The requested resource could not be found.
`500 - Internal Server Error`	Something went wrong inside the service. This should not happen usually. If it does happen, it means the server has experienced some serious problems.

Example

{
  "loadbalancer": {
    "provider": "amphora",
    "description": "",
    "admin_state_up": true,
    "pools": [
      {
        "id": "e7ac20f9-a4f9-4bf7-9333-ae96e1d34e0c"
      }
    ],
    "created_at": "2020-03-19T18:04:56.378183",
    "provisioning_status": "ACTIVE",
    "updated_at": "2020-03-19T18:09:33.467099",
    "vip_qos_policy_id": null,
    "vip_network_id": "15f7dc0a-712c-422f-bfd3-31dc351d9026",
    "listeners": [
      {
        "id": "ab110967-fd83-4a41-b3c5-4083395bdc86"
      }
    ],
    "tags": [],
    "vip_port_id": "c39af70f-a725-4b2b-b876-16ad636868ac",
    "flavor_id": null,
    "tenant_id": "05341a23f649427baa2fd4039b7f378f",
    "vip_address": "192.168.10.46",
    "vip_subnet_id": "fd2de462-f93b-43a6-9b5c-254f1e690bf1",
    "project_id": "05341a23f649427baa2fd4039b7f378f",
    "id": "601be015-0753-4221-931c-d26d81248551",
    "operating_status": "ONLINE",
    "name": "lb1"
  }
}