19.03.01 - 适用于公有云的 Apigee Edge 版本说明

负载均衡 - 更好地控制如何移除发生故障的服务器

为 API 代理配置 负载平衡器时，您可以确定在从负载均衡轮换中移除服务器之前，发生多少次响应失败。响应失败意味着 Apigee 不会收到目标服务器的任何响应。当出现这种情况时，失败计数器会加 1。当 Apigee 确实收到目标的响应时，即使响应为 HTTP 错误（例如 500），也算作目标服务器的响应，并且失败计数器会被重置。为了帮助确保失败计数器在错误的 HTTP 响应（例如 500）下也加 1，以便尽快让运行状况不佳的服务器停止进行负载平衡轮替，您可以将带有 <ResponseCode> 子元素的新 <ServerUnhealthyResponse> 元素添加到您的负载平衡器配置中。 此外，Edge 也会将包含这些代码的响应视为失败。

<HTTPTargetConnection>
  <LoadBalancer>
    <Algorithm>RoundRobin</Algorithm>
    <Server name="target1" />
    <Server name="target2" />
    <ServerUnhealthyResponse>
        <ResponseCode>500</ResponseCode>
        <ResponseCode>502</ResponseCode>
        <ResponseCode>503</ResponseCode>
    </ServerUnhealthyResponse>
    <MaxFailures>5</MaxFailures>
  </LoadBalancer>
</HTTPTargetConnection>
  
  

AccessControl 政策增强功能

AccessControl 政策用于确定哪些 IP 地址可以调用 API 代理。 该政策中的一个新元素可让 API 开发者更好地控制要评估的 IP 地址。

<IgnoreTrueClientIPHeader>：可选（默认值为 false）。 将此项设置为 true 时，该政策会忽略 True-Client-IP 标头，并根据配置 X-Forwarded-For 评估行为评估 X-Forwarded-For 标头中的 IP 地址。

<AccessControl async="false" continueOnError="false"
    enabled="true" name="Access-Control-1">
    <DisplayName>Access Control-1</DisplayName>
    <IgnoreTrueClientIPHeader>true</IgnoreTrueClientIPHeader>
    ...
</AccessControl>

如需了解详情，请参阅这篇社区帖子。

RaiseFault 政策中新增了两个元素，可使 FaultRules 处理更简洁、更强大。

• ShortFaultReason 是一个布尔值，设置为 true 时，会将政策名称放入 fault.reason 变量中。
• AssignVariable（可在 FaultResponse 中使用）可让您将故障响应分配给一个变量，以供 API 代理流中的其他政策使用。

现在，系统会强制执行托管目标的限制。如需了解限额详情，请参阅限额。

您现在可以使用消息模板变量在 AccessControl 政策中设置 IP 地址和 CIDR 掩码。例如，如果您想在键值对映射 (KVM) 中存储 IP 地址和掩码，可以从您在 API 代理流中设置的变量中检索这些值。这样，您可以在运行时更轻松地更改 IP 值，而无需更改政策配置。

例如，您不应使用以下命令：

<MatchRule action="DENY">
    <SourceAddress mask="24">198.51.100.1</SourceAddress>
</MatchRule>
     

您可以按如下方式配置政策（假设这些值存储在 KVM 中，并且您使用 KeyValueMapOperations 政策检索这些值并将其分配给此处显示的变量）：

<MatchRule action="DENY">
    <SourceAddress mask="{kvm.mask.ref}">{kvm.ip.ref}</SourceAddress>
</MatchRule>
     

API Monitoring 提供了两个角色：API Monitoring Administrator 和 API Monitoring User，如访问 API Monitoring 中所述。这些功能已于 2018 年 12 月推出。

现在，Edge 会将标头 X-Apigee.Message-Timeout 添加到每个请求中。此标头供 Edge 内部使用。不要依赖 API 代理中 X-Apigee.* 标头中的值，因为这些标头不适合客户使用，并且随时可由 Apigee 移除或更改。

处理密钥库删除错误，确保 API 调用不会失败

x-apigee.edge.execution.sense.action 始终设置为 null

在 ResponseCache 政策中，NIOTheread 在执行时未遭到线程池拒绝

Apigee 路由器上的多个日志导出器导致 CPU 使用率过高

特定组织中出现间歇性 404 错误

已部署的共享流未在某些消息处理器上执行

此修复将包含在下一个 Edge for Private Cloud 版本中。

此修复将包含在下一个 Edge for Private Cloud 版本中。

此修复将包含在下一个 Edge for Private Cloud 版本中。