Latihan - Membuat API baru di API Management dari aplikasi fungsi

  • 15 menit

Untuk memberikan Azure Functions kepada pengguna sebagai bagian dari API tunggal, Anda dapat menambahkannya ke Azure API Management.

Di perusahaan toko online Anda, pengembang Anda membuat beberapa Azure Functions sebagai layanan mikro. Setiap fungsi mengimplementasikan sebagian kecil dari fungsionalitas toko. Anda ingin merakit fungsi-fungsi ini menjadi satu API.

Dalam latihan ini, Anda membuat instans API Management baru lalu menambahkan fungsi Detail Produk ke dalamnya.

Membuat fungsi

Dalam langkah-langkah berikut, Anda menambahkan aplikasi Azure Function ke Azure API Management. Kemudian, Anda menambahkan aplikasi fungsi kedua ke instans API Management yang sama untuk membuat SATU API tanpa server dari beberapa fungsi. Mari mulai dengan menggunakan skrip untuk membuat fungsi:

  1. Untuk mengkloning proyek fungsi, jalankan perintah berikut di Azure Cloud Shell di sebelah kanan.

    git clone https://github.com/MicrosoftDocs/mslearn-apim-and-functions.git ~/OnlineStoreFuncs

  2. Jalankan perintah berikut di Azure Cloud Shell untuk menyiapkan sumber daya Azure yang diperlukan yang kita butuhkan untuk latihan ini.

    cd ~/OnlineStoreFuncs
bash setup.sh

    setup.sh Skrip membuat dua aplikasi fungsi di grup sumber daya kotak pasir yang diaktifkan untuk modul ini. Seperti yang digambarkan dalam grafik berikut, setiap aplikasi menghosting satu fungsi - OrderDetails dan ProductDetails. Skrip juga menyiapkan akun penyimpanan untuk fungsi. Kedua fungsi memiliki URL di domain azurewebsites.net. Nama fungsi terdiri dari angka acak agar unik. Skrip ini membutuhkan waktu beberapa menit untuk diselesaikan.

    Diagram illustrating the results of the setup.sh script and how the functions relate to the overall application's design.

Menguji fungsi ProductDetails

Sekarang, mari uji fungsi ProductDetails untuk melihat bagaimana perilakunya sebelum kita menambahkannya ke API Management.

  1. Masuk ke portal Microsoft Azure menggunakan akun yang sama yang digunakan untuk mengaktifkan sandbox.

  2. Pada menu portal Microsoft Azure atau dari halaman Beranda, pilih Semua sumber daya. Panel Semua sumber daya muncul.

  3. Pilih Aplikasi Fungsi yang namanya dimulai dengan ProductFunction. Panel Aplikasi Fungsi muncul dengan tab Gambaran Umum dipilih.

    Screenshot of menu selections to open ProductDetails function.

  4. Dari daftar fungsi untuk aplikasi fungsi Anda, pilih ProductDetails. Panel Fungsi ProductDetails muncul.

  5. Di menu Detail Produk, di bawah Pengembang, pilih Kode + Uji. Panel Kode + Uji untuk fungsi ProductDetails muncul, menampilkan isi file function.json.

    Screenshot of the ProductDetails Code and Test pane, with Test/Run selected in the command bar.

  6. Di bilah perintah, pilih Uji/Jalankan. Panel Input/Output muncul untuk menguji permintaan HTTP Anda.

  7. Pada tab Input, dalam daftar turun bidang metode HTTP, pilih GET.

  8. Di bawah Kueri, Pilih Tambahkan parameter

  9. Di bidang Name, masukkan ID, dan di bidang Value, masukkan 3, lalu pilih Jalankan.

    Screenshot of the input pane for Test + Run, with the input parameter for the HTTP GET method highlighted.

  10. Panel log muncul untuk menyambungkan permintaan. Tab Output menampilkan kode respons HTTP (200 OK) dan isi untuk item 3 dalam database.

    Screenshot of the output of a pane for Test + Run with response results of running the GET method.

    Secara opsional, Anda juga dapat menguji fungsi dengan memasukkan nilai ID 1 dan 2.

  11. Pilih Tutup untuk menutup tab Output Input untuk Kode + Uji.

  12. Di bilah perintah panel Kode + Uji ProductDetails, pilih Dapatkan URL fungsi. Perhatikan bahwa subdomain URL adalah nama aplikasi fungsi Anda, diikuti oleh domain azurewebsites.net.

