Vai al contenuto

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.