4.16.09 - Edge for Private Cloud 版本说明

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

2016 年 9 月 19 日（星期一），我们发布了新版 Apigee Edge 私有云。

自上一个 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 文档。

私有云

Postgres 升级到版本 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 服务

Assign Message 和 Raise Fault 中的 JSON 载荷 (Cloud 16.08.17)

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

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

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

请参阅分配消息政策和 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 之后包含任意一个值的 API 调用，以及在 invoices/ 之后包含任意资源路径的 API 调用。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 代理，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 代理超时，前提条件是超时短于标准的 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 设置通知。(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)

测试创收（云 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（界面）

已知问题

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