Cloud Script

I Cloud Script sono un'importante feature che permette la configurazione di un Server durante la creazione tramite uno script remoto.

Per fare ciò oltre all'utilizzo degli script temporanei i nostri servizi espongono anche una libreria di script personale rendendo possibile la creazione di script riutilizzabili e personalizzabili.

Nonostante la gestione della libreria sia consigliata tramite il pannello web è comunque possibile via API.

Info

Ricorda: l'utilizzo delle variabili di ambiente è possibile solo con script provenienti dalla liberia di script, non è permesso con gli script temporanei.

Aggiungere un nuovo Script

Per aggiungere un nuovo script è possibile utilizzare la seguente richiesta:

Richiesta HTTP

POST /ecs/v2/scripts
{
  "title": "my-script",
  "content": "#!/bin/bash\necho \"Hello, World!\" > /root/greet.txt",
  "windows": false, //indica se lo script è destinato a macchine windows
}

Risposta HTTP

{
  "id": 0, //identificativo
  "user": "foo",
  "title": "my-script",
  "content": "#!/bin/bash\necho \"Hello, World!\" > /root/greet.txt",
  "windows": false, //indica se lo script è destinato a macchine windows
  "public": false, //indica se lo script è pubblico per altri utenti
  "category": null 
}

Potresti ricevere i seguenti errori:

Status Code	Message	Spiegazione
400	Cant use relative path i user script	è impossibile utilizzare path relativi o home path (~/) nei cloud script
400	Error content cant be null	il contenuto dello script non può essere vuoto
400	Error title cant be null	il titolo delle script non può essere vuoto
400	Error can't have more then 20 scripts remove a script before try to create another	La grandezza della libreria dei cloud script non supporta piu di 20 script per utente

Ottenere gli script presenti

Per ottenere tutti gli script dell'utente è possibile eseguire la seguente richiesta:

Richiesta HTTP

GET /ecs/v2/scripts

Risposta HTTP

{
  "status": "ok",
  "scripts": [
    {
      "id": 0, //identificativo
      "user": "foo",
      "title": "my-script",
      "content": "#!/bin/bash\necho \"Hello, World!\" > /root/greet.txt",
      "windows": false, //indica se lo script è destinato a macchine windows
      "public": false, //indica se lo script è pubblico per altri utenti
      "category": null 
    },
    {
      "id": 1, //identificativo
      "user": "foo",
      "title": "my-script-w",
      "content": "#ps1\necho \"Hello, World!\" > C:\\Users\\Administrator\\Desktop\\greet.txt",
      "windows": true, //indica se lo script è destinato a macchine windows
      "public": false, //indica se lo script è pubblico per altri utenti
      "category": null 
    }
  ]
}

Ottenere uno specifico Script

Per ottenere uno script nello specifico è possibile utilizzare la seguente richiesta:

Richiesta HTTP

GET /ecs/v2/scripts

Risposta HTTP

{
  "status": "ok",
  "script": {
    "id": 0, //identificativo
    "user": "foo",
    "title": "my-script",
    "content": "#!/bin/bash\necho \"Hello, World!\" > /root/greet.txt",
    "windows": false, //indica se lo script è destinato a macchine windows
    "public": false, //indica se lo script è pubblico per altri utenti
    "category": null 
  }
}

Modificare un determinato Script

È possibile modificare uno script già creato utilizzando la seguente richiesta:

Richiesta HTTP

PUT /ecs/v2/scripts/{scriptid}
{
  "title": "my-script-renamed", //opzionale
  "content": "#!/bin/bash\necho \"Hello, Guys!\" > /root/greet.txt", //opzionale
  "windows": false, //opzionale  
}

Risposta HTTP

{
  "status": "ok",
  "script": {
    "id": 0, //identificativo
    "user": "foo",
    "title": "my-script-renamed",
    "content": "#!/bin/bash\necho \"Hello, Guys!\" > /root/greet.txt",
    "windows": false, //indica se lo script è destinato a macchine windows
    "public": false, //indica se lo script è pubblico per altri utenti
    "category": null 
  }
}

Potresti ottenere i seguenti errori:

Status Code	Message	Spiegazione
400	Cant use relative path i user script	è impossibile utilizzare path relativi o home path (~/) nei cloud script
400	Error content cant be null	il contenuto dello script non può essere vuoto
400	Error title cant be null	il titolo delle script non può essere vuoto

Cancellare uno Script

Ovviamente è possibile rimuovere gli script che non intendi più utilizzare, questa operazione può essere svolta con la seguente richiesta:

Richiesta HTTP

DELETE /ecs/v2/scripts/{scriptid}