EasyCloud
Da WikiCloud.
Indice |
RESTful API
Con il vostro account easycloud potete integrare la vostra applicazione con esso attraverso le API pubbliche che permetto di realizzare un sottoinsieme delle operazioni disponibili attraverso il pannello di controllo web.
codifica chiamate: JSON
codifche rispote: JSON
endpoint: https://ecs.cloudcenter.seeweb.it/api/public/easycloud
Creare un eCS
esempio con curl:
curl -i -H "Content-type:application/json"\
-H "Easycloud-user:<myuser>"\
-H "Easycloud-token:<mypass>"\
-X POST -d '{"os":"Ubuntu 12.10 GNU/Linux distribution","plan":"small","location":"milano"}' https://ecs.cloudcenter.seeweb.it/api/public/easycloud
Informazioni da passare
Informazioni in formato json con le seguenti chiavi:
- os: immagine con cui avviare l'eCS (elenco completo ottenibile con una GET)
- plan: dimensioni del nuovo eCS {small|medium|big|huge}
- location: datacenter del nuovo eCS {frosinone|milano}
Informazioni restituite
Risposta json con le seguenti chiavi:
- message: testo esplicativo dell'azione/errore
Codici risposte:
- 500 Errore generico
- 401 errore autenticazione
- 409 Richiesta non accettabile a causa dello stato della risorsa
- 400 Richiesta malformattata
- 201 Richiesta accettata
Cancellare un eCS
esempio con curl:
curl -i -H "Easycloud-user : <myuser>" -H "Easycloud-token : <mypass>" -X DELETE https://ecs.cloudcenter.seeweb.it/api/public/easycloud/<ecscode>
Informazioni restituite
Corpo vuoto come da RFC2616
Codici risposte:
- 401 errore autenticazione
- 409 Richiesta non accettabile a causa dello stato della risorsa
- 400 Richiesta malformattata
- 204 Richiesta accettata
Ottenere informazioni sul proprio account un eCS
esempio con curl:
curl -i -H "Content-type:application/json"\ -H "Easycloud-user:<myuser>"\ -H "Easycloud-token:<mypass>"\ -X GET https://ecs.cloudcenter.seeweb.it/api/public/easycloud/<myuser>
Informazioni restituite
Risposta json con le seguenti chiavi:
- message: testo esplicativo dell'azione/errore
- ecs-list: lista degli eCS attivi/in attivazione
- bootable-images: lista delle immagini attive/in attivazione con cui poter avviare un eCS
- groups-lists: lista dei gruppi
Codici risposte:
- 404 Informazioni non trovate
- 401 errore autenticazione
- 200 Informazioni ottenute
Azioni su un eCS
esempio con curl:
curl -i -H "Content-type:application/json"\
-H "Easycloud-user:<myuser>"\
-H "Easycloud-token:<mypass>"\
-X PUT -d '{"action":"snapshot","data":"my comment"}' https://ecs.cloudcenter.seeweb.it/api/public/easycloud/<ecs_code>
Informazioni da passare
Informazioni in formato json con le seguenti chiavi:
- action: azione da compiere sull'ecs {snapshot}
- data: informazioni da passare per completare l'azione. È il commento all'immagine da creare nel caso di snapshot.
Informazioni restituite
Risposta json con le seguenti chiavi:
- message: testo esplicativo dell'azione/errore
Codici risposte:
- 500 Errore generico
- 401 errore autenticazione
- 409 Richiesta non accettabile a causa dello stato della risorsa
- 400 Richiesta malformattata
- 201 Richiesta accettata
