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.

Permissions and scopes

To call this operation, you need permissions, based on the model you're using:

Identity and access permissions. Your user needs a role with these permissions. Learn more.
- Permissions: list_linode_nodebalancers
OAuth scopes. Your user needs these scopes assigned. Learn more.
- Scopes: linodes:read_only

CLI

linode-cli linodes nodebalancers 123

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.

lke_cluster

object | null

Read-only This NodeBalancer's related LKE cluster, if any. The value is null if this NodeBalancer isn't related to an LKE cluster.

locks

array of strings | null

Beta, Filterable, Read-only Indicates if this NodeBalancer is protected by a lock to prevent accidental deletion. If the NodeBalancer has a cannot_delete lock, it can't be deleted, but its configurations and backend nodes can. If the NodeBalancer has a cannot_delete_with_subresources lock, both the NodeBalancer and attached resources such as configurations and backend nodes can't be deleted. Only account administrators can remove locks using the Delete a resource lock operation.

locks

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.

type

string

enum

Read-only The type of NodeBalancer.

common premium

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
35
 
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
      "lke_cluster": {
12
        "id": 12345,
13
        "label": "lkecluster12345",
14
        "type": "lkecluster",
15
        "url": "/v4/lke/clusters/12345"
16
      },
17
      "locks": "cannot_delete",
18
      "region": "us-east",
19
      "tags": [
20
        "example tag",
21
        "another example"
22
      ],
23
      "transfer": {
24
        "in": 28.91200828552246,
25
        "out": 3.5487728118896484,
26
        "total": 32.46078109741211
27
      },
28
      "type": "premium",
29
      "updated": "2018-03-01T00:01:01"
30
    }
31
  ],
32
  "page": 1,
33
  "pages": 1,
34
  "results": 1
35
}

200Returns a paginated list of NodeBalancers.