Mulai cepat: Membuat pusat API Anda - Azure CLI

Artikel
01/23/2025

Buat pusat API Anda untuk memulai inventarisasi API organisasi Anda. Azure API Center memungkinkan PELACAKAN API di lokasi terpusat untuk penemuan, penggunaan kembali, dan tata kelola.

Setelah membuat pusat API Anda, ikuti langkah-langkah dalam tutorial untuk menambahkan metadata kustom, API, versi, definisi, dan informasi lainnya.

Prasyarat

Jika Anda tidak memiliki langganan Azure, buat akun gratis Azure sebelum memulai.
Setidaknya penetapan peran Kontributor atau izin yang setara dalam langganan Azure.

Untuk Azure CLI:
- 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.
Catatan

az apic perintah memerlukan apic-extension ekstensi Azure CLI. Jika Anda belum menggunakan az apic perintah, ekstensi dapat diinstal secara dinamis saat Anda menjalankan perintah pertama az apic , atau Anda dapat menginstal ekstensi secara manual. Pelajari selengkapnya tentang ekstensi Azure CLI.

Lihat catatan rilis untuk perubahan dan pembaruan terbaru di apic-extension. Fitur tertentu mungkin memerlukan pratinjau atau versi ekstensi tertentu.

Mendaftarkan penyedia Microsoft.ApiCenter

Jika belum melakukannya, Anda perlu mendaftarkan penyedia sumber daya Microsoft.ApiCenter di langganan Anda. Anda hanya perlu mendaftarkan penyedia sumber daya sekali.

Untuk mendaftarkan penyedia sumber daya dalam langganan Anda menggunakan Azure CLI, jalankan perintah berikut az provider register :

az provider register --namespace Microsoft.ApiCenter

Anda dapat memeriksa status pendaftaran dengan menjalankan perintah berikut az provider show :

az provider show --namespace Microsoft.ApiCenter

Buat grup sumber daya

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

Buat grup sumber daya menggunakan az group create perintah . Contoh berikut membuat grup yang disebut MyGroup di lokasi US Timur:

az group create --name MyGroup --location eastus

Membuat pusat API

Buat pusat API menggunakan az apic create perintah .

Contoh berikut membuat pusat API yang disebut MyApiCenter di grup sumber daya MyGroup . Dalam contoh ini, pusat API disebarkan di lokasi Eropa Barat. Ganti nama pusat API pilihan Anda dan masukkan salah satu lokasi yang tersedia untuk pusat API Anda.

az apic create --name MyApiCenter --resource-group MyGroup --location westeurope

Output dari perintah terlihat mirip dengan yang berikut ini. Secara default, pusat API dibuat dalam paket Gratis.

{
  "dataApiHostname": "myapicenter.data.westeurope.azure-apicenter.ms",
  "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/mygroup/providers/Microsoft.ApiCenter/services/myapicenter",
  "location": "westeurope",
  "name": "myapicenter",
  "resourceGroup": "mygroup",
  "sku": {
    "name": "Free"
  },
  "systemData": {
    "createdAt": "2024-06-22T21:40:35.2541624Z",
    "lastModifiedAt": "2024-06-22T21:40:35.2541624Z"
  },
  "tags": {},
  "type": "Microsoft.ApiCenter/services"
}

Setelah penyebaran, pusat API Anda siap digunakan!

Langkah berikutnya

Sekarang Anda dapat mulai menambahkan informasi ke inventori di pusat API Anda. Untuk membantu Anda mengatur API dan informasi lainnya, mulailah dengan menentukan metadata kustom di pusat API Anda.

Menentukan metadata kustom

Bagikan melalui