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 中的“Content”>“SmartDocs”菜单使用。
  • 以前称为“自定义令牌”的身份验证方式现已更名为“API 密钥”。
  • 在修订级别定义的身份验证“安全”对象。
  • 在模板级别配置客户端身份验证。新修订版不再重置任何预配置的 SmartDocs 客户端凭据。

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

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

新的 API 代理编辑器 Beta 版

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

新的 OAuthV2 政策

借助新的 DeleteOAuthV2Info 政策,您可以删除授权代码和访问令牌。如需了解详情,请参阅 DeleteOAuthV2Info 政策

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

“访问实体”政策可提供对以下新实体的访问权限:consumerkey-scopes、authorizationcode、requesttoken 和 verifier。如需了解详情,请参阅 Access Entity 政策

显示即将过期的 SSL 证书

管理界面中的“SSL 证书”页面(“管理”>“SSL 证书”)会指明 SSL 证书在 10、15、30 或 90 天内即将过期,具体取决于您在新建的“到期时间”下拉字段中所做的选择。

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

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

经典版自定义报告将从管理界面中移除

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


SmartDocs 升级流程

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

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

请注意,虽然您可以在开发者门户中呈现和发布 SmartDocs,但 SmartDocs 是根据 Apigee Edge API 管理服务中 API 模型生成的。您在 Edge 中对 API 模型所做的任何更改都会在您的所有 Pantheon 环境中生效(类似于开发者在 Pantheon 环境中的存在方式)。

如何从 SmartDocs Beta 版升级到正式版

  1. 在 Pantheon 上的开发测试环境中更新并测试 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 在界面中保存权限后,客户角色的权限会重置
MGMT-2048 具有自定义角色的用户(该角色会将部署权限限制为一个环境)可以在其他环境中部署
MGMT-2041 从默认附件模板中移除了 FaultRules 元素
在您创建 API 代理或添加政策时,系统不再自动添加 FaultRules 元素(该元素不会在政策或 API 代理步骤中使用)。
MGMT-2034 提取 WSDL 返回失败:“提取 WSDL 错误:处理 WSDL 时出错。”
MGMT-1812 在导入期间添加了 TargetEndpoint 验证
与 ProxyEndpoint 类似,在 API 代理导入期间,系统会对 TargetEndpoint 进行验证,确保其在条件中使用的架构和表达式正确无误。
MGMT-1345 导入包含多个命名空间的 WSDL 会导致 Build SOAP 步骤不正确
MGMT-800 创建名称为“default”的资源会导致界面损坏
MGMT-602 API 代理“开发”视图:在端点没有 PreFlow/PostFlow 时添加响应缓存政策会导致错误
MGMT-460 重命名政策会导致出现故障行为,重复的政策无法移除
DEVRT-1565 CHARGES 的间隔时间为 15 分钟
AXAPP-1728 在 Google Analytics 中忽略创收变量
AXAPP-1690 自定义报告出现“Invalid API Error”(无效 API 错误)
AXAPP-1533 Google Analytics 地图抛出“API 调用无效”错误
APIRT-52 自定义报告:许多 API 的响应状态代码为 null