PowerBI报表可访问用户列表的获取与自动更新

前言

报表的访问权限管理不仅仅只是添加或删除用户对报表的访问权限，还需要维护可访问用户的名单，以便在报表被意外删除或需要进行迁移时，能够快速且完整的恢复用户的访问权限。

虽然采用手工维护的方式也可以达到同样效果，但工作区中报表数量较多的话，维护起来肯定是非常不方便的，因此本篇文章将介绍使用PowerBI REST API的方案来自动化获取与更新工作区中各报表的可访问用户名单。

方案介绍

总体方案如下：

1、调用REST API获取指定工作区中的所有报表

2、调用REST API获取每个报表的可访问用户列表并汇总

3、使用PowerQuery完成上述操作

4、新建PowerBI数据流，运行PowerQuery的相应代码，并设置计划刷新，定时刷新数据流

5、若需要备份历史数据，则可以将数据流替换为数据集，并使用PowerAutomate从数据集中查询数据并进行备份

相信任意一个具有发送http请求的编程语言都可以完成上述操作，但困难的地方则是要保证脚本的持续运行。由于服务器环境不易获取，因此在该方案中采用PowerBI数据流或数据集来代替服务器环境，既保证了脚本的持续运行，也大大提高了方案的易用性，同时数据流或数据集都可以与报表放在同一个工作区中，也比较方便管理。

REST API接口介绍

获取指定工作区中的所有报表

API接口：

Url：https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets

Method：GET
Request Headers: {Authorization:访问令牌} 

Sample Response: 
{
  "value": [
    {
      "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",  // 报表对应的数据集ID
      "name": "SalesMarketing",
      "addRowsAPIEnabled": false,
      "configuredBy": "john@contoso.com",
      "isRefreshable": true,
      "isEffectiveIdentityRequired": false,
      "isEffectiveIdentityRolesRequired": false,
      "isOnPremGatewayRequired": false
    },
    {
      "id": "azwfbeb1-8037-4d0c-896e-a46fb27aw229",
      "name": "ProductOps",
      "addRowsAPIEnabled": false,
      "configuredBy": "john@contoso.com",
      "isRefreshable": true,
      "isEffectiveIdentityRequired": false,
      "isEffectiveIdentityRolesRequired": false,
      "isOnPremGatewayRequired": false
    },
    ...
  ]
}

参数说明：

groupId指的是工作区ID，打开工作区后，可以在浏览器上方地址栏处获得，具体如下图所示：

获取指定指定报表的可访问用户列表

API接口：

Url：https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/users

Method：GET
Request Headers: {Authorization:访问令牌} 

Sample Response: 
{
  "value": [
    {
      "identifier": "john@contoso.com",
      "principalType": "User",
      "datasetUserAccessRight": "Read"
    },
    {
      "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
      "principalType": "Group",
      "datasetUserAccessRight": "ReadReshare"
    },
    {
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App",
      "datasetUserAccessRight": "ReadWriteReshareExplore"
    }
  ]
}