Mulai cepat: Membuat pusat API Anda - Azure CLI
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 memerlukanapic-extension
ekstensi Azure CLI. Jika Anda belum menggunakanaz apic
perintah, ekstensi dapat diinstal secara dinamis saat Anda menjalankan perintah pertamaaz 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.