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
  |