Skip to main content

region_availabilities

Creates, updates, deletes, gets or lists a region_availabilities resource.

Overview​

Nameregion_availabilities
TypeResource
Idovh.dedicated_server.region_availabilities

Fields​

The following fields are returned by SELECT queries:

A structure describing the availabilities of dedicated server

NameDatatypeDescription
fqnstringFully qualified and unique name of the hardware
gpustringName of the gpu hardware part
memorystringName of the memory hardware part
plan_codestringPlan code in which the hardware is involved (wire: planCode)
regionsarrayThe hardware availability for each region
serverstringName of the base hardware
storagestringName of the storage hardware part
system_storagestringName of the system storage hardware part (wire: systemStorage)

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
listselectexclude_regions, gpu, memory, plan_code, regions, server, storage, system_storageReturns the availability of each server hardware configuration in each region and its availability zones. Filter by plan code or hardware part, and choose regions with regions and excludeRegions. Unlike the datacenter route, this call requires authentication. (Beta version)

Parameters​

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
api_hoststringThe OVHcloud API host. Selected by OVH_ENDPOINT (ovh-eu, ovh-ca or ovh-us; default ovh-eu). (default: api.eu.ovhcloud.com, x-stackQL-envVarSelector: {"envVar":"OVH_ENDPOINT","default":"ovh-eu","values":{"ovh-eu":"api.eu.ovhcloud.com","ovh-ca":"api.ca.ovhcloud.com","ovh-us":"api.us.ovhcloud.com"}})
exclude_regionsbooleanIf true, all regions are returned except those listed in regions parameter (wire: excludeRegions)
gpustringThe name of the gpu hardware part
memorystringThe name of the memory hardware part
plan_codestringThe plan code in which the hardware is involved (wire: planCode)
regionsarrayThe names of regions
serverstringThe name of the base hardware
storagestringThe name of the storage hardware part
system_storagestringThe name of the system storage hardware part (wire: systemStorage)

SELECT examples​

Returns the availability of each server hardware configuration in each region and its availability zones. Filter by plan code or hardware part, and choose regions with regions and excludeRegions. Unlike the datacenter route, this call requires authentication. (Beta version)

SELECT
fqn,
gpu,
memory,
plan_code,
regions,
server,
storage,
system_storage
FROM ovh.dedicated_server.region_availabilities
WHERE exclude_regions = '{{ exclude_regions }}'
AND gpu = '{{ gpu }}'
AND memory = '{{ memory }}'
AND plan_code = '{{ plan_code }}'
AND regions = '{{ regions }}'
AND server = '{{ server }}'
AND storage = '{{ storage }}'
AND system_storage = '{{ system_storage }}'
;