4.16.09 - Edge for Private Cloud 版本说明

您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 信息

2016 年 9 月 19 日（星期一），我们发布了新版 Apigee Edge for Private Cloud。

自上一个 Edge Private Cloud 功能版本以来，已发布以下版本，并且这些版本包含在此功能版本中：

• 云端：16.04.13（界面）、16.04.13（创收）、16.04.20（界面）、16.04.27（创收）、16.04.27（界面）、16.05.04（界面）、16.05.11（界面）、16.05.11（创收）、16.05.18（界面）、16.05.25（创收）、16.06.08（创收）、16.06.15（界面）、16.06.22（创收）、16.06.29（界面）、16.07.06（创收）、16.07.06.02（创收）、16.07.13（界面）、16.07.20.01（创收）、16.07.27（界面）、16.08.17

如需了解如何确定您的 Edge for Private Cloud 版本中是否包含特定云版本，请参阅关于版本编号。

版本概览

在此版本中，经典版 API 代理编辑器已被移除，取而代之的是可与经典版编辑器一起使用的新版代理编辑器。其他值得注意的增强功能包括：改进了 API 产品资源路径的行为；改进了对在“分配消息”和“引发故障”政策中定义的 JSON 载荷的处理；增强了 XML 到 JSON 的转换；改进了资源验证；能够为各个 API 代理设置超时；更新了 API 代理向导中 SOAP 代理的生成；以及适用于 JavaScript 的高性能 Crypto 对象。

创收功能增强包括：新的通知功能（带有通知费率方案）、可将开发者迁移到创收功能的 API，以及将费率方案设为公开或私密的功能。

本主题的其余部分详细介绍了相应版本中包含的所有新功能、更新和 bug 修复。

已弃用

API 服务

移除了经典版代理编辑器（Cloud 16.04.20 界面）

新版 API 代理编辑器现在是唯一受支持的版本。经典版已不再提供，并且“访问经典版代理编辑器”的链接已被移除。如果您之前使用的是经典版，您的 API 代理将自动加载到新版编辑器中。(EDGEUI-498)

创收

以下已弃用的功能已被移除，不再受支持：

• 设置限额
• 发信上限通知

或者，您也可以设置通知，如以下部分中所述：

• 设置活动通知
• 为费率方案创建限额通知

(DEVRT-2742)

新功能和更新

此版本包含以下新功能和增强功能。除了以下增强功能之外，此版本还包含多项可用性、性能、安全性和稳定性增强功能。

如需了解更多详情和说明，请参阅 Edge for Private Cloud 文档。

私有云

将 PostgreSQL 升级到版本 9.4

此版本包含对 Postgres 9.4 的升级。如需了解如何更新系统，请参阅将 Apigee Edge 更新到 4.16.09。

Edge 界面中的 GeoMap 支持

借助地理位置汇总，您可以根据地理位置属性（例如区域、大洲、国家/地区和城市）收集 API 调用的分析数据。通过这些分析数据，您可以在 Edge 界面中查看显示 API 请求位置的地理位置地图。

如需了解详情，请参阅启用地理位置聚合和地理位置地图。

API BaaS

添加了以下方面的文档：

• 如何配置 API BaaS 以使用 TLS。如需了解详情，请参阅为 API BaaS 配置 TLS。
• 如何配置所有 API BaaS Stack 节点以使用共享存储空间，以便所有资产都可供所有 API BaaS Stack 节点使用。如需了解详情，请参阅上传素材资源。
• 如何在配置 BaaS Stack 节点时加密 Cassandra 密码。如需了解详情，请参阅重置 Edge 密码。

监控工具和信息中心的 Beta 版

此版本包含 Edge 的新监控工具和信息中心（Beta 版）。 借助此工具，您可以了解部署中各种组件（路由器、消息处理器、ZooKeeper、Cassandra）的运行状况，以及各种组织和环境的 HTTP 错误代码。您还可以拍摄信息中心数据的快照，并与 Apigee 分享，以帮助解决支持突发事件。

