Mengimpor aplikasi Azure Functions sebagai API di Azure API Management

BERLAKU UNTUK: Semua tingkatAN API Management

Azure API Management mendukung pengimporan Aplikasi Fungsi Azure sebagai API baru atau menambahkannya ke API yang sudah ada. Proses ini otomatis menghasilkan kunci host di Aplikasi Fungsi Azure, yang kemudian ditetapkan ke nilai bernama di Azure API Management.

Artikel ini menunjukkan cara mengimpor dan pengujian Aplikasi Azure Function sebagai API di Azure API Management.

Anda akan mempelajari cara untuk:

• Mengimpor Aplikasi Azure Function sebagai API
• Menambahkan Aplikasi Azure Function ke API
• Menampilkan kunci host Aplikasi Azure Function yang baru dan nilai bernama Azure API Management
• Menguji API di portal Microsoft Azure

Prasyarat

• Menyelesaikan mulai cepat Membuat instans Azure API Management.
• Pastikan Anda memiliki aplikasi Azure Functions di langganan Anda. Untuk informasi selengkapnya, lihat Membuat Aplikasi Azure Function. Azzure Function harus memiliki pemicu HTTP dan tingkat otorisasi yang diatur ke Anonim atau Function.

Catatan

Anda dapat menggunakan Ekstensi API Management untuk Visual Studio Code untuk mengimpor dan mengelola API Anda. Ikuti tutorial Ekstensi API Management untuk memasang dan memulai.

Membuka instans API Management Anda

1. Di portal Microsoft Azure, cari dan pilih layanan API Management.

   

2. Di halaman layanan API Management, pilih instans API Management Anda.

   

Mengimpor Aplikasi Fungsi Azure sebagai API baru

Ikuti langkah-langkah di bawah ini untuk membuat API baru dari Aplikasi Azure Function.

1. Navigasikan ke layanan API Management Anda di portal Microsoft Azure dan pilih API dari menu.

2. Di daftar Tambahkan API baru, pilih Aplikasi Function.

   

3. Klik Telusuri untuk memilih Function yang akan diimpor.

   

4. Klik pada bagian Aplikasi Function untuk memilih dari daftar Aplikasi Function yang tersedia.

   

5. Temukan Aplikasi Function yang ingin Anda impor Function-nya, klik dan tekan Pilih.

   

6. Pilih Function yang ingin Anda impor dan klik Pilih.

   • Anda hanya dapat mengimpor Function berdasarkan pemicu HTTP dengan tingkat otorisasi Anonim atau Function.

   

7. Beralih ke Tampilan penuh dan tetapkan Produk ke API baru Anda.

8. Jika diperlukan, tentukan bidang lain selama pembuatan atau konfigurasikan nanti melalui tab Pengaturan.

   • Pengaturan dijelaskan dalam tutorial ​​Impor dan publikasikan API pertama Anda.

   Catatan

   Produk adalah asosiasi dari satu atau lebih API yang ditawarkan kepada pengembang melalui portal pengembang. Pertama, pengembang harus berlangganan produk untuk mendapatkan akses ke API. Setelah berlangganan, mereka mendapatkan kunci langganan untuk API apa pun dalam produk tersebut. Sebagai pembuat instans API Management, Anda adalah administrator dan berlangganan ke setiap produk secara default.

   Setiap instans API Management dilengkapi dengan dua produk sampel default:

   • Starter
   • Tidak Terbatas

9. Klik Buat.

Menambahkan Aplikasi Fungsi Azure ke API yang sudah ada

Ikuti langkah-langkah di bawah ini untuk menambahkan Aplikasi Azure Function ke API yang ada.

1. Di instans layanan Azure API Management Anda, pilih API dari menu di sebelah kiri.

2. Pilih API yang ingin Anda impor aplikasi Azure Function. Klik ... dan pilih Impor dari menu pintasan.

   

3. Klik pada petak Aplikasi Function.

   

4. Di jendela pop-up, klik Telusuri.

   

5. Klik pada bagian Aplikasi Function untuk memilih dari daftar Aplikasi Function yang tersedia.

   

6. Temukan Aplikasi Function yang ingin Anda impor Function-nya, klik dan tekan Pilih.

   

7. Pilih Function yang ingin Anda impor dan klik Pilih.

   

8. Klik Impor.

   

Authorization

Mengimpor Aplikasi Azure Function secara otomatis menghasilkan:

• Kunci host di dalam Aplikasi Function dengan nama apim-{nama instans layanan Azure API Management Anda},
• Nilai yang bernama di dalam instans Azure API Management dengan nama {nama instans Aplikasi Azure Function Anda}-key, yang berisi kunci host yang dibuat.

Untuk API yang dibuat setelah tanggal 4 April 2019, kunci host diteruskan dalam permintaan HTTP dari API Management ke Aplikasi Function di header. API yang lebih lama meneruskan kunci host sebagai parameter kueri. Anda dapat mengubah perilaku ini melalui PATCH Backendpanggilan REST API pada entitas Backend yang terkait dengan Function App.

Peringatan

Menghapus atau mengubah nilai kunci host Aplikasi Azure Function atau nilai yang bernama pada Azure API Management akan memutus komunikasi antara layanan. Nilai tidak disinkronkan secara otomatis.

Jika Anda perlu memutar kunci host, pastikan nilai bernama di Azure API Management juga dimodifikasi.

Mengakses kunci host Aplikasi Azure Function

1. Navigasi ke instans Aplikasi Azure Function Anda.

   

2. Di bagian Function dari menu navigasi samping, pilih Kunci aplikasi.

   

3. Temukan kunci di bawah bagian Kunci host.

   

Mengakses nilai bernama dalam Azure API Management

Navigasi ke instans Azure API Management Anda dan pilih Nilai bernama dari menu di sebelah kiri. Kunci Aplikasi Azure Function disimpan di sana.

Menguji API baru di portal Microsoft Azure

Anda dapat memanggil operasi langsung dari portal Microsoft Azure. Menggunakan portal Microsoft Azure adalah cara yang mudah untuk melihat dan menguji operasi API.

1. Pilih API yang Anda buat di bagian sebelumnya.

2. Pilih tab Uji.

3. Pilih operasi yang ingin Anda uji.

   • Halaman akan menampilkan bidang parameter dan header kueri.
   • Salah satu header adalah "Ocp-Apim-Subscription-Key", untuk kunci langganan produk yang terkait dengan API ini.
   • Sebagai pembuat instans API Management, Anda sudah menjadi administrator, sehingga kunci terisi secara otomatis.

4. Pilih Kirim.

   • Ketika tes berhasil, backend akan merespons dengan 200 OK dan beberapa data.

Topik terkait

• Batasan impor API
• Mengimpor spesifikasi OpenAPI
• Mengimpor API SOAP
• Mengimpor SOAP API dan mengonversi ke REST
• Impor API App Service
• Impor API Aplikasi Kontainer
• Mengimpor API WebSocket
• Mengimpor API GraphQL
• Mengimpor skema GraphQL dan menyiapkan penyelesai bidang
• Impor Aplikasi Fungsi Azure
• Impor Azure Logic App
• Impor layanan Service Fabric
• Mengimpor API OData
• Mengimpor metadata SAP OData
• Mengimpor API gRPC
• Edit API

Langkah berikutnya

Mengubah dan memproteksi API yang diterbitkan