Catatan

Anda dapat menggunakan URL ini untuk menguji fungsi di browser Anda. URL membutuhkan input; tambahkan &id=1 string kueri untuk meminta detail tentang item pertama dalam koleksi produk Anda.

Mengekspos aplikasi fungsi sebagai API menggunakan Azure API Management

Setelah aplikasi fungsi disebarkan dan diuji, mari kita ekspor sebagai API menggunakan Azure API Management sehingga dapat dipanggil dari aplikasi dan layanan lain.

  1. Di menu sumber daya, pilih Semua sumber daya. Panel Semua sumber daya muncul.

  2. Urutkan daftar sumber daya menurut jenis. Perhatikan bahwa Anda memiliki aplikasi OrderFunction dan aplikasi ProductFunction.

  3. Pilih aplikasi fungsi ProductFunction.

  4. Di menu Aplikasi Fungsi, gulir ke kategori API , lalu pilih API Management. Panel API Management muncul untuk aplikasi fungsi ProductFunction Anda.

    Screenshot showing menu selection to open the API Management app service.

  5. Di bidang API Management, pilih Buat baru. Panel Instal gateway API Management muncul.

    Screenshot showing settings for an API Management service.

  6. Masukkan nilai berikut untuk setiap pengaturan.

    Pengaturan Nilai
    Langganan Langganan Concierge
    Grup sumber daya [nama grup sumber daya sandbox]
    Wilayah Pilih lokasi yang mendukung Rencana Penggunaan: (AS) US Barat, US Tengah Utara, Eropa Barat, Eropa Utara, Asia Tenggara, Australia Timur
    Nama sumber daya OnlineStore
    Nama organisasi OnlineStore
    Email administrator Masukkan alamat email.
    Tingkatan harga Konsumsi (99,95% SLA)

  7. Pilih Berikutnya: Pemantauan dan kosongkan opsi Application Insights.

  8. Pilih Tinjau + Buat. Saat validasi selesai, pilih Buat untuk membuat instans API Management tertaut. Biarkan beberapa menit agar ekspor selesai.

  9. Saat instans API Management disebarkan, pilih Tautkan API.

    Screenshot of API Management highlighting the Link API button.

    Panel layanan API Management Impor Azure Functions muncul dengan fungsi ProductDetails disorot.

    Screenshot showing the Import Azure Functions API Management service pane.

  10. Pilih tombol Pilih untuk melanjutkan. Kotak dialog Buat dari Aplikasi Fungsi muncul.

    Screenshot showing the Create from Function app dialog box.

  11. Ubah bidang Akhiran URL API menjadi produk, lalu pilih Buat. Azure membuat API untuk fungsi ProductDetails. Tab Desain untuk panel API Management untuk aplikasi fungsi Anda muncul.

Latihan ini menunjukkan bahwa Anda dapat menentukan API Anda, semuanya dari dalam layanan Azure Function App.

Menguji titik akhir produk OnlineStore

Anda sekarang memiliki API ProductDetails dalam instans API Management yang Anda buat. Mari kita uji API itu dengan alat API Management di Azure.

  1. Di panel API Management pada aplikasi fungsi Anda, pilih tab Uji. Operasi yang tersedia untuk API Anda muncul di kolom kiri.

  2. Pilih GET ProductDetails. Panel Konsol ProductDetails muncul.

  3. Di bagian Parameter kueri, pilih Tambahkan parameter.

    Screenshot showing ProductDetails Console with query parameter values highlighted for the GET HTTP request.

  4. Di bidang NAME, masukkan id, dan di bidang VALUE, masukkan 1, lalu pilih Kirim untuk membuat permintaan GET.

    Bagian Respons HTTP konsol memiliki dua tab, Pesan dan Lacak. Tab Pesan diisi dengan respons HTTP. Detail produk muncul dalam format JSON di akhir respons. Gulir ke atas ke bagian Permintaan HTTP dan perhatikan format permintaan. Permintaan tersebut dikirim ke tujuan di domain azure-api.net. Lokasi ini berbeda dari domain azurewebsites.net tempat aplikasi fungsi dihosting. Anda dapat menguji API ini dengan parameter kueri lainnya, seperti id=2 atau id=3.

    Screenshot showing the **Http request** and **HTTP response** message.