Skip to main content
GET
/
cloud
/
v1
/
reseller_name_templates
/
{project_id}
/
{region_id}
/
available_names
Get naming restrictions that are applied to specified project and region.
curl --request GET \
  --url https://api.gcore.com/cloud/v1/reseller_name_templates/{project_id}/{region_id}/available_names \
  --header 'Authorization: <api-key>'
{
  "custom_name_allowed": true,
  "name_templates_limited": true,
  "allowed_bm_name_templates": [
    "ed-b9-{ip_octets}"
  ],
  "allowed_bm_name_win_templates": [
    "ed-c4-{two_ip_octets}"
  ],
  "allowed_lb_name_restriction": "^[a-z0-9][a-z0-9.-]{1,61}[a-z0-9]$",
  "allowed_lb_name_templates": [
    "ed-c16-lb-{ip_octets}"
  ],
  "allowed_name_templates": [
    "ed-c4-{ip_octets}"
  ],
  "allowed_name_win_templates": [
    "ed-b9-{one_ip_octet}"
  ]
}

Authorizations

​
Authorization
string
header
required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Path Parameters

​
project_id
integer
required

Project ID.

Example:

1

​
region_id
integer
required

Region ID.

Example:

1

Response

200 - application/json

OK

​
custom_name_allowed
boolean
required

If true, instances can be created using "names" field.

Example:

false

​
name_templates_limited
boolean
required

If true, only specific strings are allowed in "name_templates" fields.

Example:

true

​
allowed_bm_name_templates
string[] | null

Clients will only be able to use these strings as bare metal server "bm_name_templates".

Example:
["ed-b9-{ip_octets}"]
​
allowed_bm_name_win_templates
string[] | null

Clients will only be able to use these strings as bare metal server "bm_name_templates".

Example:
["ed-c4-{two_ip_octets}"]
​
allowed_lb_name_restriction
string | null

Loadbalancer name restriction.

Example:

"^[a-z0-9][a-z0-9.-]{1,61}[a-z0-9]$"

​
allowed_lb_name_templates
string[] | null

If "name_templates_limited" is True, this is the list of allowed name templates.

Example:
["ed-c16-lb-{ip_octets}"]
​
allowed_name_templates
string[] | null

If "name_templates_limited" is True, this is the list of allowed instance name templates.

Example:
["ed-c4-{ip_octets}"]
​
allowed_name_win_templates
string[] | null

If "name_templates_limited" is True, this is the list of allowed windows instance name templates.

Example:
["ed-b9-{one_ip_octet}"]