IntegrationCallout 政策

本页面适用于 Apigee 和 Apigee Hybrid。

概览

借助 IntegrationCallout 政策，您可以运行具有 API 触发器的 Apigee 集成。但是，在运行集成之前，您必须先运行 SetIntegrationRequest 政策。SetIntegrationRequest 政策会创建一个请求对象，并将该对象作为流变量提供给 IntegrationCallout 政策。请求对象具有集成详细信息，例如 API 触发器名称、集成项目 ID、集成名称以及 SetIntegrationRequest 政策中配置的其他详细信息。IntegrationCallout 政策使用请求对象的流变量来运行集成。您可以配置 IntegrationCallout 政策，将集成运行响应保存在流变量中。

如果您要在代理流中间运行集成，则 IntegrationCallout 政策非常有用。或者，您也可以通过将集成端点指定为目标端点来运行集成，而不是配置 IntegrationCallout 政策。如需了解详情，请参阅 IntegrationEndpoint。

此政策是一项可扩展政策，使用此政策可能会影响费用或使用情况，具体取决于您的 Apigee 许可。如需了解政策类型和使用情况影响，请参阅政策类型。

<IntegrationCallout>

指定 IntegrationCallout 政策。

下表提供了 <IntegrationCallout> 的子元素的简要说明：

<IntegrationCallout> 元素使用以下语法：

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<IntegrationCallout continueOnError="[true|false]" enabled="[true|false]" name=POLICY_NAME>
  <DisplayName>POLICY_DISPLAY_NAME</DisplayName>
  <AsyncExecution>BOOLEAN_ASYNC_EXECUTION</AsyncExecution>
  <Request clearPayload="[true|false]">REQUEST_FLOW_VARIABLE_NAME</Request>
  <Response>RESPONSE_FLOW_VARIABLE_NAME</Response>
</IntegrationCallout>

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<IntegrationCallout continueOnError="false" enabled="true" name="Integration-Callout">
  <DisplayName>Integration-Callout-1</DisplayName>
  <AsyncExecution>true</AsyncExecution>
  <Request clearPayload="true">my_request_flow_var</Request>
  <Response>my_response_flow_var</Response>
</IntegrationCallout>

此元素具有所有政策中常见的以下属性：

子元素参考

<DisplayName>

除了用于 name 属性之外，还可用于在管理界面代理编辑器中使用其他更加自然的名称标记政策。

<DisplayName> 元素适用于所有政策。

<DisplayName> 元素使用以下语法：

<PolicyElement>
  <DisplayName>POLICY_DISPLAY_NAME</DisplayName>
  ...
</PolicyElement>

<PolicyElement>
  <DisplayName>My Validation Policy</DisplayName>
</PolicyElement>

<DisplayName> 元素没有属性或子元素。

<AsyncExecution>

指定用于运行集成的模式。您可以同步或异步运行集成。

如果设置为 true，则集成会异步运行。如果设置为 false，则集成会���步运行。

• 异步模式：当运行集成的请求到达端点时，端点会立即返回集成执行 ID，但会在 <ScheduleTime> 元素指定的时间开始执行集成。如果您尚未设置 <ScheduleTime> 元素，则安排立即运行集成。即使计划立即运行，其集成也可能在几秒钟后开始。集成开始执行时，会发生以下两种情况：
  • 集成会返回 HTTP 200 OK 状态代码，以便调用方可以继续处理。
  • IntegrationCallout 政策完成。
  开始后，集成的完成时间上限不能超过 50 分钟。
• 同步模式：当运行集成的请求到达端点时，端点会立即开始执行集成并等待响应。完成执行的时间上限为 2 分钟。执行完成后，该端点会返回包含执行 ID 和其他响应数据的响应。

<AsyncExecution> 元素使用以下语法：

<AsyncExecution>BOOLEAN</AsyncExecution>

<AsyncExecution>true</AsyncExecution>

<Request>

指定具有 SetIntegrationRequest 政策创建的请求对象的流变量。 IntegrationCallout 政策会将此请求对象发送给 Apigee Integration 以运行集成。

<Request> 元素使用以下语法：

<Request clearPayload="true">FLOW_VARIABLE_NAME</Request>

<Request clearPayload="true">my_request_flow_var</Request>

下表介绍 <Request> 的特性：

<Response>

指定用于保存集成响应的流变量。

如果未指定此元素，则该政策会将响应保存在 integration.response 流变量中。

<Response> 元素使用以下语法：

<Response>FLOW_VARIABLE_NAME</Response>

<Response>my_response_flow_var</Response>

错误代码

本部分介绍当此政策触发错误时的故障代码、错误消息以及由 Apigee 设置的故障变量。在您要开发故障规则来处理故障时，此信息非常重要。如需了解详情，请参阅您需要了解的有关政策错误的信息和处理故障。

运行时错误

政策执行时可能会发生这些错误。

故障变量

只要政策中存在执行错误，Apigee 就会生成错误消息。您可以在错误响应中查看这些错误消息。很多时候，系统生成的错误消息可能与您的产品上下文无关。您可能希望根据错误类型自定义错误消息，以使消息更有意义。

如需自定义错误消息，可以使用故障规则或 RaiseFault 政策。如需了解故障规则与 RaiseFault 政策之间的差异，请参阅 FaultRule 与 RaiseFault 政策。您必须使用故障规则和 RaiseFault 政策中的 Condition 元素来检查条件。Apigee 提供每个政策独有的故障变量，并在政策触发运行时错误时设置故障变量的值。通过使用这些变量，您可以检查特定的错误情况并采取适当的操作。如需详细了解如何检查错误条件，请参阅构建条件。

下表介绍了特定于此政策的故障变量。

相关主题

如需详细了解 Apigee 的集成功能，请参阅什么是 Apigee Integration？