Menggunakan API Portal Biznet Gio untuk layanan NEO Metal

0 people liked this article

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.

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

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

Membuat Keypair Baru

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 Baru

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:

Check 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.

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.

Operating System

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

Setelah mendapat product_id, keypair_id & os yang ingin digunakan maka anda sudah siap untuk membuat VM baru, silakan gunakan endpoint Collection API Portal Biznet Gio > NEO Metal Provisioning > 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.

Mengubah Nama Baremetal

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.

Mengubah State Baremetetal

Untuk merubah NEO Metal State seperti on, off & reset anda dapat menggunakan endpoint Collection API Portal Biznet Gio > NEO Metal Provisioning > Change NEO Metal State. Sama seperti endpoint sebelumnya juga spesifik kan account_id pada parameter path url dan anda dapat merubah path terakhir sesuai kebutuhan seperti: on, off & reset.

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

Rebuild Baremetal

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.

Hapus Baremetal

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:

Hapus 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.

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.

Apa yang bisa kami bantu?

Menggunakan API Portal Biznet Gio untuk layanan NEO Metal

Pendahuluan

API NEO Metal