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

Идентификатор профиля субъекта-службы