Pipelines - Get Pipeline Users

Ссылка

Service:: Power BI REST APIs

API Version:: v1.0

Возвращает список пользователей, имеющих доступ к указанному конвейеру развертывания.

Требуемая область

Pipeline.ReadWrite.All или Pipeline.Read.All

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
pipelineId	path	True	string uuid	Идентификатор конвейера развертывания

Ответы

Имя	Тип	Описание
200 OK	PipelineUsers	ОК

Примеры

Get users of a deployment pipeline example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/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	Оболочка ответа OData для коллекции пользователей конвейера развертывания Power BI
PrincipalType	Тип субъекта

PipelineUser

Запись правого доступа пользователя Power BI для конвейера развертывания

Имя	Тип	Описание
accessRight	PipelineUserAccessRight	Обязательный. Право доступа, которое пользователь имеет для конвейера развертывания.
identifier	string	Для типа `User`субъекта укажите имя участника-пользователя. В противном случае укажите идентификатор объекта субъекта.
principalType	PrincipalType	Тип субъекта

PipelineUserAccessRight

Обязательный. Право доступа, которое пользователь имеет для конвейера развертывания.

Имя	Тип	Описание
Admin	string	Предоставляет права администратора конвейеру развертывания

PipelineUsers

Оболочка ответа OData для коллекции пользователей конвейера развертывания Power BI

Имя	Тип	Описание
odata.context	string	Контекст OData
value	PipelineUser[]	Коллекция пользователей конвейера развертывания

PrincipalType

Тип субъекта

Имя	Тип	Описание
App	string	Тип субъекта-службы
Group	string	Тип субъекта-группы
None	string	Нет типа субъекта. Используется для доступа на уровне всей организации.
User	string	Тип участника-пользователя

Поделиться через