HTTP 触发器（第 1 代）

在 Cloud Functions 中，HTTP 触发器能够使函数运行以响应 HTTP(S) 请求。当您为函数指定 HTTP 触发器时，系统会为函数分配一个网址，用于接收请求。HTTP 触发器支持 GET、POST、PUT、DELETE 和 OPTIONS 请求方法。

默认情况下，对使用 HTTP 触发器的函数的请求需要身份验证。您可以在部署期间选择允许未经身份验证的调用。如需了解详情，请参阅允许未经身份验证的 HTTP 函数调用。

您使用 HTTP 函数来实现可以处理常规 HTTP(S) 请求的 Cloud Functions 函数。

部署

您可以在部署函数时指定 HTTP 触发器。如需查看部署函数的一般说明，请参阅部署 Cloud Functions 函数。如需了解有关在部署期间配置 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. 在触发器类型字段中，选择 HTTP。
  2. 在身份验证字段中，根据您是否要允许对函数进行未经身份验证的调用，选择一个选项。默认情况下，需要进行身份验证。如需了解详情，请参阅进行身份验证以便调用。
  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 functions 概览页面：

    前往 Cloud Run 函数

  2. 点击您要检索其网址的函数的名称。

  3. 点击“编辑”标签页。

  4. 在触发器部分中查看函数的网址。

后续步骤