List Linode NodeBalancers

get https://api.linode.com/{apiVersion}/linode/instances/{linodeId}/nodebalancers

Returns a list of NodeBalancers that are assigned to this Linode and readable by the requesting User.

Read permission to a NodeBalancer can be given to a User by accessing the Update a user's grants operation.

linode-cli linodes nodebalancers 123


Learn more...

linodes:read_only


Learn more...

Response

Response body

object

data

array of objects

data

object

client_conn_throttle

integer

0 to 20

Throttle TCP connections per second for TCP, HTTP, and HTTPS configurations. Set to 0 (zero) to disable throttling.

created

date-time

Read-only When this NodeBalancer was created.

hostname

string

Read-only This NodeBalancer's hostname, beginning with its IP address and ending with .ip.linodeusercontent.com.

integer

Read-only This NodeBalancer's unique ID.

ipv4

string

Filterable, Read-only This NodeBalancer's public IPv4 address.

ipv6

string | null

Read-only This NodeBalancer's public IPv6 address.

label

string

length between 3 and 32

Filterable This NodeBalancer's label. These must be unique on your Account.

region

string

Filterable, Read-only The Region where this NodeBalancer is located. NodeBalancers only support backends in the same Region.

tags

transfer

object

Read-only Information about the amount of transfer this NodeBalancer has had so far this month.

updated

date-time

Read-only When this NodeBalancer was last updated.

page

integer

Read-only The current page.

pages

integer

Read-only The total number of pages.

results

integer

Read-only The total number of results.

Language

Credentials


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api.linode.com/v4/linode/instances/linodeId/nodebalancers \
3
     --header 'accept: application/json'


xxxxxxxxxx
27
}
1
{
2
  "data": [
3
    {
4
      "client_conn_throttle": 10,
5
      "created": "2018-01-01T00:01:01",
6
      "hostname": "192.0.2.1.ip.linodeusercontent.com",
7
      "id": 12345,
8
      "ipv4": "203.0.113.1",
9
      "ipv6": null,
10
      "label": "balancer12345",
11
      "region": "us-east",
12
      "tags": [
13
        "example tag",
14
        "another example"
15
      ],
16
      "transfer": {
17
        "in": 28.91200828552246,
18
        "out": 3.5487728118896484,
19
        "total": 32.46078109741211
20
      },
21
      "updated": "2018-03-01T00:01:01"
22
    }
23
  ],
24
  "page": 1,
25
  "pages": 1,

200Returns a paginated list of NodeBalancers.