Azure APIM策略配置：为RequestParam追加硬编码默认值

核心策略实现 #

你需要在APIM的入站策略中使用set-query-parameter实现参数追加，以下是适配你场景的完整配置：

<inbound>
    <base />
    <!-- 为fruits查询参数追加硬编码值banana -->
    <set-query-parameter name="fruits" exists-action="append">
        <value>@{
            // 获取原始请求中的fruits参数值，为空则返回空字符串
            var originalFruits = context.Request.Url.Query.GetValueOrDefault("fruits", "");
            // 拼接原始值与新增值，原始为空则直接返回banana
            return string.IsNullOrEmpty(originalFruits) ? "banana" : $"{originalFruits},banana";
        }</value>
    </set-query-parameter>
</inbound>

关键配置说明 #

• exists-action="append"：指定当fruits参数已存在时，将新值追加到原有值后；若参数不存在，则直接创建该参数并设置为banana
• C#表达式逻辑：通过context.Request.Url.Query.GetValueOrDefault获取原始参数值，处理空值场景后完成字符串拼接，确保格式符合需求

配置步骤 #

1. 登录Azure门户，进入你的APIM实例
2. 找到需要修改的目标API和对应的操作
3. 切换到「设计」标签页，在「入站处理」区域点击「添加策略」
4. 选择「设置查询参数」策略，切换到XML视图，替换为上述代码即可

测试与后续操作 #

• 配置完成后，可通过APIM内置的「测试」功能发起请求，验证fruits参数是否已追加banana
• 待UI端完成更新部署后，直接删除该策略即可恢复原有逻辑

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