如何通过Rest API或CLI取消Azure APIM的API版本强制设置？

通过REST API即时修改 #

你可以使用Azure API Management服务的更新REST API同时调整两个关键参数：

1. 将minApiVersion设为null，取消现有最低API版本的绑定
2. 将enforceMinApiVersion设为false，关闭“强制最低API版本”限制

请求示例（PATCH方法） #

使用PATCH请求仅更新需要修改的属性，比全量PUT请求更高效：

• 请求URL：

  https://management.azure.com/subscriptions/{你的订阅ID}/resourceGroups/{资源组名称}/providers/Microsoft.ApiManagement/service/{APIM服务名称}?api-version=2022-08-01
  

• 请求体（JSON格式）：

  {
    "properties": {
      "minApiVersion": null,
      "enforceMinApiVersion": false
    }
  }
  

• 注意：请求需携带有效的Azure AD身份验证令牌，且你需拥有该APIM服务的修改权限。

未来可用Azure CLI时的修改命令 #

当你可以使用Azure CLI后，执行以下命令即可完成设置修改：

az apim update \
  --resource-group <你的资源组名称> \
  --name <你的APIM服务名称> \
  --set properties.enforceMinApiVersion=false properties.minApiVersion=""

该操作会即时生效，可临时解决当前设置灰色不可编辑的问题，后续你再按要求完成最低API版本到2019-12-01的整改。

内容的提问来源于stack exchange，提问作者0Neji