Regions
This section details Region-related Linode CLI commands.
list
Aliases: ls
Lists the Regions available for Linode services.
Usage
The format accepted by this command.
linode-cli regions list [-h] [--site-type site-type]
[--country country] [--order-by {site-type,country}]
[--order {asc,desc}]
Sample
Examples of how this command might be used.
linode-cli regions list
Filterable Attributes
Arguments used to define a filter for response entries.
Name |
Type |
Description |
|---|---|---|
--country |
str |
The country where this Region resides. |
--site-type |
str |
This region’s site type. |
Result Attributes
The attributes returned by this command.
Name |
Type |
Example |
Description |
|---|---|---|---|
capabilities |
[]str |
[“Linodes”, “…ent Groups”] |
A list of capabilities of this region. |
country |
str |
us |
The country where this Region resides. |
id |
str |
us-east |
The unique ID of this Region. |
label |
str |
Newark, NJ, USA |
Detailed location information for this Region, including city, state or region, and country. |
site-type |
str |
core |
This region’s site type. |
status |
str |
ok |
This region’s current operational status. |
placement_group_limits
Name |
Type |
Example |
Description |
|---|---|---|---|
placement_group_limits.maximum_linodes_per_pg |
int |
5 |
The maximum number of compute instances you can include in a single placement group in this region. |
placement_group_limits.maximum_pgs_per_customer |
int |
10 |
The maximum number of placement groups you can have in this region. |
resolvers
Name |
Type |
Example |
Description |
|---|---|---|---|
resolvers.ipv4 |
str |
192.0.2.0,192.0.2.1 |
The IPv4 addresses for this region’s DNS resolvers, separated by commas. |
resolvers.ipv6 |
str |
2001:0db8::,2001:0db8::1 |
The IPv6 addresses for this region’s DNS resolvers, separated by commas. |
view
Returns a single Region.
Usage
The format accepted by this command.
linode-cli regions view [-h] [--site-type site-type]
[--country country] [--order-by {site-type,country}]
[--order {asc,desc}] regionId
Sample
Examples of how this command might be used.
linode-cli regions view us-east
Parameters
Positional parameters used to define the resource this command should target.
Name |
Type |
Description |
|---|---|---|
regionId |
str |
ID of the Region to look up. |
Result Attributes
The attributes returned by this command.
Name |
Type |
Example |
Description |
|---|---|---|---|
capabilities |
[]str |
[“Linodes”, “…ent Groups”] |
A list of capabilities of this region. |
country |
str |
us |
The country where this Region resides. |
id |
str |
us-east |
The unique ID of this Region. |
label |
str |
Newark, NJ, USA |
Detailed location information for this Region, including city, state or region, and country. |
site-type |
str |
core |
This region’s site type. |
status |
str |
ok |
This region’s current operational status. |
placement_group_limits
Name |
Type |
Example |
Description |
|---|---|---|---|
placement_group_limits.maximum_linodes_per_pg |
int |
5 |
The maximum number of compute instances you can include in a single placement group in this region. |
placement_group_limits.maximum_pgs_per_customer |
int |
10 |
The maximum number of placement groups you can have in this region. |
resolvers
Name |
Type |
Example |
Description |
|---|---|---|---|
resolvers.ipv4 |
str |
192.0.2.0,192.0.2.1 |
The IPv4 addresses for this region’s DNS resolvers, separated by commas. |
resolvers.ipv6 |
str |
2001:0db8::,2001:0db8::1 |
The IPv6 addresses for this region’s DNS resolvers, separated by commas. |
list-avail
Returns availability data for all Regions.
Usage
The format accepted by this command.
linode-cli regions list-avail [-h] [--plan plan]
[--available available] [--region region]
[--order-by {plan,available,region}] [--order {asc,desc}]
Sample
Examples of how this command might be used.
linode-cli regions list-avail
Filterable Attributes
Arguments used to define a filter for response entries.
Name |
Type |
Description |
|---|---|---|
--available |
bool |
Whether the compute instance type is available in the region. |
--plan |
str |
The compute instance Type ID. |
--region |
str |
The Region ID. |
Result Attributes
The attributes returned by this command.
Name |
Type |
Example |
Description |
|---|---|---|---|
available |
bool |
true |
Whether the compute instance type is available in the region. |
plan |
str |
gpu-rtx6000-1.1 |
The compute instance Type ID. |
region |
str |
us-east |
The Region ID. |
view-avail
Returns availability data for a single Region.
Usage
The format accepted by this command.
linode-cli regions view-avail [-h] [--region region]
[--available available] [--plan plan]
[--order-by {region,available,plan}] [--order {asc,desc}]
regionId
Sample
Examples of how this command might be used.
linode-cli regions view-avail us-east
Parameters
Positional parameters used to define the resource this command should target.
Name |
Type |
Description |
|---|---|---|
regionId |
str |
ID of the Region to look up. |
Result Attributes
The attributes returned by this command.
Name |
Type |
Example |
Description |
|---|---|---|---|
available |
bool |
true |
Whether the compute instance type is available in the region. |
plan |
str |
gpu-rtx6000-1.1 |
The compute instance Type ID. |
region |
str |
us-east |
The Region ID. |