HTTP 触发器

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

在 Cloud Run functions 中，对函数网址的请求始终需要 HTTPS。

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

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

部署

您可以在部署函数时指定 HTTP 触发器。如需查看部署函数的一般说明，请参阅部署 Cloud Run functions 函数。如需了解有关在部署期间配置 HTTP 触发器的其他信息，请参阅本部分。

gcloud

如果您要使用 gcloud CLI 进行部署，则可使用此处显示的标志配置 HTTP 触发器：

gcloud functions deploy YOUR_FUNCTION_NAME \
--trigger-http \
[--allow-unauthenticated] \
[--security-level=SECURITY_LEVEL] \
...

控制台

如果您要使用 Google Cloud 控制台进行部署，可以在触发器部分配置 HTTP 触发器：

  • 在 HTTPS 下的身份验证字段中，根据您是否要允许对函数进行未经身份验证的调用，选择一个选项。默认情况下，需要进行身份验证。如需了解详情，请参阅进行身份验证以便调用。

函数网址

使用 HTTP 触发器部署函数后，您可以检索为其分配的网址。

函数具有分配的网址，格式如下。这些网址具有确定性格式，这意味着您可以在部署函数之前预测网址的内容：

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

函数还具有分配的网址，该网址与底层 Cloud Run 服务相关联。这些网址没有确定性格式，由于第二个字段是随机哈希，因此您无法在部署函数之前预测网址的内容。部署函数后，网址将保持稳定，但：

https://FUNCTION_NAME-RANDOM_HASH-REGION.a.run.app

函数的 cloudfunctions.net 网址和 run.app 网址的行为完全相同。它们可以互换使用。

您可以按如下方式检索函数的网址：

gcloud

gcloud functions describe YOUR_FUNCTION_NAME \
--region=YOUR_FUNCTION_REGION \
--format="value(serviceConfig.uri)" \
...

控制台

  1. 前往 Google Cloud 控制台中的 Cloud Run functions 概览页面：

    前往 Cloud Run 函数

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

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

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

后续步骤