Pemicu HTTP (generasi ke-1)

Dalam 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.

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 Deploy fungsi Cloud Run untuk petunjuk umum tentang cara men-deploy fungsi, dan bagian ini untuk informasi tambahan khusus untuk 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 penanda ini berarti panggilan ke fungsi memerlukan autentikasi. Lihat Mengautentikasi untuk pemanggilan untuk informasi selengkapnya.
Tujuan --security-level flag mengontrol apakah endpoint fungsi memerlukan HTTPS. Nilai secure-always berarti HTTPS diperlukan dan permintaan HTTP non-SSL tidak didukung. Nilai secure-optional berarti HTTP dan HTTPS didukung. Defaultnya adalah secure-always.

Konsol

Jika Anda melakukan deployment menggunakan Konsol Google Cloud, Anda dapat mengonfigurasi pemicu HTTP di bagian Pemicu:

Pada kolom Jenis pemicu, pilih HTTP.
Di kolom Authentication, pilih salah satu opsi bergantung pada apakah Anda ingin mengizinkan pemanggilan yang tidak diautentikasi fungsi tersebut. Secara default, autentikasi diwajibkan. Lihat Mengautentikasi untuk pemanggilan untuk informasi selengkapnya.
Centang atau hapus centang pada kotak Wajibkan HTTPS untuk mengontrol apakah endpoint fungsi memerlukan HTTPS. Jika tidak dipilih, baik HTTP maupun HTTPS didukung.

URL Fungsi

Setelah fungsi di-deploy dengan pemicu HTTP, Anda dapat mengambil URL yang ditetapkan.

Fungsi Cloud Run telah menetapkan URL yang memiliki format font. URL ini memiliki format deterministik, yang berarti Anda dapat memprediksi URL sebelum men-deploy fungsi:

https://REGION-PROJECT_ID.cloudfunctions.net/FUNCTION_NAME

Anda dapat mengambil URL fungsi sebagai berikut:

gcloud

  gcloud functions describe YOUR_FUNCTION_NAME 

  --format="value(httpsTrigger.url)"

Konsol

Buka halaman ringkasan fungsi Cloud Run di Konsol Google Cloud:

Buka fungsi Cloud Run
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.