Power BI REST API 导出分页报表时，若需为同一参数（如 City）传入多个值，不能使用数组或逗号分隔字符串，而应通过重复添加同名参数对象实现——即在 parameterValues 数组中多次声明相同 name、不同 value 的条目。
power bi rest api 导出分页报表时，若需为同一参数（如 city）传入多个值，**不能使用数组或逗号分隔字符串**，而应通过重复添加同名参数对象实现——即在 `parametervalues` 数组中多次声明相同 `name`、不同 `value` 的条目。
在调用 Power BI 的 ExportPaginatedReport REST API 时，多值参数（Multi-value Parameter）的结构有严格要求：每个值必须作为独立的 JSON 对象显式写入 parameterValues 数组，且允许 name 字段重复。这是与 Power BI 报表服务中“多值筛选器”语义一致的设计——系统会为每个匹配值分别生成报表页（例如，为 City = "Seattle"、"Bellevue"、"Redmond" 各渲染一页 PDF）。
✅ 正确示例（支持多值参数 City）：
{
"format": "PDF",
"paginatedReportConfiguration": {
"parameterValues": [
{"name": "State", "value": "WA"},
{"name": "City", "value": "Seattle"},
{"name": "City", "value": "Bellevue"},
{"name": "City", "value": "Redmond"}
]
}
}
❌ 常见错误方式（均会触发 400 错误）：
-
"value": ["Seattle", "Bellevue"]→ REST API 不接受数组类型值 -
"value": "Seattle,Bellevue"→ 被解析为单个字符串，非多值语义 -
"value": "\"Seattle\",\"Bellevue\""→ 引号转义无效，仍为字符串
⚠️ 注意事项：
- 参数名（
name）区分大小写，需与报表中定义的参数名称完全一致； - 所有参数值（包括单值参数）都必须是字符串类型（即使原始参数为数值或日期），例如日期
"2013-05-20"或"05/20/2013"（需确保报表端能正确解析）； - 若参数设为“允许空值”或“允许多值”，该结构依然适用；但若报表未启用多值支持，则仅首个同名参数生效；
- 导出请求成功后，响应中
statusUrl返回的异步任务将按各值逐一执行分页渲染，最终 PDF 包含对应数量的页面（如上例为 3 页）。
总结：Power BI REST API 的多值参数本质是「逻辑重复参数」而非「复合值字段」。只要确保 parameterValues 数组中存在多个同 name、不同 value 的对象，即可正确触发分页报表的多实例导出逻辑。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
