使用多个版本 | Qlik Cloud帮助
跳到主要内容 跳到补充内容

使用多个版本

API Designer 允许您使用同一 API 定义的多个版本,以帮助您管理 API 生命周期。您可以:

  • 在生产环境中维护现有的 API 版本,同时在新版本中引入重大或破坏性更改。
  • 获得对已发布版本的可见性和控制权。
  • 在设计对 API 的更改时获得灵活性。

当您创建 API 的新版本时,所有内容都会复制到新版本中,然后可以独立修改每个版本,而不会影响其他版本。

API Designer 主页显示您拥有的所有 API 以及与您共享的所有 API 版本。
API Designer 主页。

创建新的 API 版本

创建现有 API 定义的新版本。

您是 API 的所有者或至少一个 API 版本的编辑者。
  1. 在主页上,转到要为其创建新版本的 API。
    如果需要,您可以按名称或所有者过滤列表。
  2. 单击要复制的版本旁边的 菜单 按钮,然后单击<版本> 创建新版本
    Movie catalog API 的视图以及为 1.1.0 版本展开的菜单图标。
  3. 输入新版本。
  4. 单击创建
将创建 API 的新版本,其内容与源版本相同。默认情况下,模拟和文档处于禁用状态。

删除 API 版本

您是 API 的所有者。
  1. 在主页上,单击要删除的版本旁边的 菜单 按钮,然后单击删除
  2. 单击删除以确认。
所选版本将被删除。如果要删除整个 API,则需要删除每个版本。

导入版本内容

将现有契约中的内容导入到 API 版本中,替换或合并其当前内容。

您是 API 的所有者或 API 版本的编辑者。

使用此功能可从外部契约文件更新版本,而无需创建新版本。在整个导入过程中,版本标识符将保持不变。

这不同于导入定义,后者会在 API Designer 中创建一个新的 API。

  1. 为要更新的版本打开导入版本内容

    您可以从以下位置访问此操作:

    • 在主页上,单击版本旁边的菜单按钮,然后单击导入版本内容
      菜单按钮中的导入版本内容选项。
    • 在主页上,选择版本以打开详细信息窗格,然后单击导入版本内容
      版本主页中的导入版本内容选项。
    • 在版本编辑器中,单击 编辑 > 导入版本内容
      版本编辑器中的导入版本内容选项。
  2. 选择要导入的契约的格式和来源。
    您可以从本地文件、URL 或直接粘贴到对话框中的文本进行导入。
  3. 行为下,选择如何应用导入的内容。
    • 替换:使用导入的契约覆盖所有当前内容。API 名称、版本标识符和规范版本将保留。
    • 合并:将导入的内容与现有版本内容组合在一起。API 名称和版本标识符将保留。如果导入的元素与现有元素同名,则导入的元素将重命名并带有 _merge 后缀(例如,User_merge)。重复的基本 URL 和媒体类型将被跳过。
    导入版本内容对话框。
  4. 单击导入

版本编辑器将打开并应用更新的内容。

本页面有帮助吗?

如果您发现此页面或其内容有任何问题 – 打字错误、遗漏步骤或技术错误 – 请告诉我们!