15.05.27 - Apigee Edge 云版本说明

您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档
信息

2015 年 6 月 2 日(星期二),我们发布了 Apigee Edge 的全新云版本。

如果您有任何疑问,请转到 Apigee 客户支持

如需查看所有 Apigee Edge 版本说明的列表,请参阅 Apigee 版本说明

新功能和增强功能

以下是此版本中的新功能和增强功能。

SmartDocs 正式版

SmartDocs 正从 Beta 版升级到正式版。更新和新功能包括:

  • 支持 Swagger 2.0,包括按文件或网址导入,包括支持自定义命名的安全对象。
  • 改进了生成 SmartDocs 的模板的视觉设计。
  • 开发者门户中的易用性和工作流增强了,可通过 Drupal 中的“内容”>“SmartDocs”菜单获取。
  • 之前称为“自定义令牌”身份验证的功能现在称为“API 密钥”。
  • 在修订版本级别定义的身份验证“安全”对象。
  • 在模板级别配置客户端身份验证。新修订版本不再重置任何预配置的 SmartDocs 客户端凭据。

如需了解更多功能说明,请参阅这篇 博文

如需查看 SmartDocs 文档,请参阅使用 SmartDocs 记录 API

新的 API 代理编辑器 Beta 版

API 代理编辑器推出了新的 Beta 版。如需访问,请在修改现有 API 代理时点击“访问 Beta 版”链接。您可以在“传统版”和“Beta 版”编辑器之间来回切换。

新增 OAuthV2 政策

新的 DeleteOAuthV2Info 政策可让您删除授权代码和访问令牌。如需了解详情,请参阅“删除 OAuthV2 信息”政策

“访问实体”政策中的新实体

通过 Access Entity 政策,您可以访问以下新实体:consumerkey-scopes、authorizationcode、requesttoken 和 verifier。如需了解详情,请参阅访问实体政策

显示即将过期的 SSL 证书

管理界面中的“SSL 证书”页面(“管理”>“SSL 证书”)会显示 SSL 证书的到期时间,如 10、15、30 或 90 天内,具体取决于您在新的到期日期下拉菜单中的选择。

显示在管理界面的开发者应用名称

Edge 中的开发者应用既有不会更改的内部名称,也有您可以更改的显示名称。在管理界面的“开发者应用”页面上(“发布”>“开发者应用”>“应用名称”),应用的内部“名称”会与“显示名”一起显示,以便您更轻松地按内部名称直观地识别应用,以便进行问题排查和 API 管理。

传统版自定义报告即将从管理界面中移除

管理界面中不再提供可选的经典版自定义分析报告。


SmartDocs 升级过程

如果您在 Beta 版期间已在使用 SmartDocs,则正式版中的新功能需要您升级开发者门户中的 SmartDocs。

已在开发者门户中发布的所有 SmartDocs 页面都将继续正常运行,但您必须按照更新流程操作,才能修改现有页面或新页面或发布任何更改。

请注意,虽然您可以在开发者门户内渲染和发布 SmartDoc,但 SmartDocs 是由 Apigee Edge API 管理服务中的 API 模型生成的。您在 Edge 中对 API 模型所做的任何更改在您的所有 Pantheon 环境中都相同(类似于开发者跨 Pantheon 环境中的存在方式)。

从 SmartDocs Beta 版升级到正式版

  1. 在 Pantheon 的devdev环境中更新并测试 15.05.27 版本。
  2. 创建新模型以替换您我们一直在使用的任何现有 API 模型。
    • 如果您一直在导入 Swagger 或 WADL 文档,请再次将其导入新的修订版本。
    • 如果您一直在通过 SmartDocs 模块维护 API 模型,请将模型导出为 SmartDocs JSON,并使用文件附件导入新模型。
  3. 设置模型修订版本的安全属性。在内容 > SmartDocs > 模型页面上,选择安全设置
  4. 点击“操作”列中的设置,在模型设置页面(内容 > SmartDocs)中检查所有预配置的身份验证。
  5. 将所有自定义模板更新为使用 v6 的 CSS 和 JS 资源,并进行更改以反映所有新的对象名称,例如 authSchemes 和 apiSchema。如需了解如何更新 SmartDocs 模板,请参阅使用 SmartDocs 记录 API
  6. 重新渲染并发布模型修订版本。
  7. 验证新文档后,将生产门户更新到 15.05.27 版本。

如果您是 Edge 企业客户,对升级流程有任何问题或疑虑,请发送电子邮件至 marsh@apigee.com 和 cnovak@apigee.com。否则,请使用 Apigee 社区获取最佳回复。

已修复 Bug

此版本修复了以下 bug。

问题 ID 说明
TBD-72 消息日志记录政策问题
MGMT-2124 在界面中保存权限时,会重置 Customer 角色的权限
MGMT-2048 如果用户拥有的自定义角色限定了一个环境的部署权限,则可以在其他环境中进行部署
MGMT-2041 从默认连接模板中移除 FaultRules 元素
当您创建 API 代理或添加政策时,系统不会自动添加政策或 API 代理步骤中使用的 FaultRules 元素。
MGMT-2034 提取 WSDL 返回失败:“提取 WSDL 错误:处理 WSDL 时出错。”
MGMT-1812 在导入期间添加 TargetEndpoint 验证
与 ProxyEndpoint 类似,系统会在 API 代理导入期间针对条件中使用的正确架构和表达式验证 TargetEndpoint。
MGMT-1345 导入具有多个命名空间的 WSDL 会导致构建 SOAP 步骤不正确
MGMT-800 创建名为“default”的资源会导致界面损坏
MGMT-602 API 代理开发视图:添加当端点没有 PreFlow/PostFlow 导致错误时的响应缓存政策
MGMT-460 重命名政策会导致出现故障行为,存在无法移除的重复政策
DEVRT-1565 CHARGES 间隔为 15 分钟
AXAPP-1728 忽略数据分析中的创收变量
AXAPP-1690 自定义报告上显示“API 无效错误”
AXAPP-1533 Google Analytics(分析)地理分布图抛出“无效 API 调用”错误
APIRT-52 自定义报告:许多 API 的响应状态代码为 null