HTTP 觸發條件 (第 1 代)

在 Cloud Run 函式中，HTTP 觸發事件可讓函式在回應 HTTP(S) 要求時執行。為函式指定 HTTP 觸發條件時，系統會為函式指派可接收要求的網址。HTTP 觸發條件支援 GET、POST、PUT、DELETE 和 OPTIONS 要求方法。

根據預設，針對含有 HTTP 觸發事件的函式提出要求時，必須進行驗證。您可以選擇在部署期間允許未經驗證的呼叫。詳情請參閱「允許未經驗證的 HTTP 函式叫用」。

您可以使用 HTTP 函式實作可處理一般 HTTP(S) 要求的 Cloud Run 函式。

部署作業

您可以在部署函式時指定 HTTP 觸發條件。如需部署函式的一般操作說明，請參閱「部署 Cloud Run 函式」一文，如需在部署期間設定 HTTP 觸發事件的其他資訊，請參閱本節。

gcloud

如果您是使用 gcloud CLI 進行部署，請使用以下旗標設定 HTTP 觸發事件：

gcloud functions deploy YOUR_FUNCTION_NAME \
--no-gen2 \
--trigger-http \
[--allow-unauthenticated] \
[--security-level=SECURITY_LEVEL] \
...
  • --trigger-http 標記會指定函式使用 HTTP 觸發條件。
  • --allow-unauthenticated 旗標會指定函式可在未經驗證的情況下呼叫。略過這個旗標表示呼叫函式需要驗證。詳情請參閱「驗證呼叫」。
  • --security-level 標記可控管函式端點是否需要 HTTPS。值 secure-always 表示必須使用 HTTPS，且不支援非 SSL HTTP 要求。值 secure-optional 表示同時支援 HTTP 和 HTTPS。預設為 secure-always。

主控台

如果您使用 Google Cloud 控制台部署，可以在「觸發條件」部分設定 HTTP 觸發條件：

  1. 在「Trigger type」(觸發條件類型) 欄位中，選取「HTTP」。
  2. 在「Authentication」欄位中，選取所需選項，視您是否要允許未經驗證的函式叫用。根據預設，您必須進行驗證。詳情請參閱「驗證呼叫」。
  3. 選取或清除「需要 HTTPS」核取方塊，即可控制函式端點是否需要 HTTPS。如果取消選取，系統就會同時支援 HTTP 和 HTTPS。

函式網址

使用 HTTP 觸發條件部署函式後，您可以擷取其指派的網址。

Cloud Run 函式會指派使用以下格式的網址。這些網址具有確定的格式，也就是說，您可以在部署函式之前預測網址的格式：

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

您可以透過下列方式擷取函式的網址：

gcloud

  gcloud functions describe YOUR_FUNCTION_NAME 

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

主控台

  1. 前往 Google Cloud 控制台的 Cloud Run 函式總覽頁面：

    前往 Cloud Run 函式

  2. 按一下要擷取網址的函式名稱。

  3. 按一下「編輯」分頁。

  4. 在「觸發條件」專區中查看函式的網址。

後續步驟