PowerBI工作区应用API调用失败：服务主体权限排查

通过PowerBI API从工作区获取应用时，已在UI确认应用存在，但使用服务主体调用API时出现报错。

调用代码 #

# Create the HTTP request
$ListAppsResponse = Invoke-RestMethod -Uri "https://api.powerbi.com/v1.0/myorg/apps" -Headers $headers -Method Get

# Filter the apps by workspaceId
$appsInWorkspace = $ListAppsResponse.value | Where-Object { $_.workspaceId -eq $workspaceId }

$updateAppInTargetWorkspace = Get-AppsList -workspaceId $workspaceId -accessToken $accessToken

报错信息 #

"Invoke-RestMethod : {"Message":"API is not accessible for application"}"

已确认信息 #

• 服务主体已授予App.Read.All应用权限（权限配置截图如下）
  
• 该服务主体可正常执行数据集部署、报表发布、参数及连接更新等操作，具备PowerBI访问权限

核心原因 #

PowerBI的GET /v1.0/myorg/appsAPI不支持服务主体调用，这个接口仅对普通用户账号（用户上下文）开放，服务主体无法通过此接口获取应用列表。

解决办法 #

1. 更换为支持服务主体的API端点 #

如果需要获取指定工作区关联的应用，改用工作区专属的API接口：

$workspaceAppsResponse = Invoke-RestMethod -Uri "https://api.powerbi.com/v1.0/myorg/groups/$workspaceId/apps" -Headers $headers -Method Get

这个接口支持服务主体调用，前提是服务主体对目标工作区拥有成员或管理员权限，且已正确配置App.Read.All应用权限。

2. 验证权限与工作区配置 #

• 确认App.Read.All是应用权限（而非委派权限），且已完成管理员同意（从截图看配置正确，可再次确认权限状态）。
• 确保服务主体已被添加到目标工作区，角色至少为成员（访客权限无法读取应用信息）。

3. 废弃原API调用逻辑 #

停止使用/myorg/apps端点，改用/groups/{workspaceId}/apps端点，该端点专门用于获取指定工作区下的应用，完全适配服务主体场景。

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