A. Pendahuluan

Layanan NEO Lite adalah layanan virtualisasi menggunakan virtualisasi KVM, selain bisa dilakukan order melalui portal Biznet Gio dan apabila Anda perlu memesan banyak NEO Lite dalam satu waktu, atau anda butuh untuk membuat otomisasi, Anda dapat menggunakan API yang kami sediakan. Dokumentasi dan daftar endpoint API tersedia di Dokumen API Portal Biznet Gio. Kami juga menyediakan Postman Collection yang dapat Anda download dan import melalui Postman Collection NEO Lite.

Dalam artikel ini, kami akan memberi contoh step by step cara provisioning NEO Lite menggunakan Postman. Pastikan Anda telah mendownload dan mengimport Postman Collection & Postman Environment sebelum melanjutkan.

Sebelum memulai, Anda harus memiliki token untuk akses API. Jika Anda belum memilikinya, Anda dapat membuatnya di portal melalui menu Generate API Key pada layanan portal.biznetgio.com. Sebagai perhatian, untuk token yang digenerate mohon disimpan dengan baik karena hanya sekali melakukan generate, kemudian apabila kedepannya Anda kehilangan token yang sudah digenerate, bisa request ulang ke Tim Support kami.

B. API NEO Lite

Jika sudah memiliki token masuk ke tab Environment >Import > Portal Biznet Gio. Anda akan mendapat dua environment seperti berikut:

1. PORTAL_BIZNETGIO_ENDPOINT = https://api.portal.biznetgio.com

2. PORTAL_BIZNETGIO_TOKEN = Ubah dan masukkan token yang Anda dapat dari Portal Biznet Gio

Untuk membuat NEO Lite terdapat beberapa langkah dan beberapa endpoint yang harus disiapkan, silakan ikuti langkah-langkah berikut dengan seksama.

Keypair

Pastikan Anda sudah memiliki keypair pada Portal, jika belum silakan buat keypair baru atau import keypair yang sudah ada dengan endpoint berikut.

Membuat keypair baru:

Untuk membuat keypair baru masuk ke Collection API Portal Biznet Gio > NEO Lite Provisioning > Create Key Pair. Ubah bagian body > name menjadi nama keypair yang Anda inginkan dan klik Send. Pastikan Anda menyimpan private_key karena nanti diperlukan untuk akses ke VM.

Import keypair baru:

Jika Anda sudah memiliki keypair dan ingin menggunakan keypair tersebut maka anda dapat mengimport keypair tersebut, dengan cara masuk ke Collection API Portal Biznet Gio > NEO Lite Provisioning > Import Key Pair. Pada bagian body > ubah name & public_key sesuai milik Anda, contohnya seperti berikut:

Jika Anda sebelumnya telah membuat atau mengimport keypair dari portal, Anda dapat melewati dua langkah pertama. Anda cukup cek detail keypairnya dengan endpoint Collection API Portal Biznet Gio > NEO Lite Provisioning > List Key Pair. Pada bagian ini silakan di catat keypair_id yang nantinya ingin digunakan.

Flavor

Sebelum membuat VM Anda juga perlu menentukan Flavor yang ingin digunakan, untuk melihat list Flavor yang tersedia gunakan Collection API Portal Biznet Gio > NEO Lite Provisioning > List Flavor. Pada endpoint ini, Anda akan mendapat list Flavor dengan detail seperti harga monthly & annually, pada bagian ini silakan di cari Flavor yang ingin digunakan dan simpan product_id nya.

Operating System

Selanjutnya Anda juga perlu memilih OS yang akan digunakan, untuk melihat list OS gunakan endpoint Collection API Portal BiznetGio > NEO Lite Provisioning > List OS. Perhatikan gambar di bawah ini, Anda perlu merubah “1547” dengan Product_id yang di dapat dari endpoint sebelumnya, untuk ID “1547” sendiri adalah ID Flavor XS.1.1. Dengan endpoint ini Anda akan mendapat List OS yang dapat digunakan nanti.

Create Virtual Machine

Setelah mendapat flavor_id, keypair_id & OS yang ingin digunakan maka Anda sudah siap untuk membuat VM baru, silakan gunakan endpoint Collection API Portal Biznet Gio > NEO Lite Provisioning > Create VM.

Pada bagian ini terdapat body / parameter yang harus Anda kirimkan dalam bentuk JSON. Untuk detailnya seperti berikut:

· product_id: Isi dengan Flavor ID yang di dapat pada langkansebelumnya

· cycle: Isi dengan “m” untuk monthly dan “a” untuk annually

