Templates

I Template al contrario delle Immagini vengono creati dall'utente e sono privati.

Permettono di creare delle immagini a partire da server gia in uso conservando:

• Utenti e le relative Password
• Software installato
• Ogni file sul sistema

Non vengono invece conservate:

• Le interfacce di rete
• I relativi ip e macaddress

Creare un Template

Per creare un nuovo template è disponibile la seguente richiesta:

Richiesta HTTP

POST /ecs/v2/templates
{
  "server": "ec000001" // da quale Server creare il template
  "description": "il mio primo template" //una breve descrizione per il template
}

Risposta HTTP

{
  "status": "ok",
  "action_id": 700,
  "template": {
    "id": 2,
    "name": "ei000001",
    "creation_date": "2019-04-18T12:34:08+00:00",
    "active_flag": false,
    "status": "CG",
    "uuid": "6708cdc4-0c8d-4ccf-83c7-ae39bccaeb42",
    "description": "il mio primo template",
    "notes": "",
    "public": false,
    "cloud_image": false,
    "so_base": "debian",
    "api_version": "v4",
    "version": ""
  }
}

Potresti ricevere i seguenti errori:

Status Code	Messaggio	Spiegazione
400	server not found	È impossibile trovare il server da cui si vuole creare un template, assicurati che il server esista e sia in uno stato adeguato
400	Template can't be created for v1 server	È impossibile creare template a partire da server v1
400	Template can't be created for ECSGPU8 plan	Il piano ECSGPU8 non supporta i template

Visualizzare tutti i Template

Per visualizzare tutti i template è disponibile la seguente richiesta:

Richiesta HTTP

GET /ecs/v2/templates

Risposta HTTP

{
  "status": "ok",
  "templates": [
    {
      "id": 2,
      "name": "ei000002",
      "creation_date": "2019-04-19T12:34:08+00:00",
      "active_flag": true,
      "status": "CD",
      "uuid": "6708cdc4-0c8d-4ccf-83c7-ae39bccaeb42",
      "description": "il mio secondo template",
      "notes": "",
      "public": false,
      "cloud_image": false,
      "so_base": "debian",
      "api_version": "v4",
      "version": ""
    },
    {
      "id": 1,
      "name": "ei000001",
      "creation_date": "2019-04-18T12:34:08+00:00",
      "active_flag": true,
      "status": "CD",
      "uuid": "8520asd5-1k6l-6hjq-67g9-rf46rfvbgt97",
      "description": "il mio primo template",
      "notes": "",
      "public": false,
      "cloud_image": false,
      "so_base": "centos",
      "api_version": "v4",
      "version": ""
    },
    ...
  ]
}

Visualizzare uno specifico Template

Per visualizzare uno specifico Template è disponibile la seguente richiesta:

Richiesta HTTP

GET /ecs/v2/templates/{templatename}

Risposta HTTP

{
  "status": "ok",
  "template": {
    "id": 2,
    "name": "ei000002",
    "creation_date": "2019-04-19T12:34:08+00:00",
    "active_flag": true,
    "status": "CD",
    "uuid": "6708cdc4-0c8d-4ccf-83c7-ae39bccaeb42",
    "description": "il mio secondo template",
    "notes": "",
    "public": false,
    "cloud_image": false,
    "so_base": "debian",
    "api_version": "v4",
    "version": ""
  }
}

Rinominare un Template

Per rinominare un Template è possibile eseguire la seguente richiesta:

Richiesta HTTP

PUT /ecs/v2/templates/{templatename}
{
  "description": "il mio nuovo nome"
}

Risposta HTTP

{
  "status": "ok",
  "template": {
    "id": 2,
    "name": "ei000002",
    "creation_date": "2019-04-19T12:34:08+00:00",
    "active_flag": true,
    "status": "CD",
    "uuid": "6708cdc4-0c8d-4ccf-83c7-ae39bccaeb42",
    "description": "il mio nuovo nome",
    "notes": "",
    "public": false,
    "cloud_image": false,
    "so_base": "debian",
    "api_version": "v4",
    "version": ""
  }
}

Rimuovere un Template

Per rimuovere un template è possibile utilizzare la seguente richiesta:

Richiesta HTTP

DELETE /ecs/v2/templates/{templatename}

Risposta HTTP

{
  "status": "ok",
  "action": {
    "id": 709,
    "status": "in-progress",
    "user": "foo",
    "created_at": "2024-10-19T15:08:55.887799+00:00",
    "started_at": "2024-10-19T15:08:55.887284+00:00",
    "completed_at": "2024-10-19T15:09:56.067592+00:00",
    "resource": "ei000001",
    "resource_type": "DI",
    "type": "delete_template",
    "progress": 10
  }
}

Attenzione

Una volta rimosso un template ogni dato al suo interno verrà cancellato irrimediabilmente