如何通过Power BI API使用Service Principal绑定云连接数据源？

问题背景 #

我使用Power BI API绑定网关和数据源到数据模型，但该模型包含一个无需网关的云数据源：

• 数据模型的「网关和云连接」配置如图：
  
• 已通过API为服务主体绑定网关（服务主体已获取数据模型所有权），调用的API为：
  https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/Default.BindToGateway
• 为获取云数据源的datasourceID和gatewayID，我在辅助数据模型中手动配置该云数据源，再通过以下API获取信息：
  https://api.powerbi.com/v1.0/myorg/groups/{workspaceId}/datasets/{datasetId}/datasources
• 从API响应中拿到的云数据源信息如图：
  
• 当前遇到的核心问题：
  • 未设置「Personal Cloud Connect」时数据刷新失败，且服务主体无法手动设置该选项
  • 管理员手动接管模型后，系统自动配置个人云连接才能正常刷新
  • 尝试用绑定网关的逻辑绑定云数据源时，调用API：
    https://api.powerbi.com/v1.0/$tenantId/groups/$workspaceId/datasets/$datamodelId/Default.BindToGateway
    请求体为：

    {'gatewayObjectId': '88c5bf1b-aaaaaaaaaaaaaaaaaaaaaaaaaaa', 'datasourceObjectsIds': '3395bac9-aaaaaaaaaaaaaaaaaaaaaaaaaaa'}
    

    出现两种错误：
    1. Bruno中返回400错误：

       Error 400:
       {
       "error": {
       "code": "BadRequest",
       "message": "Bad Request",
       "details": [
       {
       "message": "Invalid value",
       "target": "bindToGatewayRequest.datasourceObjectIds"
       }
       ]
       }
       }

    2. PowerShell中返回：

       Invoke-RestMethod:
       {
       "error": {
       "code": "DMTS_CanNotFindMatchingDatasourceInGatewayError",
       "pbi.error": {
       "code": "DMTS_CanNotFindMatchingDatasourceInGatewayError",
       "parameters": {},
       "details": [],
       "exceptionCulprit": 1
       }
       }
       }

解决步骤 #

1. 修正请求体格式错误 #

datasourceObjectsIds参数要求是数组类型，你传入的单个字符串是导致400错误的直接原因。正确的请求体应为：

{
  "gatewayObjectId": "88c5bf1b-aaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "datasourceObjectIds": ["3395bac9-aaaaaaaaaaaaaaaaaaaaaaaaaaa"]
}

2. 调整云数据源的绑定逻辑 #

无需网关的云数据源不需要绑定到传统网关，你拿到的gatewayID是Power BI内置的云网关，但服务主体无法直接使用个人云连接，需通过以下方式处理：

• 直接配置服务主体认证：用管理员账户打开目标数据模型的数据源设置，为云数据源选择「服务主体」作为认证方式，输入服务主体的凭据（如Client ID、Client Secret），保存后服务主体即可触发刷新。
• API方式更新凭据：若需通过API操作，调用更新数据源凭据的API而非绑定网关API：
  针对普通连接字符串型数据源：

  https://api.powerbi.com/v1.0/myorg/groups/{workspaceId}/datasets/{datasetId}/datasources/{datasourceId}/Default.UpdateConnectionString
  

  针对OAuth类型数据源：

  https://api.powerbi.com/v1.0/myorg/groups/{workspaceId}/datasets/{datasetId}/datasources/{datasourceId}/Default.SetAllPermissions
  

  传入服务主体的认证参数完成配置。

3. 验证服务主体权限 #

确保服务主体拥有：

• 目标工作区和数据模型的管理员/成员权限（仅所有权不足以完成操作）
• 对应云数据源的访问权限（如Azure AD中对云服务的访问权限）

4. 替代方案：使用Power BI服务端配置 #

如果API操作仍有问题，可直接通过Power BI服务完成配置：

1. 用管理员账户登录Power BI服务，打开目标数据模型的「数据源设置」
2. 找到云数据源，切换认证方式为「服务主体」
3. 输入服务主体的Client ID和Client Secret并保存
4. 测试刷新确认正常后，服务主体即可自动触发刷新

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