版本管理

1 编辑API

您可以查看API定义并根据需要进行编辑。

操作步骤:

1.登录API网关控制台

2.单击左侧导航栏的API管理>API列表

3.选择需要查看的API点击操作列下image>管理。您可以看到当前所选API的定义信息。按照您的需要进行编辑,单击编辑按钮。

编辑API定义的流程和创建API定义一致,详细信息参见创建 API ,如果您想放弃编辑,可以点击页面顶部的返回图标。

API编辑完成后,需要发布API到测试,预发或者线上,API才能进行调用新的版本。

说明

当您需要编辑某个API的定义时,如果该API已经发布,对定义的修改不会对线上产生影响,定义修改后需要再次发布才能把修改后的定义同步到线上环境。

2 对比差异

API编辑后您可以通过对比差异功能来与之前发布的API进行配置对比,确认修改范围是否正确。

操作步骤:

1. API编辑完成后点击保存按钮,就会跳转至API修改成功的页面,点击发布按钮。

2.在发布API页面,选择要发布的环境,之后可以点击对比差异,与之前发布的API进行配置对比,确认修改范围后再发布。

差异

3 查询历史发布及版本切换

API在环境中的每次发布,API 网关都会进行发布历史记录,发布历史包含了版本号,发布环境,发布时间和您填写的发布说明,您可以在发布历史中查看任何一次的发布记录。

3.1 查询历史发布

  1. 登录API网关控制台,在左侧导航栏点击API管理>API列表,找到已创建的API单击进入。

  2. 在左侧栏单击发布历史,就可以看到API的发布历史版本。单击右侧操作列下的查看,就可以看到该版本API定义详情

3.2 切换至此版本

查看发布历史时,您可以选定某个版本然后操作切换至此版本,该操作会使该版本直接在指定环境中替换之前的版本,实时生效。

  1. 选择需要的版本并单击右侧的切换至此版本

  2. 在弹出API版本切换的确认对话框中,填写备注并单击切换