HTTP 觸發條件 (第 1 代)

在 Cloud Run functions 中，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 控制台部署，可以在「Trigger」(觸發條件) 部分設定 HTTP 觸發條件：

  1. 在「Trigger type」(觸發條件類型) 欄位中，選取「HTTP」。
  2. 在「Authentication」(驗證) 欄位中，根據是否要允許未經驗證叫用函式，選取適當的選項。系統預設會要求驗證。詳情請參閱「函式叫用驗證」。
  3. 選取或取消選取「Require HTTPS」(必須使用 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 functions」(Cloud Run 函式) 頁面

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

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

  4. 在「Trigger」(觸發條件) 部分查看函式的網址。

後續步驟