Azure API Management策略导入报错：YAML发布管道迁移求助

DevOps 小满

2026-6-25

解决Azure API Management策略导入的az rest调用问题

核心问题分析

你遇到的两个错误本质都是请求体的格式/转义处理错误：

< was unexpected at this time：PowerShell/CMD将XML中的<>解析成了重定向符号，导致命令行参数解析失败
根元素缺失：空XML不符合APIM策略的验证规则，必须提供合法的XML结构

正确解决方案

不要手动拼接JSON和转义特殊字符，用PowerShell的原生JSON序列化工具处理，避免手动转义错误：

步骤1：定义策略XML并构建请求对象

# 直接定义格式化后的策略XML（用Here-String避免转义麻烦）
$policyXml = @"
<policies>
  <inbound/>
  <backend>
    <forward-request/>
  </backend>
  <outbound/>
</policies>
"@

# 构建符合API要求的请求体对象
$requestBody = @{
    properties = @{
        format = "xml"
        value  = $policyXml
    }
}

步骤2：自动序列化为合法JSON

用ConvertTo-Json自动处理所有转义（包括XML中的特殊字符、双引号），避免手动替换出错：

# -Depth确保嵌套结构被正确序列化
$jsonBody = $requestBody | ConvertTo-Json -Depth 10

步骤3：调用az rest（两种可靠方式）

方式1：用双引号包裹JSON变量

az rest --method PUT --uri $uri --body "$jsonBody"

方式2：通过管道传递请求体（避免命令行参数解析冲突）

$jsonBody | az rest --method PUT --uri $uri --body @-

额外注意事项

URI格式验证：确保包含apis参数的URI正确，格式应为：

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/policies/policy