Get a region

get https://api.linode.com/{apiVersion}/regions/{regionId}

Returns a single Region.

CLI

linode-cli regions view us-east

Learn more...

Responses

Response body

object

capabilities

array of strings

Read-only A list of capabilities of this region.

capabilities

country

string

Filterable, Read-only The country where this Region resides.

string

Read-only The unique ID of this Region.

label

string

Read-only Detailed location information for this Region, including city, state or region, and country.

placement_group_limits

object

Read-only The limits for placement groups in this region.

maximum_linodes_per_pg

integer

Read-only The maximum number of compute instances you can include in a single placement group in this region.

maximum_pgs_per_customer

integer | null

Read-only The maximum number of placement groups you can have in this region. Displayed as null if you don't have a limit.

resolvers

object

ipv4

string

Read-only The IPv4 addresses for this region's DNS resolvers, separated by commas.

ipv6

string

Read-only The IPv6 addresses for this region's DNS resolvers, separated by commas.

site_type

string

Filterable, Read-only This region's site type. A core region indicates a traditional cloud computing region that offers all compute services. A distributed region indicates sites that are globally dispersed to be closer to end users and workloads. These regions offer limited services.

core distributed

status

string

Read-only This region's current operational status.

ok outage

Language


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api.linode.com/v4/regions/regionId \
3
     --header 'accept: application/json'


xxxxxxxxxx
23
 
1
{
2
  "capabilities": [
3
    "Linodes",
4
    "NodeBalancers",
5
    "Block Storage",
6
    "Object Storage",
7
    "Placement Groups",
8
    "Block Storage Encryption"
9
  ],
10
  "country": "us",
11
  "id": "us-east",
12
  "label": "Newark, NJ, USA",
13
  "placement_group_limits": {
14
    "maximum_linodes_per_pg": 5,
15
    "maximum_pgs_per_customer": 10
16
  },
17
  "resolvers": {
18
    "ipv4": "192.0.2.0,192.0.2.1",
19
    "ipv6": "2001:0db8::,2001:0db8::1"
20
  },
21
  "site_type": "core",
22
  "status": "ok"
23
}

200A single Region object.

defaultSee Errors for the range of possible error response codes.