Azure Synapse Web Activity调用Power BI刷新API遇404错误

从你的配置来看，404错误通常是端点路径不正确或参数值无效导致的，按以下步骤排查：

1. 检查参数的有效性 #

• 确认groups参数值是Power BI工作区的ID，不是工作区名称。工作区ID可在Power BI工作区的「设置」→「工作区设置」中获取
• 确认DatasetGUID是语义模型（数据集）的正确GUID，可在数据集的「设置」→「数据集设置」中查看「数据集ID」

2. 验证API端点格式 #

• 如果你的语义模型在共享容量（非Premium/PPU），不需要groups/@{pipeline().parameters.groups}路径，正确的URL应为：

  https://api.powerbi.com/v1.0/myorg/datasets/@{pipeline().parameters.DatasetGUID}/refreshes
  

• 如果是Premium/PPU工作区，保留groups路径，但必须确保工作区ID正确

3. 确认服务主体的权限配置 #

• 服务主体必须被添加到目标Power BI工作区，且权限级别至少为「成员」（建议使用「管理员」权限排除权限问题）
• 在Azure AD应用注册中，确认已为服务主体添加Dataset.ReadWrite.All或Dataset.Refresh.All的API权限，且已完成管理员授权

4. 手动测试端点 #

将URL中的参数替换为实际值，用Postman等工具测试API：

• 请求方法：POST
• 请求体：

  {"type":"full","commitMode":"transactional","applyRefreshPolicy":"true"}
  

• 认证方式：使用服务主体获取的Bearer Token（通过https://login.microsoftonline.com/TENANT/oauth2/token端点获取，资源为https://analysis.windows.net/powerbi/api）
  如果手动测试仍返回404，说明路径或参数确实存在问题；如果手动测试成功，再排查Synapse中参数替换是否出错

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