Pemicu HTTP
Di fungsi Cloud Run, pemicu HTTP memungkinkan fungsi berjalan sebagai respons terhadap permintaan HTTP(S). Saat Anda menentukan pemicu HTTP untuk suatu fungsi, fungsi tersebut
akan diberi URL yang dapat digunakan untuk menerima permintaan. Pemicu HTTP mendukung
metode permintaan GET
, POST
, PUT
, DELETE
, dan OPTIONS
.
Di fungsi Cloud Run, permintaan ke URL fungsi selalu memerlukan HTTPS.
Secara default, permintaan ke fungsi dengan pemicu HTTP memerlukan autentikasi. Anda dapat memilih untuk mengizinkan panggilan yang tidak diautentikasi selama deployment. Lihat Mengizinkan pemanggilan fungsi HTTP yang tidak diautentikasi untuk mengetahui informasi selengkapnya.
Anda menggunakan fungsi HTTP untuk mengimplementasikan fungsi Cloud Run yang dapat menangani permintaan HTTP(S) umum.
Deployment
Anda dapat menentukan pemicu HTTP saat men-deploy fungsi. Lihat Men-deploy fungsi Cloud Run untuk mengetahui petunjuk umum tentang cara men-deploy fungsi, dan bagian ini untuk mengetahui informasi tambahan khusus terkait cara mengonfigurasi pemicu HTTP selama deployment.
gcloud
Jika Anda men-deploy menggunakan gcloud CLI, flag yang ditampilkan di sini digunakan untuk mengonfigurasi pemicu HTTP:
gcloud functions deploy YOUR_FUNCTION_NAME \ --trigger-http \ [--allow-unauthenticated] \ [--security-level=SECURITY_LEVEL] \ ...
- Flag
--trigger-http
menentukan bahwa fungsi tersebut menggunakan pemicu HTTP. - Flag
--allow-unauthenticated
menentukan bahwa fungsi dapat dipanggil tanpa autentikasi. Menghapus flag ini berarti bahwa panggilan ke fungsi tersebut memerlukan autentikasi, yang merupakan setelan default. Lihat Mengautentikasi untuk pemanggilan untuk informasi selengkapnya.
Konsol
Jika men-deploy menggunakan konsol Google Cloud, Anda dapat mengonfigurasi pemicu HTTP di bagian Pemicu:
- Di bagian HTTPS, pada kolom Authentication, pilih opsi bergantung pada apakah Anda ingin mengizinkan pemanggilan fungsi yang tidak terautentikasi atau tidak. Secara default, autentikasi diwajibkan. Lihat Mengautentikasi untuk pemanggilan untuk informasi selengkapnya.
URL Fungsi
Setelah fungsi di-deploy dengan pemicu HTTP, Anda dapat mengambil URL yang ditetapkan.
Fungsi telah menetapkan URL dengan format berikut. URL ini memiliki format deterministik, yang berarti Anda dapat memprediksi URL sebelum men-deploy fungsi:
https://REGION-PROJECT_ID.cloudfunctions.net/FUNCTION_NAME
Fungsi juga memiliki URL yang ditetapkan yang terkait dengan layanan Cloud Run yang mendasarinya. URL ini tidak memiliki format yang deterministik, yang berarti bahwa karena kolom kedua adalah hash acak, Anda tidak dapat memprediksi URL-nya sebelum menerapkan fungsi. Akan tetapi, setelah fungsi ini di-deploy, URL akan tetap stabil:
https://FUNCTION_NAME-RANDOM_HASH-REGION.a.run.app
URL cloudfunctions.net
dan URL run.app
dari fungsi akan berperilaku
sama persis. URL ini dapat dipertukarkan.
Anda dapat mengambil URL fungsi sebagai berikut:
gcloud
gcloud functions describe YOUR_FUNCTION_NAME \ --region=YOUR_FUNCTION_REGION \ --format="value(serviceConfig.uri)" \ ...
Konsol
Buka halaman ringkasan fungsi Cloud Run di konsol Google Cloud:
Klik nama fungsi yang URL-nya ingin Anda ambil.
Klik tab Edit.
Lihat URL fungsi Anda di bagian Pemicu.
Langkah berikutnya
- Pelajari cara menulis fungsi HTTP.
- Pelajari cara men-deploy fungsi Cloud Run.
- Lihat tutorial fungsi HTTP untuk mengetahui contoh penulisan, deployment, dan pemanggilan fungsi HTTP.