Pipelines - Get Pipeline Users

Служба:: Power BI REST APIs

Версия API:: 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

Образец запроса

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

PipelineUser

Object

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

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

PipelineUserAccessRight

Перечисление

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

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

PipelineUsers

Object

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

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

PrincipalType

Перечисление

Тип субъекта

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