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

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

Panduan cepat ini menjelaskan langkah-langkah untuk membuat instans baru API Management 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 akun Azure, buat akun gratis sebelum memulai.

Prasyarat

• Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai menggunakan 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 az login. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Mengautentikasi ke Azure menggunakan Azure CLI.

  • Saat diminta, instal ekstensi Azure CLI saat pertama kali digunakan. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan dan mengelola ekstensi dengan Azure CLI.

  • Jalankan az version untuk menemukan versi dan pustaka dependen yang terinstal. Untuk meng-upgrade ke versi terbaru, jalankan az upgrade.

• Artikel ini memerlukan Azure CLI versi 2.11.1 atau yang lebih baru. Jika menggunakan Azure Cloud Shell, versi terbaru sudah terpasang.

Membuat 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 bernama myResourceGroup di lokasi US Tengah dengan perintah az group create berikut:

az group create --name myResourceGroup --location centralus

Buat instans untuk API Management

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

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

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

Secara default, perintah membuat instans di tingkat Pengembang, opsi ekonomis untuk mengevaluasi Azure API Management. Tingkat ini bukan untuk penggunaan produksi. Untuk informasi selengkapnya tentang penskalaan tingkat API Management, lihat peningkatan dan skala.

Petunjuk / Saran

Dibutuhkan waktu antara 30 dan 40 menit untuk membuat dan mengaktifkan layanan API Management di tingkat ini. Perintah sebelumnya menggunakan --no-wait opsi 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 adalah Online dan instans layanan memiliki alamat gateway dan alamat IP publik. Untuk saat ini, 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 saat tidak diperlukan.

az group delete --name myResourceGroup

Langkah selanjutnya

Impor dan publikasikan API pertama Anda