Linode Instances
Linode NodeBalancers View
https://api.linode.com/v4/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 User's Grants Update (PUT /account/users/{username}/grants) endpoint.
Path Parameters
ID of the Linode to look up
Request Samples
- Shell
- CLI
curl -H "Authorization: Bearer $TOKEN" \
https://api.linode.com/v4/linode/instances/123/nodebalancers
Response Samples
- 200
{
"data": [
{
"id": "",
"created": "2018-01-01T00:01:01.000Z",
"label": "balancer12345",
"updated": "2018-03-01T00:01:01.000Z",
"tags": [
"example tag",
"another example"
],
"region": "us-east",
"ipv4": "",
"ipv6": "",
"hostname": "192.0.2.1.ip.linodeusercontent.com",
"client_conn_throttle": "",
"transfer": {
"total": 32.46078109741211,
"out": 3.5487728118896484,
"in": 28.91200828552246
}
}
],
"page": 1,
"pages": 1,
"results": 1
}
Responses
200: Returns a paginated list of NodeBalancers.
This NodeBalancer's unique ID.
When this NodeBalancer was created.
This NodeBalancer's label. These must be unique on your Account.
When this NodeBalancer was last updated.
An array of Tags applied to this object. Tags are for organizational purposes only.
The Region where this NodeBalancer is located. NodeBalancers only support backends in the same Region.
This NodeBalancer's public IPv4 address.
This NodeBalancer's public IPv6 address.
This NodeBalancer's hostname, beginning with its IP address and ending with .ip.linodeusercontent.com.
Throttle connections per second. Set to 0 (zero) to disable throttling.
Information about the amount of transfer this NodeBalancer has had so far this month.
The total transfer, in MB, used by this NodeBalancer this month.
The total inbound transfer, in MB, used for this NodeBalancer this month.
The total outbound transfer, in MB, used for this NodeBalancer this month.
The current page.
The total number of pages.
The total number of results.