“返回”任务

通过返回任务，您可以自定义与集成执行失败期间返回的 HTTP 响应代码对应的错误消息。

您可以修改或自定义以下 HTTP 响应代码的错误消息：
HTTP 代码 规范代码
400 INVALID_ARGUMENT
400 OUT_OF_RANGE
401 UNAUTHENTICATED
403 PERMISSION_DENIED
404 NOT_FOUND
409 ALREADY_EXISTS
429 RESOURCE_EXHAUSTED
499 CANCELLED

配置返回任务

如需配置返回任务，请执行以下操作：

  1. 在 Apigee 界面中，选择您的 Apigee 组织。
  2. 点击开发 > 集成。
  3. 选择现有集成，或通过点击创建集成来创建新集成。

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

    1. 在创建 Integrations对话框中输入名称和说明。
    2. 从支持的区域列表中选择集成的区域。
    3. 点击创建。

    这将在集成设计器中打开集成。

  4. 在集成设计器导航栏中，点击 + 添加任务/触发器 > 任务以查看可用任务列表。
  5. 点击返回任务元素，并将其放入集成编辑器中。
  6. 点击设计器上的返回任务元素以打开返回任务配置窗格。
  7. 使用任务的配置属性配置显示的字段，详见下表。

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

配置属性

下表介绍了返回任务的配置属性。

属性 数据类型 说明
HTTP code 整数 您要自定义其错误消息的 4XX HTTP 代码。
Customized return message 字符串 指定的 HTTP 代码的自定义错误消息。

错误处理策略

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