如何通过CLI为Azure APIM API实例设置专属API标签

你提到的这类API专属标签属于APIM服务内部的实体标签，并非Azure资源层面的通用标签，因此资源标签相关的Get-AzTag/az tag系列命令无法读取或修改这类标签，需要使用APIM专属的CLI命令完成操作。

具体操作命令 #

1. 预创建APIM标签（若标签已在APIM实例中存在可跳过） #

az apim tag create --resource-group <资源组名称> --service-name <APIM服务名称> --tag-id <标签唯一ID> --display-name <标签展示名称>

2. 给单个API绑定指定标签 #

az apim api tag assign --resource-group <资源组名称> --service-name <APIM服务名称> --api-id <目标API的ID> --tag-id <要绑定的标签ID>

3. 批量绑定标签 #

你可以将300+需要配置标签的API ID、对应要绑定的标签ID整理为CSV表格，通过简单的Shell或PowerShell脚本循环读取表格内容，批量执行上述绑定命令即可，无需逐一手操在门户配置。

4. 验证绑定结果 #

执行以下命令可查询指定API已绑定的所有专属标签，返回结果与Azure门户展示内容完全一致：

az apim api tag list --resource-group <资源组名称> --service-name <APIM服务名称> --api-id <目标API的ID>

可选：解绑API标签 #

如果需要移除API上的指定标签，可执行：

az apim api tag delete --resource-group <资源组名称> --service-name <APIM服务名称> --api-id <目标API的ID> --tag-id <要解绑的标签ID>

你提到的门户标签展示位置参考：

内容的提问来源于stack exchange，提问作者Willy Van den Driessche