4.16.09 - Edge for Private Cloud 版本说明

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

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

自上一个 Edge for Private Cloud 功能版本以来，以下版本 已出现，并已包含在此功能版本中：

• Cloud：16.04.13 （界面）、16.04.13 (monetization)，2020 年 4 月 16 日 （界面）、16.04.27 (monetization)，16.04.27 (UI)、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 (monetization)，16.07.06.02 （创收）、16.07.13 （界面）、16.07.20.01 （创收）、16.07.27（界面）、 16.08.17

请参阅关于版本 通过编号来判断特定 Cloud 版本是否 包含在适用于私有云的 Edge 版本中。

版本概览

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

针对获利能力的增强功能包括带有通知率方案的新通知功能、 该 API 可帮助开发者轻松变现，并让用户能够公开费率方案或 私密。

本主题的其余部分包含有关所有新功能、更新和问题修复的详细信息 。

已弃用

API 服务

移除了传统版代理编辑器 (Cloud 16.04.20 界面)

现在，新版 API 代理编辑器是唯一受支持的版本。传统版 并且“访问代理编辑器传统版”链接是 已移除。如果您使用的是传统版，您的 API 代理将在 新编辑器。(EDGEUI-498)

创收

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

• 设置限制
• 发送上限通知

您也可以按照以下部分中的说明设置通知：

• 设置事件 通知
• 创建 价格方案的限制通知

（DEVRT-2742）

新功能和更新

以下是此版本中的新功能和增强功能。除了以下 此版本也包含多项易用性、性能、安全性和稳定性 增强功能。

如需更多详细信息和说明，请参阅“适用于私有云的 Edge”文档。

私有云

Postres 升级到版本 9.4

此版本包含对 Postgres 9.4 的升级。如需有关更新系统的说明， 请参阅将 Apigee Edge 更新为 4.16.09.

Edge 界面中的地理地图支持

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

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

API BaaS

添加了关于以下内容的文档：

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

测试版监控工具和信息中心

此版本包含适用于 Edge 的新监控工具和信息中心的 Beta 版。 借助此工具，您可以了解各种组件（路由器、消息处理器、 （例如，ZooKeeper、Cassandra）和您的 部署。您还可以截取信息中心数据的快照并与 Apigee 共享，以帮助 解决支持突发事件

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

但是，您必须先完成 Apigee 评估，然后才能安装和使用信息中心 协议（同样适用于版本 4.18.01），并在以下日期之前将其返还给 Apigee： 通过电子邮件将其发送到 orders@apigee.com。

分析收集器工具测试版

所有适用于私有云的 Edge 客户都必须向 Apigee 提交有关 API 的统计信息 代理流量Apigee 建议客户每天上传一次这些信息，可能的途径 创建 Cron 作业

为帮助上传此数据，Apigee 提供了 apigee-analytics-collector 命令行的测试版。 实用程序。该实用程序将 API 调用量报告发送回 Apigee。全面覆盖 安装私有云后，可以使用此实用程序检索流量数据，并将其报告给 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，而不是大括号。

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

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

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

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

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

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

