Linode Instances

View Network Transfer

get
https://api.linode.com/v4/linode/instances/{linodeId}/transfer

Returns a Linode's network transfer pool statistics for the current month.

Authorizations

Personal Access Token
OAuth: ( linodes:read_only)

Path Parameters

linodeId
Required
integer

ID of the Linode to look up.

Request Samples

curl -H "Authorization: Bearer $TOKEN" \
    https://api.linode.com/v4/linode/instances/123/transfer

Response Samples

{
  "billable": "",
  "quota": 2000,
  "used": 22956600198
}

Responses

200: A collection of the specified Linode's network transfer statistics.

billable
integer

The amount of network transfer this Linode has used, in GB, past your monthly quota.

quota
integer

The amount of network transfer this Linode adds to your transfer pool, in GB, for the current month's billing cycle.

used
integer

The amount of network transfer used by this Linode, in bytes, for the current month's billing cycle.

default: Error

errors
array of objects
reason
string

What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.

field
string

The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.