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

<ph type="x-smartling-placeholder"></ph> 您正在查看 Apigee Edge 文档。
转到 Apigee X 文档
信息

2016 年 8 月 30 日(星期二),我们发布了适用于公有云的新版 Apigee Edge。

<ph type="x-smartling-placeholder">

新功能和更新

以下是此版本中的新功能和更新:

“分配”中的 JSON 载荷 发送消息和提出错误

使用“Assign Message”或“Raise Fault”政策设置 JSON 载荷时,用户有时 需要使用临时解决方法来确保 JSON 消息在运行时格式正确,例如 以反斜杠“\”开头或指定 variablePrefix 和 variable 后缀 载荷元素,即使消息中未使用变量,也是如此。

有了这项增强功能,无需任何变通方案即可确保 JSON 消息的格式正确无误,并且 可以使用大括号指定变量,而不会创建无效的 JSON。例如, 以下内容会在 JSON 消息中插入 message.content 的值:

<Payload contentType="application/json">{"message" : "{message.content}"}</Payload>

如果您使用了解决方法,您的代码将继续照常运行。您还可以使用 以表示变量的 variablePrefix 和 variableSuffix,而不是大括号。

请参阅 <Set><载荷>元素(位于分配消息政策中)和 引发错误政策 参考文档。(APIRT-1160)

从 XML 到 JSON 的政策增强功能

“XML to JSON”政策已得到增强,并具备以下功能。您可以配置 以便:

  • 在转换过程中将一些 XML 元素视为数组,这样会将值放入方形 方括号“[ ]”。
  • 去除或消除最终 JSON 文档中的 XML 文档层次结构的各个层级。

有关详情,请参阅 XML JSON 政策。(APIRT-1144)

以下位置中存在多个通配符: API 产品资源路径

