Regions v4.174.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": [
    {
      "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"
    }
  ],
  "page": 1,
  "pages": 1,
  "results": 1
}{
  "errors": [
    {
      "field": "fieldname",
      "reason": "fieldname must be a valid value"
    }
  ]
}Responses
| data | array
of objects
 | ||||||||||||||||
| page | integerThe current page. | ||||||||||||||||
| pages | integerThe total number of pages. | ||||||||||||||||
| results | integerThe total number of results. | 
| errors | array
of objects
 | 
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": [
    {
      "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 | integerThe current page. | ||||||
| pages | integerThe total number of pages. | ||||||
| results | integerThe total number of results. | 
| errors | array
of objects
 | 
Region View
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-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": [
    {
      "field": "fieldname",
      "reason": "fieldname must be a valid value"
    }
  ]
}Responses
| capabilities | array
of stringsA list of capabilities of this region. | ||||
| country | stringThe country where this Region resides. | ||||
| id | stringThe unique ID of this Region. | ||||
| label | stringDetailed location information for this Region, including city, state or region, and country. | ||||
| resolvers | object
 | ||||
| status | stringEnum:
 okoutageThis region’s current operational status. | 
| errors | array
of objects
 | 
Region Availability View
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/availability
linode-cli regions view-avail us-east
Response 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
 |