Menjalankan fungsi Azure dengan permintaan HTTP

  • 10 menit

Permintaan HTTP adalah operasi umum pada sebagian besar platform dan perangkat. Apakah itu permintaan untuk mencari kata dalam kamus atau untuk mendapatkan cuaca lokal, kita mengirim permintaan HTTP sepanjang waktu. Azure Functions memungkinkan kita untuk dengan cepat menjalankan bagian logika ketika permintaan HTTP diterima.

Di unit ini, Anda akan mempelajari cara membuat dan memanggil fungsi menggunakan pemicu HTTP. Anda juga akan menjelajahi beberapa opsi penyesuaian yang tersedia untuk pemicu HTTP.

Apa itu pemicu HTTP?

Pemicu HTTP adalah pemicu yang menjalankan kode saat menerima permintaan HTTP. Pemicu HTTP memiliki banyak kemampuan dan kustomisasi, termasuk:

  • Menyediakan akses resmi dengan menyediakan kunci.
  • Membatasi kata kerja HTTP mana yang didukung.
  • Mengembalikan data kembali ke pemanggil.
  • Menerima data melalui parameter string kueri atau melalui isi permintaan.
  • Mendukung templat rute URL untuk mengubah URL fungsi.

Saat membuat pemicu HTTP, Anda perlu memberikan nama untuk pemicu dan memilih tingkat Otorisasi.

Apa itu tingkat otorisasi pemicu HTTP?

Tingkat Otorisasi pemicu HTTP adalah bendera yang menunjukkan apakah permintaan HTTP masuk memerlukan kunci API untuk otorisasi.

Ada tiga tingkat Otorisasi:

  1. Function
  2. Anonim
  3. Admin

Tingkat Fungsidan Admin adalah berbasis "kunci". Untuk mengirim permintaan HTTP, Anda harus menyediakan kunci untuk otorisasi. Ada dua jenis kunci: fungsi danhost. Perbedaan antara kedua kunci ini adalah ruang lingkupnya. Kunci fungsi adalah khusus untuk fungsi. Kunci host berlaku untuk semua fungsi di dalam aplikasi fungsi. Jika tingkat Otorisasi Anda diatur ke Function, Anda dapat menggunakan fungsi atau kunci host. Jika tingkat Otorisasi Anda diatur ke Admin, Anda harus menyediakan kunci host.

Penting

Karena kunci host menyediakan akses yang ditingkatkan ke aplikasi fungsi Anda, Anda harus mengangkut dan menyimpannya dengan aman.

Tingkat Anonim berarti bahwa otorisasi tidak diperlukan. Latihan ini menggunakan tingkat otorisasi Anonim.

Cara membuat pemicu HTTP

Sama seperti pemicu timer, Anda dapat membuat pemicu HTTP melalui portal Microsoft Azure. Di dalam fungsi Azure Anda, pilih pemicu HTTP dari daftar jenis pemicu yang telah ditentukan, lalu masukkan logika yang ingin Anda jalankan dan buat penyesuaian, seperti membatasi penggunaan kata kerja HTTP tertentu.

Salah satu pengaturan yang penting untuk dipahami adalah Nama parameter permintaan. Pengaturan ini adalah untai yang mewakili nama parameter yang berisi informasi tentang permintaan HTTP masuk. Secara default, nama parameternya adalah req.

Cara memanggil pemicu HTTP

Untuk memanggil pemicu HTTP, Anda mengirim permintaan HTTP ke URL untuk fungsi Anda. Untuk mendapatkan URL ini, buka halaman kode untuk fungsi Anda, lalu pilih tautan Dapatkan URL fungsi.

Screenshot of the Azure portal showing a Functions App pane with the app's Get function URL button highlighted.

Setelah Anda memiliki URL untuk fungsi, Anda dapat mengirim permintaan HTTP. Jika fungsi Anda menerima data, ingatlah bahwa Anda dapat menggunakan parameter string kueri atau menyediakan data melalui isi permintaan.

Pemicu HTTP dijalankan saat menerima permintaan HTTP ke URL fungsinya. Pemicu HTTP memungkinkan Anda menerima data, menjalankan logika, dan secara opsional mengembalikan data ke pemanggil.