在 API 产品中定义资源路径时,您可以在 资源路径。例如,/team/*/invoices/** 允许对任意参数进行 API 调用, 在 /team 和任何资源路径后添加一个值 invoices/之后。API 调用上允许的 URI 将 为 proxyBasePath/team/finance/invoices/company/a

如果在此版本之后,您现有的 API 产品资源路径停止按预期运行,请将 恢复为先前的 行为:features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

JavaScript 中的 Crypto 函数

全新一组高性能 JavaScript crypto 函数现已推出 创建、获取和更新以下对象:MD5、SHA-1、SHA256、SHA512。 crypto 对象还可让您获取 各种格式的日期。如需了解详情,请参阅 JavaScript 对象模型。 (APIRT-2886)

Java 调用程序 JAR 版本 正在检查

将 Java JAR 资源上传到 API 代理时,系统会返回 HTTP 400 状态代码 (而不是 500) 的 Java 版本,请参阅支持的软件和 支持的版本。(MGMT-3420)

API 代理资源验证

当您将 API 代理资源文件(例如 JavaScript 或 Java JAR)存储在 环境或组织范围内,验证框架不再需要同时 将 API 代理级别的这些资源添加到代理软件包中,以便导入并通过验证。 现在,资源验证会在部署时进行,而不是在导入时进行验证。(MGMT-1430)

配置超时 针对单个 API 代理

您可以将 API 代理配置为在指定时间后超时(采用 504 网关超时设置) 状态)。主要使用场景是面向拥有 API 代理的 Private Cloud 客户, 等待时间更长。例如,假设您需要特定代理在 3 分钟后超时。您可以 在 API 代理的配置中使用新的 api.timeout 属性。具体方法如下 不妨使用 3 分钟示例来实现此目的:

  1. 首先,请务必将负载平衡器、路由器和消息处理器配置为超时 3 分钟后开始。
  2. 然后,将相关代理配置为在 3 分钟后超时。在 毫秒。例如:
    <ProxyEndpoint name="default">
      <HTTPProxyConnection>
        <BasePath>/v1/weather</BasePath> 
        <Properties> 
          <!-- api.timeout is in milliseconeds -->
          <Property name="api.timeout">180000</Property>
        </Properties>
        ...
  3. 但请注意,延长系统超时可能会导致性能问题,因为 没有 api.timeout 设置的所有代理都使用更高的新负载平衡器、路由器和 消息处理器超时。因此,请配置其他不需要更长超时时间的 API 代理。 缩短超时时间例如,以下代码将 API 代理设置为在 1 秒后超时 分钟:
    <Property name="api.timeout">60000</Property>

无法修改 Edge 超时的 Cloud 客户也可以配置 API 代理超时, 只要超时短于标准边缘消息处理器超时 (57) 。

您不能使用变量填充该值。此媒体资源在 端点属性参考文档。(APIRT-1778)

用于邮件日志记录的 TLS/SSL 政策

<KeyStore><TrustStore> 可在 SSLInfo 配置(针对消息日志记录政策), 允许使用日志记录服务进行单向和双向 TLS/SSL。在消息日志记录政策上配置 SSLInfo 的方式与 在代理上执行的操作 TargetEndpoint 错误。但是,消息日志记录 TLS/SSL 仅支持 TCP 协议。 (APIRT-1858)

已修复 Bug

此版本中修复了以下 Bug。此列表主要供用户检查其支持服务工单中的问题是否已修复,并非旨在为所有用户提供详细信息。

问题 ID 说明
SECENG-609 在删除关联的信任库或 当信任存储区中的有效证书被删除时
MGMT-3404 查看/检索 Node.js 日志和部署代理 慢
MGMT-3400 如果执行调用的用户在调用 /userroles Management API 时 “+”登录姓名
MGMT-3368 java.lang.ArrayIndexOutOfBoundsException: 1(导入 API 代理软件包时) 包含 resources/node/resources 目录
MGMT-3364 OAuthV2:redirect_uri 检查
MGMT-3319 列出保险柜中其中一个条目的值为 null 的条目不起作用 (CPS 和非 CCP)
MGMT-3226 在组织/环境级别查询不应提取导致 API 的所有数据 若失败
Release_160302 存在一个错误,即在组织级别/环境中列出资源 如果资源的累计大小超过 16MB,则修复级别失败,此修复 。
AXAPP-2429 使用 response_status_code 的 Google Analytics API 会返回数据访问权限 错误
AXAPP-2386 修复 Google Analytics 每日电子邮件报告中空白的报告内容
AXAPP-2347 未收到每日分析数据摘要电子邮件
APIRT-3141 调用新的 ExecutionResult() 时,Java 调用程序会失败,因为构造函数 已设为私享
APIRT-3140 HEAD API 调用中的 ServiceCallout 政策不起作用
APIRT-3131 通过 外部身份验证提供方
APIRT-3121 对组织资源文件所做的更改并非 100% 有效
APIRT-3117 MP 的 CPU 利用率已达到 100%,已停止处理流量
APIRT-3016 路由器“通话超时”部署错误
APIRT-2975 上传证书包失败
APIRT-2955 无法针对 FHIR 投诉掩盖 JSON 响应数据的某些属性 Content-Type 标头“application/json+fhir”
APIRT-2946 OAuthV2-RefreshToken 策略不隐藏属性,即使显示设置为 false
APIRT-2908 在 TLS1.2 更新后, 虚拟主机
APIRT-2901 从缓存返回的 Gzip 压缩响应会进行双重压缩
APIRT-2873 在删除 API 密钥后,MPS 会抛出与 VerifyAPIKey 相关的 NullPointerException products/developers/proxies
APIRT-2871 I/O 密集型政策在 Trace 中出现两次
APIRT-2825 访问令牌错误响应中的语法错误
APIRT-2750 特定组织的流量失败情况较高
APIRT-2685 抛出未知错误,流量无法传输
APIRT-2647 “底层输入流返回零字节”出错 nonprod/dev
APIRT-2630 尝试从缓存中读取值时发生间歇性问题
APIRT-2620 为某些阻塞步骤提供单独的线程池
APIRT-2610 带有响应缓存政策的 java.lang.ClassCastException
APIRT-2608 响应缓存政策中的 Last-Modified 标头解析错误
APIRT-2605 “组织”和“环境”不应允许覆盖变量 通过政策
APIRT-2566 OAuthV2 政策返回格式不正确的 WWW-Authenticate 标头
APIRT-2491 由于管理和管理之间的 RPC 超时,TargetServer 更新失败 米/秒
APIRT-2386 在允许 OAuth 的 API 产品中创建空字符串范围 范围
APIRT-2383 XSL 转换政策似乎不会在 错误
APIRT-2364 OAuth 故障流变量出错时未更新
APIRT-2216 服务器发送的事件 - 生产环境中的事件流出现问题
APIRT-2079 创建的 c网址 调用在超时过期后无法停止 会话
APIRT-1495 XML 威胁防护功能无法捕获内容类型
APIRT-347 XSL 策略在导入时未得到正确验证(不指定结果 以便按文档说明输出变量)