Pipelines - Update Pipeline User

Service:

Power BI REST APIs

API Version:

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

Sample Request

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

Request Body

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

Sample Response

Status code:

200

Add a service principal to a deployment pipeline example

Sample Request

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

Request Body

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

Sample Response

Status code:

200

Add a user to a deployment pipeline example

Sample Request

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

Request Body

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

Sample Response

Status code:

200

Определения

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

PipelineUser

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

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

PipelineUserAccessRight

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

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

PrincipalType

Тип субъекта

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