Regions v4.176.0
List regions
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/regionslinode-cli regions listResponse Samples
{
"data": [
{
"capabilities": [
"Linodes",
"NodeBalancers",
"Block Storage",
"Object Storage",
"Placement Groups"
],
"country": "us",
"id": "us-east",
"label": "Newark, NJ, USA",
"placement_group_limits": {
"maximum_linodes_per_pg": 5,
"maximum_pgs_per_customer": 10
},
"resolvers": {
"ipv4": "192.0.2.0,192.0.2.1",
"ipv6": "2001:0db8::,2001:0db8::1"
},
"status": "ok"
}
],
"page": 1,
"pages": 1,
"results": 1
}{
"errors": [
{
"field": "fieldname",
"reason": "fieldname must be a valid value"
}
]
}Responses
data | array
of objects
| ||||||||||||||||||||||
page | integerRead-only The current page. | ||||||||||||||||||||||
pages | integerRead-only The total number of pages. | ||||||||||||||||||||||
results | integerRead-only The total number of results. |
errors | array
of objects
|
List regions' availability
Returns availability data for all Regions.
Currently, this operation returns availability of select premium and GPU plans for select regions.
Authorizations
Request Samples
curl https://api.linode.com/v4/regions/availabilitylinode-cli regions list-availResponse Samples
{
"data": [
{
"available": true,
"plan": "gpu-rtx6000-1.1",
"region": "us-east"
}
],
"page": 1,
"pages": 1,
"results": 1
}{
"errors": [
{
"field": "fieldname",
"reason": "fieldname must be a valid value"
}
]
}Responses
data | array
of objects
| ||||||
page | integerRead-only The current page. | ||||||
pages | integerRead-only The total number of pages. | ||||||
results | integerRead-only The total number of results. |
errors | array
of objects
|
Get a region
Returns a single Region.
Authorizations
Path Parameters
| regionId | stringRequiredID of the Region to look up. |
Request Samples
curl https://api.linode.com/v4/regions/us-eastlinode-cli regions view us-eastResponse Samples
{
"capabilities": [
"Linodes",
"NodeBalancers",
"Block Storage",
"Object Storage",
"Placement Groups"
],
"country": "us",
"id": "us-east",
"label": "Newark, NJ, USA",
"placement_group_limits": {
"maximum_linodes_per_pg": 5,
"maximum_pgs_per_customer": 10
},
"resolvers": {
"ipv4": "192.0.2.0,192.0.2.1",
"ipv6": "2001:0db8::,2001:0db8::1"
},
"status": "ok"
}{
"errors": [
{
"field": "fieldname",
"reason": "fieldname must be a valid value"
}
]
}Responses
capabilities | array
of stringsRead-only A list of capabilities of this region. | ||||
country | stringRead-only The country where this Region resides. | ||||
id | stringRead-only The unique ID of this Region. | ||||
label | stringRead-only Detailed location information for this Region, including city, state or region, and country. | ||||
placement_group_limits | objectRead-only The limits for placement groups in this region.
| ||||
resolvers | object
| ||||
status | stringEnum:
ok
outageRead-only This region’s current operational status. |
errors | array
of objects
|
Get a region's availability
Returns availability data for a single Region.
Authorizations
Path Parameters
| regionId | stringRequiredID of the Region to look up. |
Request Samples
curl https://api.linode.com/v4/regions/us-east/availabilitylinode-cli regions view-avail us-eastResponse Samples
{
"available": true,
"plan": "gpu-rtx6000-1.1",
"region": "us-east"
}{
"errors": [
{
"field": "fieldname",
"reason": "fieldname must be a valid value"
}
]
}Responses
available | booleanWhether the compute instance type is available in the region. |
plan | stringThe compute instance Type ID. |
region | stringThe Region ID. |
errors | array
of objects
|