Regioni
Le regioni, anche indicate come datacenter, giocano un ruolo fondamentale nei nostri servizi, in quanto determinano la posizione geografica dei server che andremo a creare. In caso non sia possibile creare un server in una determinata regione, cambiare datacenter potrebbe risolvere il problema della mancanza di risorse.
Tutte le Regioni
Per scoprire quali regioni sono disponibili è presente la seguente richiesta:
HTTP Request
GET /ecs/v2/regions
HTTP Response
{
"status": "ok",
"regions": [
{
"location": "ch-lug1", #region code
"description": "Lugano" #region label
},
{
"location": "hr-zag1",
"description": "Zagabria"
},
{
"location": "it-fr2",
"description": "Frosinone"
},
{
"location": "it-mi2",
"description": "Milano"
}
]
}
Regioni disponibili
Ovviamente determinati piani potrebbero non essere disponibili in tutte le regioni, per verificare la disponibilità di un piano in una determinata regione è possibile utilizzare la seguente richiesta:
HTTP Request
POST /ecs/v2/regions/availables
{
"plan":"ECS6",
"image":"ubuntu-2404" #opzionale
}
| Campo | Obbligatorio | Descrizione |
|---|---|---|
plan |
sì | Nome del piano |
image |
no | Nome dell'immagine che si vuole usare per la creazione |
Il campo image è opzionale ma consigliato: con l'immagine la disponibilità viene calcolata con gli stessi
criteri della creazione (ad esempio, un'immagine UEFI richiede un host che supporti UEFI). Senza image una regione
può risultare disponibile anche se lo è solo per alcune immagini.
HTTP Response
{
"status": "ok",
"regions": [
["it-fr2"] #le regioni disponibili per quel piano
]
}
Se nessuna regione è disponibile regions è una lista vuota ([]). Se l'immagine indicata non esiste la risposta
è 400 con messaggio Image not exists.
Attenzione
Se si prova a creare un server in una regione non disponibile per il piano e l'immagine scelti, la richiesta
viene rifiutata con errore 400 (region <regione> not available for plan <piano>). Per evitarlo verificare
la disponibilità indicando anche image.