Cheatsheet per l'intero VMware AppCatalyst API utilizzando cURL

Ci sono state un paio di domande di recente circa la sintassi richiesta per specifiche operazioni di VMware AppCatalyst quando si consumano l'API REST con cURL. Ho pensato che ho messo insieme un rapido "bigino" che contiene gli esempi Curl per l'intera API VMware AppCatalyst che non solo sarebbe aiutarmi in futuro, ma potrebbe anche beneficiare gli altri. Come molti, ho imparato anche con l'esempio e con i campioni esplicite per iniziare è un ottimo modo per prendere confidenza con una nuova tecnologia o prodotto. Se siete nuovi a VMware AppCatalyst e vorrebbe un breve riassunto su come iniziare rapidamente, assicurati di aver letto il mio articolo arrivare iniziato qui per ulteriori dettagli.

Mentre passa attraverso l'API AppCatalyst, ho trovato un paio di operazioni API che aveva alcune incoerenze e non rispettare rigorosamente il formato JSON. Grazie a Roman Tarnvski per fornire la soluzione. Mi auguro che questi problemi saranno risolti in un futuro aggiornamento AppCatalyst come mi piace la facilità d'uso del loro API. Per la maggior parte delle API, la documentazione di sé tramite l'AppCatalyst API Explorer  è accurata, che potete vedere dalla schermata qui sotto.

appcatalyst-api-explorer
Prima di poter interagire con le API REST AppCatalyst, è necessario avviare il AppCatalyst Daemon eseguendo il seguente comando:

/ opt / vmware / appcatalyst / bin / appcatalyst-daemon

Una volta che il AppCatalyst Daemon è in esecuzione, è possibile aprire un nuovo terminale e iniziare a lavorare con la REST API via cURL o qualsiasi altro strumento di scelta.

1. Creare una nuova VM dal modello Photon operativo VM predefinito:

È tecnicamente sufficiente specificare l'unico "id proprietà", ma si può anche dare un nome visualizzato per la VM utilizzando il "nome proprietà".

ricciolo -d '{"id": "VM1", "name": "MyAppCat-VM1"}' -X POST localhost: 8080 / api / vms

1. CreateVM
2. Clone una VM da una VM esistente:

Simile alla creazione di una nuova VM, avete anche possibilità di utilizzare il "tag proprietà" per associare metadati aggiuntivi con la VM.

ricciolo -d '{"id": "VM2", "parentid": "VM1", "name": "MyAppCat-VM2", "tag": "Sviluppo"}' -X POST localhost: 8080 / api / vms

2. Clone VM
3. Elenco tutte le macchine virtuali

ricciolo -X GET localhost: 8080 / api / vms

3. Elenco VM
4. Ottenere una specifica VM:

Per recuperare una specifica VM, è necessario accendere il VM prima è consentita questa operazione. Ho trovato strano che questo era il caso, ma forse questo potrebbe essere migliorato in futuro, di non avere questo requisito, soprattutto se si vuole tirare fuori i dettagli, come la proprietà "tag".

arricciatura -X GET localhost: 8080 / API / VMS / VM1

4. Ottenere specifica VM
5. Accendere un VM:

ricciolo -d 'su' -X PATCH localhost: 8080 / api / VMS / potere / VM1

Nota: Altri VM Filiera Energia: off, arresto, sospensione, mettere in pausa e Riattiva

5. Alimentazione VM
6. Ottenere lo stato di alimentazione di una macchina virtuale:

ricciolo -X GET localhost: 8080 / api / VMS / potere / VM1

6. Ottenere statale
7. Prendi l'indirizzo IP di una macchina virtuale:

ricciolo -X GET localhost: 8080 / api / VMS / VM1 / ipaddress

7. Ottieni indirizzo IP
8. Abilitare la condivisione delle cartelle per una macchina virtuale:

ricciolo -d "vero" -X PATCH localhost: 8080 / API / VMS / VM1 / cartelle

8. Abilitare cartelle condivise
9. Creare una mappatura cartella condivisa per una macchina virtuale:

La "guestPath proprietà" non è un percorso assoluto all'interno del GuestOS, ma piuttosto un nome logico. Per ulteriori dettagli sulle cartelle condivise in AppCatalyst, si prega di dare un'occhiata a questo articolo qui. Attualmente c'è un solo "bandiere proprietà" con il valore di 4, che abilita di lettura / scrittura, consultare l'articolo del link qui sopra per maggiori dettagli sulla condivisione delle cartelle in AppCatalyst.

ricciolo -d '{"guestPath": "-cartella condivisa", "HostPath": "/ Users / WLAM / git", "bandiere": 4}' -X POST localhost: 8080 / API / VMS / VM1 / cartelle

9. Creare cartella condivisa
10. Elenco tutte le cartelle condivise di una VM:

ricciolo -X GET localhost: 8080 / API / VMS / VM1 / cartelle

10. Elenco tutte le cartelle condivise
11. Elenco una cartella condivisa specifica per un VM:

ricciolo -X GET localhost: 8080 / api / VMS / VM1 / cartelle /-cartella condivisa

11. Lista cartella condivisa specifica
12. Eliminare una cartella condivisa per una macchina virtuale:

ricciolo -X DELETE localhost: 8080 / API / VMS / VM1 / cartelle /-cartella condivisa

12. Elimina cartella condivisa
13. Elimina VM:

ricciolo -X DELETE localhost: 8080 / API / VMS / VM1

13. Elimina VM