Regions v4.175.0
Regions List
Lists the Regions available for Linode services. Not all services are guaranteed to be available in all Regions.
Authorizations
Request Samples
curl https://api.linode.com/v4/regions
linode-cli regions list
Response Samples
{
"data": null,
"page": 1,
"pages": 1,
"results": 1
}
{
"errors": null
}
Responses
data | [array] |
page | [integer] The current page. |
pages | [integer] The total number of pages. |
results | [integer] The total number of results. |
errors | [array] |
Regions Availability List
Returns availability data for all Regions.
Currently, this command returns availability of select premium and GPU plans for select regions.
Authorizations
Request Samples
curl https://api.linode.com/v4/regions/availability
linode-cli regions list-avail
Response Samples
{
"data": null,
"page": 1,
"pages": 1,
"results": 1
}
{
"errors": null
}
Responses
data | [array] |
page | [integer] The current page. |
pages | [integer] The total number of pages. |
results | [integer] The total number of results. |
errors | [array] |
Region View
Returns a single Region.
Authorizations
Path Parameters
regionId | [string] RequiredID of the Region to look up. |
Request Samples
curl https://api.linode.com/v4/regions/us-east
linode-cli regions view us-east
Response Samples
{
"capabilities": [
"Linodes",
"NodeBalancers",
"Block Storage",
"Object Storage"
],
"country": "us",
"id": "us-east",
"label": "Newark, NJ, USA",
"resolvers": {
"ipv4": "192.0.2.0,192.0.2.1",
"ipv6": "2001:0db8::,2001:0db8::1"
},
"status": "ok"
}
{
"errors": null
}
Responses
capabilities | [array] A list of capabilities of this region. | ||||
country | [string] The country where this Region resides. | ||||
id | [string] The unique ID of this Region. | ||||
label | [string] Detailed location information for this Region, including city, state or region, and country. | ||||
resolvers | [object]
| ||||
status | [string] Enum:
ok
outage This region’s current operational status. |
errors | [array] |
Region Availability View
Returns availability data for a single Region.
Authorizations
Path Parameters
regionId | [string] RequiredID of the Region to look up. |
Request Samples
curl https://api.linode.com/v4/regions/us-east/availability
linode-cli regions view-avail us-east
Response Samples
{}
{
"errors": null
}
Responses
errors | [array] |