Bagikan melalui


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:

    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.