Gateways - Add Datasource User

Service:

Power BI REST APIs

API Version:

v1.0

Предоставляет или обновляет разрешения, необходимые для использования указанного источника данных для указанного пользователя.

Разрешения

Пользователь должен иметь разрешения администратора шлюза.

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

Dataset.ReadWrite.All

Ограничения

Шлюзы виртуальной сети не поддерживаются. Добавление групп с помощью API не поддерживается.

POST https://api.powerbi.com/v1.0/myorg/gateways/{gatewayId}/datasources/{datasourceId}/users

Параметры URI

Имя	В	Обязательно	Тип	Описание
datasourceId	path	True	string uuid	Идентификатор источника данных
gatewayId	path	True	string uuid	Идентификатор шлюза. При использовании кластера шлюза идентификатор шлюза относится к основному (первому) шлюзу в кластере. В таких случаях идентификатор шлюза аналогичен идентификатору кластера шлюза.

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

Имя	Обязательно	Тип	Описание
datasourceAccessRight	True	DatasourceUserAccessRight	Право доступа (уровень разрешений), которое пользователь имеет в источнике данных
displayName		string	Отображаемое имя участника
emailAddress		string	Адрес электронной почты пользователя
identifier		string	Идентификатор объекта субъекта
principalType		PrincipalType	Тип участника
profile		ServicePrincipalProfile	Профиль субъекта служба Power BI. Применимо только для решения Power BI Embedded мультитенантности.

Ответы

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

Примеры

Assign the ReadOverrideEffectiveIdentity user access right to a service principal example

Example

Assign the ReadOverrideEffectiveIdentity user access right to a service principal example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users

Request Body

{
  "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
  "datasourceAccessRight": "ReadOverrideEffectiveIdentity"
}

Sample Response

Status code:

200

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users

Request Body

{
  "emailAddress": "john@contoso.com",
  "datasourceAccessRight": "Read"
}

Sample Response

Status code:

200

Определения

Имя	Описание
DatasourceUser	Пользователь Power BI с доступом к источнику данных
DatasourceUserAccessRight	Право доступа (уровень разрешений), которое пользователь имеет в источнике данных
PrincipalType	Тип участника
ServicePrincipalProfile	Профиль субъекта служба Power BI. Применимо только для решения Power BI Embedded мультитенантности.

DatasourceUser

Пользователь Power BI с доступом к источнику данных

Имя	Тип	Описание
datasourceAccessRight	DatasourceUserAccessRight	Право доступа (уровень разрешений), которое пользователь имеет в источнике данных
displayName	string	Отображаемое имя участника
emailAddress	string	Адрес электронной почты пользователя
identifier	string	Идентификатор объекта субъекта
principalType	PrincipalType	Тип участника
profile	ServicePrincipalProfile	Профиль субъекта служба Power BI. Применимо только для решения Power BI Embedded мультитенантности.

DatasourceUserAccessRight

Право доступа (уровень разрешений), которое пользователь имеет в источнике данных

Имя	Тип	Описание
None	string	Нет разрешений на доступ к источнику данных. Применяется только при обновлении разрешений пользователя.
Read	string	Наборы данных, принадлежащие пользователю, имеют доступ на чтение к источнику данных
ReadOverrideEffectiveIdentity	string	Пользователь может переопределить действующее удостоверение для Power BI Embedded. Применимо только для локальных источников данных служб Analysis Services.

PrincipalType

Тип участника

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

ServicePrincipalProfile

Профиль субъекта служба Power BI. Применимо только для решения Power BI Embedded мультитенантности.

Имя	Тип	Описание
displayName	string	Имя профиля субъекта-службы
id	string	Идентификатор профиля субъекта-службы