如何在Azure APIM中为所有API配置全局标头/参数并使其显示？

• 可以在Azure APIM中创建全局标头或参数供所有API使用，但在“所有API”层级配置的参数/标头不会直接显示在单个API的定义页面中，不过会在实际请求处理时生效。
• 若需要让这些全局配置在每个API的定义里也可见，目前APIM没有自动同步显示的功能，可通过以下两种方式处理：
  • 策略注入法：在“所有API”层级添加set-header或set-query-parameter策略，强制为所有API的请求注入标头/参数，无需逐个API配置。示例策略代码：

    <inbound>
        <!-- 全局注入自定义标头 -->
        <set-header name="X-Global-Header" exists-action="override">
            <value>Global-Default-Value</value>
        </set-header>
        <!-- 全局注入查询参数 -->
        <set-query-parameter name="global-param" exists-action="override">
            <value>Global-Param-Value</value>
        </set-query-parameter>
    </inbound>
    

  • 定义同步法：如果需要在API的OpenAPI定义文档中显示这些全局项，需手动更新每个API的定义，或借助PowerShell、Azure CLI编写脚本批量将全局参数/标头添加到各API的规范中。
• 你之前在“所有API”层级配置的参数未在单个API中显示是正常现象，层级配置的策略属于后台生效逻辑，不会同步到单个API的可视化定义界面，但实际调用API时会自动应用这些配置。

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