如何在APIOPS的policies.xml中添加并正确使用命名值变量？

你遇到的问题是因为APIOps对不同文件的变量处理机制不同：Specifications.json默认支持部署阶段的{{变量名}}替换，而policies.xml需要区分APIM运行时引用和APIOps部署阶段替换两种场景，以下是具体解决方案：

方法一：使用APIM运行时命名值引用（推荐） #

这是APIM原生支持的方式，无需依赖APIOps的文本替换，运行时直接读取APIM中的命名值：

1. 确保configuration.<env>.yaml中已正确定义命名值（需放在namedValues节点下）：

apimServiceName: your-apim-service
azureTenantNameId: your-tenant-id
azureEnvironmentId: your-env-id
namedValues:
  - name: azureTenantNameId
    value: "{{azureTenantNameId}}" # 可引用顶层变量或直接写固定值
    secret: false
  - name: azureEnvironmentId
    value: "{{azureEnvironmentId}}"
    secret: false

2. 在policies.xml中使用APIM原生的命名值引用格式：

<policies>
  <inbound>
    <set-header name="X-Tenant-Id" exists-action="override">
      <value>{{@azureTenantNameId}}</value>
    </set-header>
    <set-header name="X-Env-Id" exists-action="override">
      <value>{{@azureEnvironmentId}}</value>
    </set-header>
  </inbound>
</policies>

3. 运行APIOps部署命令，命名值会被同步到APIM，策略运行时自动解析{{@变量名}}格式的引用。

方法二：配置APIOps对policies.xml做部署阶段替换 #

如果需要在部署前将变量值静态替换到policies.xml中，需显式指定APIOps处理该文件：

1. 保持configuration.<env>.yaml中的顶层变量定义不变：

apimServiceName: your-apim-service
azureTenantNameId: your-tenant-id
azureEnvironmentId: your-env-id

2. 在policies.xml中继续使用{{变量名}}格式：

<policies>
  <inbound>
    <set-header name="X-Tenant-Id" exists-action="override">
      <value>{{azureTenantNameId}}</value>
    </set-header>
  </inbound>
</policies>

3. 运行APIOps的replace命令时，显式指定要处理的文件：

apiops replace --config configuration.<env>.yaml --files policies.xml

或者在部署配置中添加文件路径，确保APIOps在部署流程中对policies.xml执行变量替换。

关键注意事项 #

• 避免混淆两种格式：APIOps部署替换用{{变量名}}，APIM运行时引用用{{@变量名}}
• 确认APIOps版本为最新稳定版，旧版本可能对文件替换的支持有限
• 使用方法一时，需确保命名值已通过APIOps成功同步到APIM实例，否则运行时会出现"命名值不存在"的错误

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