Admin - Pipelines GetPipelineUsersAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

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

权限

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

所需范围

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

Sample Request

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

Sample Response

Status code:

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

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

名称	类型	说明
accessRight	PipelineUserAccessRight	必需。 用户对部署管道的访问权限。
identifier	string	对于主体类型 User，请提供 UPN。 否则，请提供主体 的对象 ID 。
principalType	PrincipalType	主体类型

PipelineUserAccessRight

必需。 用户对部署管道的访问权限。

名称	类型	说明
Admin	string	向部署管道授予管理员权限

PipelineUsers

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

名称	类型	说明
odata.context	string	OData 上下文
value	PipelineUser[]	部署管道用户的集合

PrincipalType

主体类型

名称	类型	说明
App	string	服务主体类型
Group	string	组主体类型
None	string	无主体类型。 用于整个组织级别访问权限。
User	string	用户主体类型