请参阅 Application Integration 支持的连接器。

“调用 REST 端点”任务

通过调用 REST 端点任务，您可以从集成调用任何第三方 REST API。REST API 调用返回的响应将以集成变量的形式向您提供，您可以在其他下游任务中使用该变量。

注意：

• 调用 REST 端点任务的网络配置允许其仅通过公共互联网调用端点。因此，该任务无法连接到仅位于专用网络（例如 VPC）内的主机或 IP 地址，即使该 VPC 与您的其他 Google Cloud 服务（如 Apigee X）对等互连也是如此。
• 此任务最多可处理 50 MB 的 REST 响应。

准备工作

• 如需连接到 REST API 调用的身份验证端点，请确保已创建 OAuth 2.0 配置文件或将用户管理的服务账号关联到您的集成。如果您的 API 不需要进行身份验证，则任务配置窗格中的身份验证配置文件字段可以留空。要查看配置列表，请参阅配置属性。

  如果您的集成同时配置了 OAuth 2.0 配置文件和用户管理的服务账号，则默认使用 OAuth 2.0 配置文件进行身份验证。如果 OAuth 2.0 配置文件和用户管理的服务账号均未配置，则执行将失败。

• 如果您的集成关联了服务账号，则根据 REST 端点网址向该服务账号授予所需的 IAM 角色。例如，如果您的 REST 端点网址调用 Cloud Storage 服务，则为 Cloud Storage 服务授予所需的 IAM 角色。

  如需了解如何向服务账号授予角色，请参阅管理对服务账号的访问权限。

• 确保 Google Cloud 项目中未为 Application Integration 设置 VPC Service Controls。
  警告：如果您的 Google Cloud 项目中为 Application Integration 设置了 VPC Service Controls，则 Cloud Functions 将无法运行或停止运行。

配置“调用 REST 端点”任务

如需配置调用 REST 端点任务，请执行以下操作：

1. 在 Google Cloud 控制台中，前往 Application Integration 页面。

   转到 Application Integration

2. 在导航菜单中，点击 Integrations（集成）。

   系统随即会显示集成页面，其中列出了 Google Cloud 项目中提供的所有集成。

3. 选择现有集成，或点击创建集成以创建新集成。

   要创建新的集成，请执行以下操作：

   1. 在 Create Integration（创建集成）窗格中输入名称和说明。
   2. 选择集成区域。
      注意：区域下拉列表仅列出您的 Google Cloud 项目中预配的区域。如需预配新区域，请点击 Enable Region。如需了解详情，请参阅启用新区域。
   3. 为集成选择服务帐号。您随时可以在集成工具栏的 集成摘要窗格中更改或更新集成的服务帐号详细信息。
      注意：仅当您为所选区域启用了集成治理时，系统才会显示用于选择服务帐号的选项。
   4. 点击创建。

   系统会在集成编辑器中打开集成。

4. 在集成编辑器导航栏中，点击 Tasks 以查看可用任务列表。
5. 点击调用 REST 端点元素，并将其放入集成编辑器中。
6. 点击设计器上的调用 REST 端点元素，以查看调用 REST 端点任务配置窗格。
7. 使用任务的配置属性配置显示的字段，详见下表。

   系统会自动保存对属性的更改。

配置属性

下表介绍了调用 REST 端点任务的配置属性。

属性	数据类型	说明
标签	字符串	可选：为任务添加标签。
Authentication	字符串	可选：配置和存储与外部系统连接的身份验证详细信息。如需了解详情，请参阅在 Application Integration 中创建身份验证配置文件。
端点基准网址	字符串	没有查询参数的 REST 端点网址。
HTTP 方法	无	要使用的 HTTP 方法。 您可以选择以下任意一种 HTTP 方法： DELETE GET HEAD PATCH POST PUT
网址查询字符串参数	查询字符串键 - 字符串 值 - 字符串	进行 REST API 调用所需的查询参数。 查询参数采用键值对形式，其中键是键名称，值是相应的键值。您可以通过点击加号图标输入多个键值对。
HTTP 标头	HTTP 标头键 - 字符串 值 - 字符串	进行 REST API 调用所需的 HTTP 标头。 HTTP 标头采用键值对形式，其中键是键名称，值是相应的键值。您可以通过点击加号图标输入多个键值对。
遵循重定向	布尔值	遵循网址重定向。 您可以选择以下任意一个值： True：如果端点基准网址已转发到另一个网址，则调用重定向网址。 False：如果端点基准网址已转发到其他网址，请勿调用重定向网址。
任务应在出现 HTTP 错误时失败	布尔值	REST API 调用失败时的异常处理策略。 如果 HTTP 响应代码为 4xx 或 5xx，则调用 REST 端点会失败。如需查看错误代码列表，请参阅错误代码。对于其他 HTTP 响应代码，请在响应中返回错误代码和错误消息。 注意：对于与 REST API 调用无关的错误（例如网址不正确），无论此选项设置是什么，任务始终会失败。 您可以选择以下任意一个值： True ：抛出异常。 False：不抛出异常。但会在响应中返回错误代码和错误消息。
响应标头（<任务名称>）	字符串	REST API 响应中未压缩的响应标头。
响应正文（<任务名称>）	字符串	REST API 响应中未压缩的响应正文。
响应状态（<任务名称>）	字符串	REST API 响应中的 HTTP 响应代码和相应代码文本。

最佳实践

如需了解适用于调用 REST 端点任务的用量限额，请参阅用量限额。

错误处理策略

任务的错误处理策略指定当任务因暂时性错误而失败时要执行的操作。如需了解如何使用错误处理策略，以及了解不同类型的错误处理策略，请参阅错误处理策略。

如需了解如何处理 4xx 或 5xx 错误的重试策略，请参阅如何根据响应状态重试 REST 调用方任务博客。