通过Azure Data Factory API刷新PowerBI时Web Activity报Unauthorized错误

1. 身份验证配置校验 #

• 确认Web活动使用的身份验证方式为*服务主体(Service Principal)*或ADF托管标识，参数填写准确：
  • 若使用服务主体：填写的租户ID(Tenant ID)、客户端ID(Client ID)、客户端密钥(Client Secret)无多余前后空格，且客户端密钥未过期，过期可到Azure AD应用注册页面重新生成。
  • 若使用托管标识：确认对应系统/用户托管标识已被正确关联到ADF资源。
• 确认用于调用API的身份（服务主体/托管标识）已被添加到目标Power BI工作区的成员或管理员角色，只读角色会触发401错误。
• 确认Azure AD中对应身份已被授予Power BI Service的Dataset.ReadWrite.All应用权限，且已完成租户管理员同意操作。

2. API请求配置校验 #

• 确认请求地址格式正确，公有云Power BI刷新接口格式为：https://api.powerbi.com/v1.0/myorg/groups/{工作区ID}/datasets/{数据集ID}/refreshes，工作区ID、数据集ID不要填错，不要添加多余路径后缀。
• 确认请求方法为POST，不要手动在请求头中添加Authorization字段，ADF的Web活动配置合法身份验证后会自动生成该字段，手动添加会导致身份验证冲突。
• 确认请求体为空或仅包含合法的刷新参数JSON，无非法格式内容。

3. 租户级配置校验 #

• 确认Power BI租户管理员已开启「允许服务主体使用Power BI API」开关，该配置位于Power BI管理中心的「租户设置」-「开发者设置」分类下，开关关闭时所有服务主体调用Power BI API都会被拒绝。
• 确认你使用的身份未被加入到该开关的排除名单中。
• 若你使用的是区域特殊版本Power BI（如政府版、世纪互联运营版），需要将API域名替换为对应区域的专属域名，不要直接使用公有云域名。

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