文档（包括安装说明）包含在 Edge 4.16.09 文档中，位于版本 4.18.01。

不过，在安装和使用该信息中心之前，您必须先签署 Apigee 评估协议（也可在版本 4.18.01 中找到），然后通过电子邮件将该协议发送至 orders@apigee.com，返回给 Apigee。

分析数据收集器工具的 Beta 版

所有 Edge for Private Cloud 客户都必须向 Apigee 提交有关 API 代理流量的统计信息。Apigee 建议客户每天上传一次该信息，可能需要创建 Cron 作业。

为了帮助您上传这些数据，Apigee 提供 apigee-analytics-collector 命令行实用程序的 Beta 版。此实用程序会将 API 调用量报告发送回 Apigee。每个 Edge for Private Cloud 安装都可以使用此实用程序来检索流量数据并将其报告给 Apigee。

如需了解详情，请参阅将 API 流量数据上传到 Apigee - Beta 版。

API 服务

“分配消息”和“引发故障”中的 JSON 载荷（Cloud 16.08.17）

通过此增强功能，无需任何解决方法即可确保 JSON 消息格式正确，并且可以使用大括号指定变量，而不会创建无效的 JSON。例如，以下代码会插入 JSON 消息中 message.content 的值：

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

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

请参阅 Assign Message 政策和 Raise Fault 政策参考文档中的 <Set><Payload> 元素。(APIRT-1160)

XML 到 JSON 政策增强功能 (Cloud 16.08.17)

XML 到 JSON 政策已增强，具有以下功能。您可以将政策配置为：

• 在转换期间将某些 XML 元素视为数组，这会将值放在 JSON 文档的方括号“[]”中。
• 在最终 JSON 文档中剥离或消除 XML 文档层次结构中的级别。

如需了解详情，请参阅 XML 到 JSON 政策。(APIRT-1144)

API 产品资源路径中的多个通配符 (Cloud 16.08.17)

