Mulai cepat: Membuat instans Azure API Management baru dengan menggunakan Azure CLI

Artikel
12/15/2023

BERLAKU UNTUK: Konsumsi | Pengembang | Dasar | Standar | Premium

Mulai cepat ini menjelaskan langkah-langkah untuk membuat instans API Management baru dengan menggunakan perintah Azure CLI. Setelah membuat instans, Anda dapat menggunakan Azure CLI untuk tugas manajemen umum seperti mengimpor API di instans API Management Anda.

Azure API Management membantu organisasi menerbitkan API ke pengembang eksternal, mitra, dan internal untuk membuka potensi data dan layanan mereka. API Management menyediakan kompetensi inti untuk memastikan program API yang sukses melalui keterlibatan pengembang, wawasan bisnis, analitik, keamanan, dan perlindungan. Dengan API Management, buat dan kelola gateway API modern untuk layanan backend yang ada yang dihosting di mana saja.

Jika Anda tidak memiliki Langganan Azure, buat Akun gratis Azure sebelum memulai.

Prasyarat

Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai Cepat untuk Bash di Azure Cloud Shell.
Jika Anda lebih suka menjalankan perintah referensi CLI secara lokal, instal Azure CLI. Jika Anda menjalankan Windows atau macOS, pertimbangkan untuk menjalankan Azure CLI dalam kontainer Docker. Untuk informasi lebih lanjut, lihat Cara menjalankan Azure CLI di kontainer Docker.
- Jika Anda menggunakan instalasi lokal, masuk ke Azure CLI dengan menggunakan perintah login az. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Masuk dengan Azure CLI.
- Saat Anda diminta, instal ekstensi Azure CLI pada penggunaan pertama. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan ekstensi dengan Azure CLI.
- Jalankan versi az untuk menemukan versi dan pustaka dependen yang diinstal. Untuk meningkatkan ke versi terbaru, jalankan peningkatan az.

Artikel ini memerlukan Azure CLI versi 2.11.1 atau yang terbaru. Jika menggunakan Azure Cloud Shell, versi terbaru sudah terinstal.

Buat grup sumber daya

Instans Azure API Management, seperti semua sumber daya Azure, harus disebarkan ke dalam grup sumber daya. Grup sumber daya memungkinkan Anda mengatur dan mengelola sumber daya Azure terkait.

Pertama, buat grup sumber daya bernamamyResourceGroup di lokasi US Tengah dengan perintah az goup create berikut:

az group create --name myResourceGroup --location centralus

Membuat instans API Management

Setelah memiliki grup sumber daya, Anda dapat membuat instans API Management. Buat instans tersebut dengan menggunakan perintah az apim create dan berikan nama layanan dan detail penerbit. Nama pengguna harus unik dalam Azure.

Dalam contoh berikut, myapim digunakan sebagai nama layanan. Perbarui nama menjadi nilai unik. Perbarui juga nama organisasi penerbit API dan alamat email untuk menerima pemberitahuan.

az apim create --name myapim --resource-group myResourceGroup \
  --publisher-name Contoso --publisher-email admin@contoso.com \
  --no-wait

Secara {i>defaultmeningkatkan dan menskalakan.

Tip

Dibutuhkan waktu antara 30 dan 40 menit untuk membuat dan mengaktifkan layanan API Management di tingkat ini. Perintah sebelumnya menggunakan opsi --no-wait sehingga perintah segera kembali saat layanan dibuat.

Periksa status penyebaran dengan menjalankan perintah az apim show:

az apim show --name myapim --resource-group myResourceGroup --output table

Awalnya, output mirip dengan yang berikut ini, memperlihatkan Activating status:

NAME         RESOURCE GROUP    LOCATION    GATEWAY ADDR    PUBLIC IP    PRIVATE IP    STATUS      TIER       UNITS
-----------  ----------------  ----------  --------------  -----------  ------------  ----------  ---------  -------
myapim       myResourceGroup   Central US                                             Activating  Developer  1

Setelah aktivasi, statusnya Online dan instans layanannya memiliki alamat gateway dan alamat IP publik. Untuk saat ini, alamat-alamat ini tidak mengekspos konten apa pun. Contohnya:

NAME         RESOURCE GROUP    LOCATION    GATEWAY ADDR                       PUBLIC IP     PRIVATE IP    STATUS    TIER       UNITS
-----------  ----------------  ----------  ---------------------------------  ------------  ------------  --------  ---------  -------
myapim       myResourceGroup   Central US  https://myapim.azure-api.net       203.0.113.1                 Online    Developer  1

Saat instans layanan API Management Anda online, Anda siap menggunakannya. Mulailah dengan tutorial untuk mengimpor dan menerbitkan API pertama Anda.

Membersihkan sumber daya

Anda dapat menggunakan perintah az group delete untuk menghapus grup sumber daya dan instans layanan API Management jika tidak diperlukan.

az group delete --name myResourceGroup

Langkah berikutnya

Impor dan publikasikan API pertama Anda

Bagikan melalui