通过

Admin - Pipelines GetPipelineUsersAsAdmin

服务:
Power BI REST APIs
API 版本:
v1.0

返回有权访问指定部署管道的用户的列表。

Permissions

用户必须具有管理员权限或使用服务主体进行身份验证。

所需范围

Tenant.Read.All 或 Tenant.ReadWrite.All

局限性

每小时最多 200 个请求。 

GET https://api.powerbi.com/v1.0/myorg/admin/pipelines/{pipelineId}/users

URI 参数

名称 在 必需 类型 说明
pipelineId
 path True

string (uuid)

部署管道 ID

响应

名称 类型 说明
200 OK

PipelineUsers

好的

示例

Get users of a deployment pipeline example

示例请求

GET https://api.powerbi.com/v1.0/myorg/admin/pipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/users

示例响应

状态代码:
200 
{
  "value": [
    {
      "identifier": "john@contoso.com",
      "accessRight": "Admin",
      "principalType": "User"
    },
    {
      "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
      "accessRight": "Admin",
      "principalType": "Group"
    },
    {
      "identifier": "a35d842b-90d5-59a1-c56a-5f8fcff0bf9d",
      "accessRight": "Admin",
      "principalType": "App"
    }
  ]
}

定义

名称 说明
PipelineUser

部署管道的 Power BI 用户访问权限条目
PipelineUserAccessRight

必填。 用户对部署管道具有的访问权限。
PipelineUsers

Power BI 部署管道用户的集合的 OData 响应包装器
PrincipalType

主体类型

PipelineUser

Object

部署管道的 Power BI 用户访问权限条目

名称 类型 说明
accessRight

PipelineUserAccessRight

必填。 用户对部署管道具有的访问权限。
identifier

string

对于主体类型 User，请提供 UPN。 否则，请提供主体 的对象 ID 。
principalType

PrincipalType

主体类型

PipelineUserAccessRight

枚举

必填。 用户对部署管道具有的访问权限。

值 说明
Admin

向部署管道授予管理员权限

PipelineUsers

Object

Power BI 部署管道用户的集合的 OData 响应包装器

名称 类型 说明
@odata.context

string

OData 上下文
value

PipelineUser[]

部署管道用户的集合

PrincipalType

枚举

主体类型

值 说明
None

无主体类型。 用于整个组织级别的访问。
User

用户主体类型
Group

组主体类型
App

服务主体类型