Vai al contenuto

Gestire un Server

Un Server può necessitare di diverse operazioni di gestione, per risolvere queste necessita i nostri sistemi espongono diverse richieste per quanto riguarda l'accensione, lo spegnimento dello stesso ed il ripristino a uno Snapshot precedente.

Accendere un Server

Per accendere un server è disponibile la seguente richiesta:

Richiesta HTTP

POST /ecs/v2/servers/{servername}/actions
{
  "type": "power_on"
}

Risposta HTTP

{
  "id": 709, 
  "status": "in-progress", 
  "user": "foo",
  "created_at": "2024-10-19T15:08:55.887799+00:00",
  "started_at": "",
  "completed_at": "",
  "resource": "ec200001",
  "resource_type": "ECS", 
  "type": "power_on",
  "progress": 10
}

Potresti ricevere i seguenti errori:

Status Code Messaggio Spiegazione
400 action type is required il campo 'type' è obbligatorio

Spegnere un Server

Per spegnere un server è disponibile la seguente richiesta:

Richiesta HTTP

POST /ecs/v2/servers/{servername}/actions
{
  "type": "power_off"
}

Risposta HTTP

{
  "id": 709, 
  "status": "in-progress", 
  "user": "foo",
  "created_at": "2024-10-19T15:08:55.887799+00:00",
  "started_at": "",
  "completed_at": "",
  "resource": "ec200001",
  "resource_type": "ECS", 
  "type": "power_off",
  "progress": 10
}

Potresti ricevere i seguenti errori:

Status Code Messaggio Spiegazione
400 action type is required il campo 'type' è obbligatorio

Ripristinare uno Snapshot

Per ripristinare uno Snapshot è sufficiente eseguire la seguente richiesta:

Richiesta HTTP

{
    "type": "rollback",
    "snapshot": 105
}
Risposta HTTP
{
    "id": 2118,
    "status": "in-progress",
    "user": "admin",
    "created_at": "2025-02-07T13:46:27.864204+00:00",
    "started_at": "2025-02-07T13:46:27.863404+00:00",
    "completed_at": null,
    "resource": "ec200409",
    "resource_type": "ECS",
    "type": "rollback",
    "progress": 0
}

Attenzione

Questa operazione richiederà il riavvio del server e potrebbe richiedere diversi minuti.