Pipelines - Update Pipeline User

Служба:

Power BI REST APIs

Версия API:

v1.0

Предоставляет пользователю разрешения для указанного конвейера развертывания.

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

Pipeline.ReadWrite.All

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

Параметры URI

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

Текст запроса

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

Ответы

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

Примеры

Add a group to a deployment pipeline example

Add a service principal to a deployment pipeline example

Add a user to a deployment pipeline example

Add a group to a deployment pipeline example

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

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

Текст запроса

{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "accessRight": "Admin",
  "principalType": "Group"
}

Пример ответа

Код состояния:

200

Add a service principal to a deployment pipeline example

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

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

Текст запроса

{
  "identifier": "a35d842b-90d5-59a1-c56a-5f8fcff0bf9d",
  "accessRight": "Admin",
  "principalType": "App"
}

Пример ответа

Код состояния:

200

Add a user to a deployment pipeline example

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

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

Текст запроса

{
  "identifier": "john@contoso.com",
  "accessRight": "Admin",
  "principalType": "User"
}

Пример ответа

Код состояния:

200

Определения

Имя	Описание
PipelineUser	Запись правого доступа пользователя Power BI для конвейера развертывания
PipelineUserAccessRight	Обязательный. Право доступа, которое пользователь имеет для конвейера развертывания.
PrincipalType	Тип субъекта

PipelineUser

Object

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

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

PipelineUserAccessRight

Enumeration

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

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

PrincipalType

Enumeration

Тип субъекта

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