在 API 产品中定义资源路径时，您可以在 资源路径。例如，/team/*/invoices/** 允许对任意参数进行 API 调用， 在 /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 调用程序 JAR 版本检查 (Cloud 16.08.17)

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

API 代理资源验证 (Cloud 16.08.17)

当您将 API 代理资源文件（例如 JavaScript 或 Java JAR）存储在 环境或组织范围内，验证框架不再需要同时 将 API 代理级别的这些资源添加到代理软件包中，以便导入并通过验证。 现在，资源验证会在部署时进行，而不是在导入时进行验证。(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 代理设置为超时 1 分钟后：
   <Property name="api.timeout">60000</Property>

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

您不能使用变量填充该值。端点属性 参考。(APIRT-1778)

使用代理向导时的 SOAP 代理行为 (Cloud 16.07.27 界面)

使用代理向导从 WSDL 创建基于 SOAP 的代理时，有两个选项可用于 创建代理：

• 直通式 SOAP，在这种情况下，代理只通过 SOAP 请求 载荷。
• 从 REST 到 SOAP 再到 REST - 代理将传入的载荷（例如 将 JSON 转换为 SOAP 载荷，然后将 SOAP 响应转换回调用方的格式 预期。

此版本包含对这些选项的行为方式的以下更新。区别 这些政策和配置会自动 由代理向导生成

直通式 SOAP

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

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

REST 到 SOAP 到 REST

• WSDL 2.0 不受支持。
• 新行为尚未使用 WS-Policy 进行测试。
• 通过该代理，您可以 POST JSON 数据，而不是 FormParams。
• 使用代理为代理添加 CORS（跨域资源共享）支持时 构建器，您会看到以下增强功能： <ph type="x-smartling-placeholder">
  </ph>
  • 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 会读取定义为 抽象化，并正确识别基于该抽象 。

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%。除 Management API 外，还可通过管理界面使用此功能 （在之前的版本中可用）。有关详情，请参阅指定 可调整的通知计划详情。（DEVRT-2375、DEVRT-2370）

用于可调整通知速率方案的 webhook 通知 (Cloud 16.04.27) 变现）

对于可调整的通知频率方案，您可以创建网络钩子，向 您所指定的网址您还可以控制按特定的时间间隔（百分比）显示通知 直至达到交易限额网络钩子通知为您提供了灵活的 来替代使用现有通知模板。请参阅使用 webhook。（DEVRT-2393、DEVRT-2394）

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

在 Edge Monetization 中，我们新增了“带有自定义属性的可调整通知”通过价格方案 自定义属性值会添加到开发者的交易计数中。使用 可调整的通知率方案，开发者每完成一次 API 调用都会为交易增加 1 分 计数。但在采用“包含自定义属性的可调整通知”费率方案时， 自定义属性会添加到开发者的交易计数中。例如，如果自定义属性 “small”值为 0.1，则事务计数将递增 0.1；或者，如果 自定义属性“addressTotal”的值为 50，计数将递增 50。有关 相关信息，请参阅指定费率方案 包含自定义属性详情。（DEVRT-2504）

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

通常，在以下情况下，系统会自动跟踪公司内所有开发者的交易总额 开发者使用公司应用访问 API。如果您有开发者 使用他们自己的开发者应用来访问 API，并且您需要跟踪他们的合并交易 而不会造成任何流量中断？您可以将开发者添加到公司，并设置 在达到基于合并交易的限额时要发送的通知 公司及其开发者的总收入有关详情，请参阅将 根据公司及其开发者的合并总交易总额显示通知。 （DEVRT-2643）

查看和重新处理通知 (Cloud 16.06.08 Monetization)

在创收功能测试套件中，你可以查看和重新处理通知 使用 Management API 发送有关详情，请参阅查看和 重新处理通知。（DEVRT-2643）

测试变现（Cloud 16.05.25 变现）

Monetization 提供一组 API，可用于测试 webhook 的执行情况， 确保系统正在发送通知。如需了解详情，请参阅测试通知设置。 （DEVRT-2625）

帮助开发者实现变现 (Cloud 16.05.11 Monetization)

我们推出了一个新的 API，以帮助开发者迁移到创收功能。您可以 转移交易使用情况，并收取自定义设置和周期性费用。此外，当 接受已发布的价格方案，则您可以免除已支付的安装费用。 有关详情，请参阅将开发者迁移到 变现。(DEVRT-2446)

开发者门户的公开和不公开费率方案（Cloud 16.04.27 创收）

您可以将价格方案设置为“公开”或“不公开”公开费率方案会显示在开发者中 portal;不公开价格方案不在此范围内。费率方案默认为“公开”。如需更多信息 请参阅 http://docs.apigee.com/monetization/content/create-rate-plans#public-versus-private-rate-plans。（DEVRT-2445）

取消暂停开发者 (Cloud 16.06.08 变现)

Monetization 提供了一组 API，您可以使用这些 API 取消暂停 之前被中止的如果开发者达到配置的上限，则可能会被暂停。对于 例如，交易次数已达到其上限或预付款账号余额 已耗尽。如需了解详情，请参阅取消暂停开发者。（DEVRT-2641）

查看交易状态 (Cloud 16.06.08 变现)

在创收功能测试套件中，您可以查看 使用 Management API 指定的日期范围内发生的事件。如需更多信息 请参阅查看 交易。(DEVRT-2640)

在收入报告中添加开发者自定义属性 (Cloud 16.05.25 创收功能)

如果自定义 属性。有关详情，请参阅添加开发者自定义 属性。（DEVRT-2447）

Transaction Recording 政策和 API 产品资源一致性（Cloud 16.05.18 界面）

如果创收交易记录政策中的资源路径与资源不一致 其 API 产品中定义的路径（例如，如果您更改了 API 产品资源路径），则 “商品”页面上的“交易记录政策”图标会显示一个警告符号。点击 图标以查看交易记录政策，则页面顶部会显示一条警告。当您 修复 Transaction Recording Policy 中的资源路径，则警告指示符会消失。 （DEVRT-2240）

已修复 Bug

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

适用于私有云的 Edge

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（界面）

已知问题

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