· select_os: Isi dengan nama OS yang ingin digunakan, untuk list OSdapat dilihat pada langkah sebelumnya

· keypair_id: Isi dengan ID Keypair yang di dapat sebelumnya.

· vm_name: Nama VM

· description: Isi deskripsi tentag VM (Opsional)

· ssh_and_console_user: Isikan username yang nanti digunakan untukakses console dan SSH

· console_password: Isikan password yang nanti digunakan untukakses console dan SSH

· promocode: Isi kode promo jika ada.

· pay_invoice_with_cc: “yes” jika pembayaran ingin di tarik dari CCdan “no” jika tidak menggunakan CC

Contoh sebagai berikut

Jika Anda mendapatkan status 200, artinya pembuatan VMtelah berhasil. Untuk melihat daftar VM, Anda dapat menggunakan endpoint Collection API Portal Biznet Gio > NEO Lite Provisioning > List VM / VPS.Anda dapat memfilter daftar VM berdasarkan statusnya dengan menggunakan params "status" dengan value "Active", "Pending","Suspended", atau "Terminated". Jika Anda tidak mengisi params "status", maka daftar akan menampilkan semua VM.

Update Virtual Machine

Setelah berhasil membuat VM, selanjutnya Anda dapatmencoba mengubah VM dengan API, seperti merubah nama, ubah package, upgradestorage, ubah VM state, dan rebuild VM.

Mengubah nama VM

Untuk merubah nama VM gunakan endpoint Collection API Portal Biznet Gio > NEO Lite Provisioning > Change VM Name. Ubah parameter name pada body ke nama baru yang ingin Anda gunakan dan ubah “102947”menjadi account_id VM anda untuk melihat account ID dapat menggunakan endpoint List VM sebelumnya.

Mengubah package

Untuk merubah atau me-resize package anda dapat menggunakan endpoint Collection API Portal Biznet Gio > NEO Lite Provisioning > Change Package. Pada endpoint ini ada dua hal yang perlu diperhatikan yaitu account_id dan new_product_id. Ubah account_id pada path url contohnya silakan ubah “102947” menjadi account_id VM anda dan ubah new_product_id menjadi Flavor ID tujuan, misal XS1.1 dengan id 1547 di ubah menjadi SS2.2 dengan id 1550.

Upgrade storage

Secara bawaan storage NEO Lite hanya sebesar 60Gb dan jika Anda membutuhkan upgrade maka Anda dapat menggunakan endpoint Collection API Portal Biznet Gio > NEO Lite Provisioning > Upgrade Storage. Sama seperti endpoint sebelumnya, pada endpoint ini Anda perlu menambahkan account_id pada path url, dan merubah disk_size pada parameter body.

Mengubah VM State

Untuk merubah state VM seperti Start, Stop, & Reboot, Anda dapat menggunakan endpoint Collection API Portal Biznet Gio > NEO Lite Provisioning > Change VM State. Sama seperti endpoint sebelumnya, Anda juga harus menentukan account_id pada parameter path url dan Anda dapat merubah path terakhir sesuai kebutuhan seperti: start, stop, reset, resume, suspend & shutdown.

Contohnya jika ingin melakukan reboot maka gunakan reset pada path terakhir endpointnya seperti capture berikut:

Rebuild VM

Untuk kebutuhan rebuild juga dapat dilakukan melalui API, Anda dapat menggunakan endpoint Collection API Portal Biznet Gio > NEO Lite Provisioning > Rebuild VM. Pada endpoint ini Anda juga perlu menyesuaikan account_id pada path url dan pada parameter body. Sesuaikan OS yang ingin digunakan, untuk mendapat List OS bisa dilihat dari endpoint List OS sebelumnya.

Delete Virtual Machcine

Anda juga bisa menghapus VM dan Keypair menggunakan API,contohnya seperti berikut.

Menghapus VM

Untuk menghapus VM silakan menggunakan endpoint CollectionAPI Portal Biznet Gio > NEO Lite Delete > Delete VM. Pada endpoint ini silakan ditentukan juga account_id pada path parameter seperti berikut:

Menghapus Keypair

Untuk menghapus keypair, Anda dapat menggunakan endpoint Collection API Portal Biznet Gio > NEO Lite Provisioning > Delete Keypair. Dan tambahkan id keypair yang ingin dihapus pada path parameter, untuk id keypair dapat dilihat dari endpoint List Key Pair.

Kesimpulan

Dengan memanfaatkan API yang sudah kami sediakan, Andabisa melakukan pemesanan layanan NEO Lite dan NEO Metal lebih dari satusehingga bisa memudahkan Anda untuk memanajemen dan mengintegrasikan dengankebutuhan Anda.