Bagikan melalui

Mengekspos API tanpa server dari titik akhir HTTP menggunakan Azure API Management

  • Artikel

Azure Functions terintegrasi dengan Azure API Management di portal untuk memungkinkan Anda mengekspos titik akhir fungsi pemicu HTTP sebagai API REST. API ini sering dijelaskan menggunakan definisi OpenAPI. File JSON (atau YAML) ini berisi informasi tentang operasi apa yang tersedia dalam API. Ini mencakup detail tentang bagaimana data permintaan dan respons untuk API harus disusun. Dengan mengintegrasikan aplikasi fungsi, Anda dapat meminta API Management menghasilkan definisi OpenAPI ini.

Artikel ini menunjukkan kepada Anda cara mengintegrasikan aplikasi fungsi Anda dengan API Management. Integrasi ini berfungsi untuk aplikasi fungsi yang dikembangkan dalam bahasa apa pun yang didukung. Anda juga dapat mengimpor aplikasi fungsi dari Azure API Management.

Untuk fungsi pustaka kelas C#, Anda juga dapat menggunakan Visual Studio untuk membuat dan memublikasikan API tanpa server yang terintegrasi dengan API Management.

Membuat instans API Management

Untuk membuat instans API Management yang ditautkan ke aplikasi fungsi Anda:

  1. Pilih aplikasi fungsi, pilih Manajemen API dari menu sebelah kiri, lalu pilih Buat baru di bawah API Management.

    Pilih API Management

  2. Gunakan pengaturan API Management sebagaimana ditentukan dalam tabel berikut:

    Pengaturan Nilai yang disarankan Deskripsi
    Nama Nama unik global Nama dibuat berdasarkan nama aplikasi fungsi Anda.
    Langganan Langganan Anda Langganan tempat sumber daya baru ini dibuat.
    Grup sumber daya myResourceGroup Sumber daya yang sama dengan aplikasi fungsi Anda, yang harus disiapkan untuk Anda.
    Lokasi Lokasi layanan Pertimbangkan untuk memilih lokasi yang sama dengan aplikasi fungsi Anda.
    Nama organisasi Contoso Nama organisasi yang digunakan di portal pengembang dan untuk pemberitahuan email.
    Email administrator email Anda Email yang menerima notifikasi sistem dari API Management.
    Tingkat harga Consumption Tingkat konsumsi tidak tersedia di semua wilayah. Untuk detail harga lengkap, lihat halaman harga API Management

    Membuat layanan API Management

  3. Pilih Ekspor untuk membuat instans API Management, yang mungkin memerlukan waktu beberapa menit.

  4. Setelah Azure membuat instans, opsi Aktifkan Application Insights diaktifkan di halaman tersebut. Pilih opsi tersebut untuk mengirim log ke tempat yang sama dengan aplikasi fungsi.

Mengimpor fungsi

Setelah instans API Management dibuat, Anda dapat mengimpor titik akhir fungsi yang dipicu HTTP Anda. Contoh ini mengimpor titik akhir bernama TurbineRepair.

  1. Di halaman API Management, pilih Tautkan API.

  2. Fungsi Impor Azure Functions dibuka dengan fungsi TurbineRepair disorot. Klik Pilih untuk melanjutkan.

    Mengimpor Azure Functions ke API Management

  3. Di halaman Buat dari Aplikasi Function, terima defaultnya, lalu pilih Buat.

    Membuat dari Aplikasi Function

    Azure membuat API untuk fungsi tersebut.

Mengunduh definisi OpenAPI

Setelah fungsi Anda diimpor, Anda dapat mengunduh definisi OpenAPI dari instans API Management.

  1. Pilih Unduh definisi OpenAPI di bagian atas halaman.

    Mengunduh definisi OpenAPI

  2. Menyimpan file JSON yang diunduh, lalu buka. Meninjau definisi.

Langkah berikutnya

Anda sekarang dapat memperbaiki definisi dalam API Management di portal. Anda juga dapat mempelajari lebih lanjut tentang API Management.

Edit definisi OpenAPI di API Management