管理修订版本

本页面适用于 Apigee 和 Apigee Hybrid。

API Hub 中的每个 API 都可以有多个版本，并且每个版本都可以有一项规范，该规范可以有多个修订版本。API 页面上的历史记录标签页列出了所有 API 版本中的每个规范修订版本。

“历史记录”标签页，点击放大图片
查看 API 注册表架构

下图说明了 API Hub API、版本、部署和规范之间的关系。

alt_text
参考 资源项 说明
注册表 注册表是用作 API 目录的 API 的集合。
版本 一个 API 可以有多个版本。版本应该对应于客户端可用于调用 API 的稳定接口。您可以指定其中一个版本作为推荐版本。在 semver 用语中，最佳做法是将版本指定为主要版本。
部署 API 可能有多个部署，例如不同的预演环境或区域。 部署是用户可访问 API 的位置（地址）。可以将其中一个部署作为推荐部署。
指定 建议但不要求按照格式规范描述 API 版本，通常使用不同的 API 规范格式。可以将其中一个规范格式作为主要格式，表示此版本的其他规范根据此格式派生而来。
修订版本
  • 部署具有修订历史记录。部署修订版本在适当的时候表示部署的特定实例，如果部署处理的 API 实现发生变化，则可以引用一个或多个规范修订版本。
  • 规范具有修订历史记录。规范修订版本表示规范的后续实例，通常表示对规范内容的非重大更改。在 semver 术语中，修订版本可能对应于次要版本或点版本。

对修订版本表进行排序

点击已更新列标题，对表进行排序。

添加修订版本

如需添加修订版，请执行以下操作：

  1. 在 Google Cloud 控制台中，转到 API Hub 页面。

    转到 API Hub

    默认情况下，系统会显示 API 列表页面。

  2. 在 API 列表中，点击一个 API 行。默认情况下，系统会显示概览标签页。
  3. 选择历史记录标签页。
  4. 点击添加修订版。
  5. 点击浏览，然后选择说明文档或 zip 文件。
  6. 点击打开。
  7. 指定详细信息：
    • 选择 API 版本。
    • 选择 MIME 类型。如果您选择其他，系统会显示一个文本字段，您可以在其中手动指定 MIME 类型。
    • 输入提交消息（可选）。
    • 输入提交哈希值（可选）。
  8. 点击保存（或取消）。

查看修订版本

请参阅查看或下载规范

删除修订版本

要删除修订版本，请执行以下操作：

  1. 在 Cloud 控制台中，转到 API Hub 页面。

    转到 API Hub

    默认情况下，系统会显示 API 列表页面。

  2. 在 API 列表中，点击一个 API 行。默认情况下，系统会显示概览标签页。
  3. 选择历史记录标签页。
  4. 点击所需修订版本旁边的 删除。
  5. 点击提示中的删除（或取消）。