A.Pendahuluan

Selain melakukan pemesanan NEO Metal melalui portal Biznet Gio, Anda bisa melakukan pemesanan banyak NEO Metal dalam satu waktu dengan 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 Metal.

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

B. Konfigurasi

Sebelum memulai, Anda harus memiliki token untuk akses API. Jika Anda belum memilikinya, Anda dapat membuatnya di portal melalui menu Generate API Key. 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. 

API NEO Metal

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

Untuk membuat NEO Metal 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 membuat keypair baru atau import keypair yang sudah ada dengan endpoint berikut. 

Create Keypair

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

Import Keypair

Jika anda sudah memiliki keypair dan ingin menggunakan keypair tersebut maka anda dapat meng import 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: 

List Keypair

Jika sebelumnya anda sudah membuat / import keypair dari portal maka anda dapat melewati dua langkah diatas, dan anda cukup mengecek detail keypairnya dengan endpoint Collection API Portal Biznet Gio > NEO Metal Provisioning > List Key Pair. Pada bagian ini silakan di catat keypair_id yang nantinya ingin digunakan. 

List 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 Metal 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. 

List OS

Selanjutnya anda juga perlu memilih OS yang akan digunakan, untuk melihat list OS gunakan endpoint Collection API Portal Biznet Gio > NEO Metal Provisioning > List OS. Perhatikan capture di bawah ini, anda perlu merubah “638” dengan ID Flavor yang di dapat dari endpoint sebelumnya, untuk ID “638” sendiri adalah ID Flavor Small v1 – Banten 1, Dengan endpoint ini anda akan mendapat List OS yang dapat digunakan nanti. 

Create NEO Metal

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

 

• product_id: Isi dengan Product ID sesuai flavor yang di dapat pada langkan sebelumnya 
• cycle: Isi dengan “m” untuk monthly dan “a” untuk annually 
• select_os: Isi dengan nama OS yang ingin digunakan, untuk list OS dapat dilihat pada langkah sebelumnya 
• keypair_id: Isi dengan ID Keypair yang di dapat sebelumnya. 
• label: Isi dengan nama baremetal
• public_ip: Isi dengan 1(menggunakan IP Public) atau 0(tanpa IP Public) 
• promocode: Isi kode promo jika ada
• pay_invoice_with_cc: “yes” jika pembayaran ingin di tarik dari CC dan “no” jika tidak menggunakan CC. 

Contohnya sebagai berikut:

 

 

Jika Anda mendapatkan status 200, artinya pembuatan NEO Metal telah berhasil. Untuk melihat daftar NEO Metal, Anda dapat menggunakan endpoint Collection API Portal Biznet Gio >NEO Metal Provisioning > List NEO Metal. Anda dapat memfilter daftar NEO Metal 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 NEO Metal

Setelah berhasil membuat NEO Metal, selanjutnya anda dapat mencoba mengubah NEO Metal dengan API, seperti mengubah nama, state NEO Metal dan rebuild NEO Metal. 

Change NEO Metal Name

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

Change NEO Metal State

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

 

Rebuild NEO Metal

Untuk kebutuhan rebuild juga dapat dilakukan melalui API, anda dapat menggunakan endpoint Collection API Portal Biznet Gio > NEO Metal 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 NEO Metal

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

Untuk menghapus NEO Metal silakan menggunakan endpoint Collection API Portal Biznet Gio > NEO Metal Delete > Delete NEO Metal. Pada endpoint ini silakan di spesifikan juga account_id pada path parameter seperti berikut: 

Delete Keypair

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

C. Kesimpulan

Dengan memanfaatkan API  yang sudah kami sediakan, Anda bisa melakukan pemesanan layanan  NEO Metal lebih dari satu sehingga bisa memudahkan Anda untuk memanajemen dan mengintegrasikan dengan kebutuhan Anda.

Semoga artikel yang telah kami sampaikan dapat membantu Anda. Anda juga dapat menemukan artikel lainnya melalui halaman Knowledge Base Biznet Gio. Jika Anda masih memiliki kendala teknis terkait dengan layanan Biznet Gio, Anda dapat menghubungi kami melalui email support@biznetgio.com atau dapat melalui telpon (021) 5714567.