资讯

历史

科技

环境与自然

成长

游戏

财经

文学与艺术

美食

健康

家居

文化

情感

汽车

三农

军事

旅行

运动

教育

生活

星座命理

教程：使用修订安全地进行非中断性 API 更改

创作时间:

作者:

@小白创作中心

教程：使用修订安全地进行非中断性 API 更改

引用

来源

https://learn.microsoft.com/zh-cn/azure/api-management/api-management-get-started-revise-api?source=recommendations&tabs=azure-portal

本文将介绍如何在Azure API Management中使用修订功能安全地进行API更改。通过添加新修订版、对修订版进行非重大更改、将修订版设为当前版本并添加更改日志项目等步骤，帮助开发者在不中断API服务的情况下完成API的更新和维护。

适用于：所有 API 管理层级

当 API 准备就绪并可供开发人员使用时，你最终需要对该 API 进行更改，同时避免干扰 API 的调用方。另一种有效的做法是让开发人员知道所做的更改。

在 Azure API Management 中，使用修订进行非中断性 API 变更，以便可以安全地对变更进行建模和测试。准备就绪后，可以将修订设为当前版本并替换当前的 API。

有关背景知识，请参阅版本和修订。

提示

API 团队可以在工作区中使用此功能。工作区提供对 API 及其自己的 API 运行时环境的隔离管理访问权限。

本教程介绍如何执行下列操作：

添加新的修订版
对修订版进行非重大更改
将修订版设为当前版本并添加更改日志项目
浏览开发人员门户以查看更改与更改日志
访问 API 修订

先决条件

添加新的修订版

登录到Azure 门户，并转到你的 API 管理实例。
在左侧菜单中的 API下，选择 API。
从 API 列表中选择“Swagger Petstore”（或想要添加修订的其他 API）。
选择“修订”选项卡。
选择“+ 添加修订”。

提示

也可以在 API 上的上下文菜单 (…) 中选择“添加修订” 。

提供新修订版的说明，帮助记住其用途。
选择创建。

现已创建新的修订版。

注意

原始 API 保留在“修订版 1”中。这是在将其他修订版设为当前版本之前，用户继续调用的修订版。

对修订版进行非重大更改

从 API 列表中选择“Swagger Petstore”。
选择靠近屏幕顶部的“设计”选项卡。
请注意，修订版选择器（位于“设计”选项卡正上方）显示“修订版 2”为当前所选项。

提示

使用修订版选择器可在要使用的修订版之间切换。

选择“+ 添加操作”。
将新操作设置为“POST”，将操作的“显示名称”、“名称”和 URL 设置为“test”。
保存新操作。

现在，已对“修订版 2”进行了更改。使用靠近页面顶部的“修订版选择器”切换回到“修订版 1” 。

请注意，新操作不会出现在“修订版 1”中。

将修订版设为当前版本并添加更改日志项目

Portal
Azure CLI

在靠近页面顶部的菜单中选择“修订”选项卡。
打开“修订版 2”对应的上下文菜单 (...)。
选择“设为当前版本”。
如果想要发布有关此变更的说明，请选中“发布有关此 API 的公共变更日志”复选框。提供可让开发人员看到的更改说明，例如：“测试修订。添加了新的‘测试’操作”。

修订版 2现在是当前版本。

开始使用 Azure CLI：

在Azure Cloud Shell中使用 Bash 环境。有关详细信息，请参阅Azure Cloud Shell 中的 Bash 快速入门。
如需在本地运行 CLI 参考命令，请安装Azure CLI。如果在 Windows 或 macOS 上运行，请考虑在 Docker 容器中运行 Azure CLI。有关详细信息，请参阅如何在 Docker 容器中运行 Azure CLI。
如果使用的是本地安装，请使用az login命令登录 Azure CLI。若要完成身份验证过程，请遵循终端中显示的步骤。有关其他登录选项，请参阅使用 Azure CLI 登录。
出现提示时，请在首次使用时安装 Azure CLI 扩展。有关扩展详细信息，请参阅使用 Azure CLI 的扩展。
运行az version以查找安装的版本和依赖库。若要升级到最新版本，请运行az upgrade。

使用此过程创建和更新版本。

运行az api list命令以查看 API ID：


az apim api list --resource-group apim-hello-word-resource-group \
    --service-name apim-hello-world --output table

要在下一个命令中使用的 API ID 是
Name
值。 API 版本位于
ApiRevision
列中。

若要创建版本和发行说明，请运行az apim api release create命令：


az apim api release create --resource-group apim-hello-word-resource-group \
    --api-id swagger-petstore --api-revision 2 --service-name apim-hello-world \
    --notes 'Testing revisions. Added new "test" operation.'

你发布的修订版即为当前修订版。

若要查看版本，请使用az apim api release list命令：


az apim api release list --resource-group apim-hello-word-resource-group \
    --api-id swagger-petstore --service-name apim-hello-world --output table

指定的注释显示在更改日志中。可以在前一个命令的输出中看到这些注释。

创建版本时，可选用
--notes
参数。稍后可以通过使用az apim api release update命令添加或更改注释：


az apim api release update --resource-group apim-hello-word-resource-group \
    --api-id swagger-petstore --release-id 00000000000000000000000000000000 \
    --service-name apim-hello-world --notes "Revised notes."

使用
Name
列中的值作为版本 ID。

可以通过运行az apim api release delete命令删除任何版本：


az apim api release delete --resource-group apim-hello-word-resource-group \
    --api-id swagger-petstore --release-id 00000000000000000000000000000000 
    --service-name apim-hello-world