如何获取Azure APIM操作策略详情并筛选含特定策略的操作？

问题原因 #

AZ CLI的az apim api operation show和az apim api operation list命令默认不会返回操作的策略内容——因为策略属于嵌套扩展资源，必须显式指定展开参数才能获取。

具体解决方案 #

1. 单个操作查询策略 #

在show命令后添加--expand policies参数，即可获取该操作的完整策略内容：

az apim api operation show --resource-group $myResourceGroup --api-id $apiId --service-name $serviceName --operation-id $operationId --expand policies

执行后，policies字段会返回包含策略XML内容的完整结构，不再是null。

2. 批量筛选含特定策略的操作 #

如果要批量找出所有配置了入站IP筛选的操作，可以通过脚本循环查询：

• 第一步，获取目标API下的所有操作ID：

operation_ids=$(az apim api operation list --resource-group $myResourceGroup --api-id $apiId --service-name $serviceName --query "[].id" -o tsv)

• 第二步，循环每个操作ID，查询策略并检查是否包含IP筛选节点：

for op_id in $operation_ids
do
    # 提取操作ID的最后一段（list返回的是完整资源ID）
    op_name=$(basename $op_id)
    # 查询该操作的策略内容
    policy_content=$(az apim api operation show --resource-group $myResourceGroup --api-id $apiId --service-name $serviceName --operation-id $op_name --expand policies --query "policies.content" -o tsv)
    # 检查策略中是否包含IP筛选标签
    if echo "$policy_content" | grep -q "<ip-filter"; then
        echo "操作 $op_name 配置了IP筛选策略"
    fi
done

补充说明 #

如果你的APIM服务使用策略继承（比如API级别或全局级别配置了IP筛选，操作未单独配置），上述方法只会筛选出操作自身配置了IP筛选的条目。如果需要包含继承的策略，需要额外结合API级别和全局级别的策略查询来综合判断。

内容的提问来源于stack exchange，提问作者Aleksandar Hristov