在 API 产品中定义资源路径时，您可以在资源路径中的多个位置添加通配符。例如，/team/*/invoices/** 允许在 /team 之后使用任意一个值，在 invoices/ 之后使用任意资源路径。API 调用中允许的 URI 为 proxyBasePath/team/finance/invoices/company/a。

如果在此版本发布后，您现有的 API 产品资源路径无法按预期运行，请在组织中设置以下属性以恢复到之前的行为：features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

JavaScript 中的加密函数 (Cloud 16.08.17)

我们推出了一组新的高性能 JavaScript crypto 函数，用于创建、获取和更新以下哈希对象：MD5、SHA-1、SHA256、SHA512。 您还可以使用 crypto 对象以各种格式获取日期。如需了解详情，请参阅 JavaScript 对象模型。 (APIRT-2886)

Java callout JAR 版本检查 (Cloud 16.08.17)

如果 Java 资源的相应版本与 Edge 支持的 Java 版本（列在支持的软件和支持的版本中）不兼容，则在将 Java JAR 资源上传到 API 代理时，系统会返回 HTTP 400 状态代码（而不是 500）。(MGMT-3420)

API 代理资源验证 (Cloud 16.08.17)

如果您在环境或组织范围内存储了 API 代理资源文件（例如 JavaScript 或 Java JAR），验证框架不再要求您在代理软件包中也包含这些资源，以便导入通过验证。 资源验证现在在部署时进行，而不是在导入时进行。(MGMT-1430)

配置单个 API 代理的超时（Cloud 16.08.17）

您可以将 API 代理配置为在指定时间后超时（状态为 504 网关超时）。主要用例是针对执行时间较长的 API 代理的私有云客户。例如，假设您需要特定代理在 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 代理超时，只要该超时时间短于标准的 Edge 消息处理器超时时间（57 秒）即可。

您无法使用变量填充该值。此属性在端点属性参考文档中进行了介绍。(APIRT-1778)

使用代理向导（Cloud 16.07.27 界面）时的 SOAP 代理行为

使用代理向导通过 WSDL 创建基于 SOAP 的代理时，有两种代理创建选项：

• 透传 SOAP，其中代理只是按原样透传 SOAP 请求载荷。
• REST 到 SOAP 到 REST，其中代理将传入的载荷（例如 JSON）转换为 SOAP 载荷，然后将 SOAP 响应转换回调用方期望的格式。

此版本对这些选项的行为方式进行了以下更新。新旧行为之间的差异在于代理向导自动生成的政策和配置。

透传 SOAP

• 所有 WSDL 操作现在都会发送到代理基本路径“/”，而不是代理资源（例如“/cityforecastbyzip”）。操作名称会传递到目标 SOAP 服务。此行为与 SOAP 规范一致。

• 生成的代理不再支持请求中的 JSON。它仅支持 XML。代理可确保 SOAP 请求具有 Envelope、Body 和命名空间。

REST 到 SOAP 到 REST

• 不支持 WSDL 2.0。
• 新行为尚未通过 WS-Policy 进行测试。
• 借助代理，您可以发布 JSON 数据，而不是 FormParams。
• 使用代理构建器向代理添加 CORS（跨域资源共享）支持时，您会看到以下增强功能：
  • Access-Control-Allow-Headers 标头：除了 Origin、x-requested-with 和 Accept 标头之外，Access-Control-Allow-Headers 标头还包含 Content-Type、Accept-Encoding、Accept-Language、Host、Pragma、Referrer、User-Agent 和 Cache-Control。
  • Access-Control-Allow-Methods 标头：除了 GET、PUT、POST、DELETE 之外，此标头还包含 PATCH 和 OPTIONS 动词。
• 在为 WSDL 生成 API 代理时，Edge 会读取 WSDL 中定义为抽象的任何 ComplexType，并正确识别基于抽象类型的任何实例类型。

wsdl2apigee 开源命令行实用程序

Apigee 还提供了一个开源命令行实用程序，用于从 WSDL 生成直通或 REST-to-SOAP API 代理。请参阅 https://github.com/apigee/wsdl2apigee。

(EDGEUI-614)

键值对映射操作政策中的过期/刷新默认值（Cloud 16.06.15 界面）

借助键值对映射操作政策，您可以确定值在刷新之前保留的时间。刷新间隔通过 <ExpiryTimeInSecs> 元素进行设置。如果执行 GET 操作时已超过过期时间间隔，系统会刷新值，并且政策会获取更新后的值。将此政策添加到 API 代理后，默认过期时间现在为 300 秒。（之前的默认值为 -1，表示值永远不会刷新。）(EDGEUI-579)

创收

可调整的通知费率方案（Cloud 16.04.20 界面，Cloud 16.04.13 创收）

Edge 创收功能中新增的可调整通知费率方案允许 API 提供方调整每个应用开发者的目标交易数量。您可以根据已达到目标数量的百分比（例如 90%、100% 或 150%）来配置是否发送通知以及何时发送通知。除了管理 API（已在之前的版本中提供）之外，此功能还可通过管理界面使用。如需了解详情，请参阅指定可调整的通知计划详情。(DEVRT-2375、DEVRT-2370)

适用于可调整通知费率方案（Cloud 16.04.27 创收）的网络钩子通知

对于通知费率可调整的方案，您可以创建网络钩子，以将通知发送到您指定的网址。您还可以控制通知在达到交易限额之前以特定间隔（百分比）触发。Webhook 通知可为您提供灵活的替代方案，以取代现有的通知模板。请参阅使用 Webhook 设置通知。（DEVRT-2393、DEVRT-2394）

可调整通知的自定义属性费率方案（Cloud 16.05.18 界面）

在 Edge 创收中，新的“具有自定义属性的可调整通知”费率方案可让您使用自定义属性的值来增加开发者的交易次数。采用标准的可调整通知费率方案时，每次成功的 API 调用都会使开发者的交易次数增加 1。不过，如果采用“可调整的通知（含自定义属性）”费率方案，自定义属性的值会添加到开发者的交易次数中。例如，如果自定义属性“small”在响应中的值为 0.1，则交易次数会增加 0.1；如果自定义属性“addressTotal”的值为 50，则交易次数会增加 50。如需了解详情，请参阅指定包含自定义属性详细信息的费率方案。(DEVRT-2504)

根据公司及其开发者的交易总额设置通知（Cloud 16.06.22 创收）

通常情况下，当开发者使用公司应用访问 API 时，系统会自动跟踪公司中所有开发者的交易总额。如果您有开发者正在积极使用自己的开发者应用来访问 API，并且您需要在不中断流量的情况下跟踪他们的总交易量，该怎么办？您可以将开发者添加到公司，并设置在达到基于公司及其开发者的交易总额的阈值时发送通知。如需了解详情，请参阅根据公司及其开发者的交易总额设置通知。 (DEVRT-2643)

查看和重新处理通知（Cloud 16.06.08 创收）

在创收测试套件中，您可以查看并重新处理之前使用管理 API 发送的通知。如需了解详情，请参阅查看和重新处理通知。(DEVRT-2643)

测试创收功能（Cloud 16.05.25 创收）

Monetization 提供了一组 API，您可以使用这些 API 来测试 Webhook 的执行情况，以确保通知能够正常发送。如需了解详情，请参阅测试通知设置。 (DEVRT-2625)

将开发者迁移到创收平台（Cloud 16.05.11 创收）

我们推出了新的 API，以帮助开发者迁移到变现功能。您可以转移交易使用情况，并收取自定义的设置费用和周期性费用。此外，在接受已发布的费率方案时，如果系统已收取设置费，您可以免除该费用。 如需了解详情，请参阅将开发者迁移到创收。(DEVRT-2446)

开发者门户的公开和非公开价格方案（Cloud 16.04.27 创收）

您可以将价格方案设置为“公开”或“非公开”。公开费率方案会显示在开发者门户中；非公开价格则不会。费率方案的默认值为“公开”。如需了解详情，请参阅 http://docs.apigee.com/monetization/content/create-rate-plans#public-versus-private-rate-plans。(DEVRT-2445)

取消暂停开发者账号（Cloud 16.06.08 创收）

创收功能提供了一组 API，您可以使用这些 API 来恢复之前被中止的开发者的账号。如果达到配置的限额，开发者可能会被中止。例如，交易次数已达到上限，或者预付费账号余额已用尽。如需了解相关信息，请参阅恢复开发者账号。(DEVRT-2641)

查看交易状态（Cloud 16.06.08 创收）

作为创收测试套件的一部分，您可以使用管理 API 查看指定时间范围内发生的交易的状态。如需了解详情，请参阅查看交易状态。(DEVRT-2640)

在收入报告中添加开发者自定义属性（Cloud 16.05.25 创收）

对于收入报告，您可以将自定义属性纳入报告中，前提是该自定义属性已针对开发者定义。如需了解详情，请参阅使用 API 在收入报告中添加开发者自定义属性。(DEVRT-2447)

交易记录政策和 API 产品资源一致性（Cloud 16.05.18 界面）

如果创收交易记录政策中的资源路径与相应 API 产品中定义的资源路径不匹配（例如，如果您更改了 API 产品资源路径），则“产品”页面上的交易记录政策图标会显示警告符号。当您点击该图标以查看交易记录政策时，页面顶部会显示警告。当您修正交易记录政策中的资源路径后，警告指示器就会消失。 (DEVRT-2240)

已修复 Bug

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

Edge for Private Cloud

16.08.17

16.07.27（界面）

16.07.20.01（创收）

此版本包含次要的数据库架构更改。此版本中没有其他软件更新。

16.07.13（界面）

16.07.06.02（创收）

16.07.06（创收）

16.06.29（界面）

16.06.22（创收）

无

16.06.15（界面）

16.06.08（创收）

无

16.05.25（创收）

16.05.18（界面）

16.05.11（创收）

16.05.11（界面）

16.05.04（界面）

16.04.27（界面）

16.04.27（创收）

无

16.04.20（界面）

16.04.13（创收）

无

16.04.13（界面）

已知问题

此版本存在以下已知问题：