如何通过API管理PowerBI报表权限？求授予直接访问的API端点

要通过API给Power BI报表授予直接访问权限，核心使用的是Add Report User端点，以下是具体实现细节：

• API端点：
  POST请求，格式为：
  https://api.powerbi.com/v1.0/myorg/groups/{groupId}/reports/{reportId}/users
  （替换{groupId}为报表所在工作区ID，{reportId}为目标报表ID）

• 请求体示例：
  需要指定用户/组的身份信息、权限级别和主体类型，JSON格式如下：

  {
    "userPrincipalName": "user@domain.com",
    "accessRight": "Read",
    "principalType": "User"
  }
  

• 关键参数说明：

  • userPrincipalName：用户的邮箱地址（如果是组权限，填写组的邮箱或Azure AD对象ID）
  • accessRight：可选权限值包括：
    Read：仅查看报表权限
    ReadWrite：查看并编辑报表权限
    Admin：完全管理报表权限（包括修改权限本身）
  • principalType：指定主体类型，可选User（单个用户）或Group（安全组）

• 认证要求：
  请求必须携带Azure AD颁发的Bearer Token，所需权限范围为Report.ReadWrite.All（授予/修改权限）或Report.Read.All（仅查看权限场景）

• 注意事项：

  • 目标用户/组必须存在于你的Azure AD租户中
  • 调用API的账号需要具备工作区管理员权限，或拥有报表的Admin级别权限
  • 暂不支持单次批量授予权限，需循环调用该端点完成批量操作

内容的提问来源于stack exchange，提问作者Roman R.