Gateways - Add Datasource User
Предоставляет или обновляет разрешения, необходимые для использования указанного источника данных для указанного пользователя.
Разрешения
У пользователя должны быть разрешения администратора шлюза.
Требуемая область
Dataset.ReadWrite.All
Ограничения
Шлюзы виртуальной сети не поддерживаются.
Добавление групп через API не поддерживается.
POST https://api.powerbi.com/v1.0/myorg/gateways/{gatewayId}/datasources/{datasourceId}/usersПараметры URI
| Имя | В | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
datasource
|
path | True |
string (uuid) |
Идентификатор источника данных |
|
gateway
|
path | True |
string (uuid) |
Идентификатор шлюза. При использовании кластера шлюза идентификатор шлюза ссылается на первичный (первый) шлюз в кластере. В таких случаях идентификатор шлюза аналогичен идентификатору кластера шлюза. |
Текст запроса
| Имя | Обязательно | Тип | Описание |
|---|---|---|---|
| datasourceAccessRight | True |
Право доступа (уровень разрешений), которое пользователь имеет в источнике данных. |
|
| displayName |
string |
Отображаемое имя субъекта |
|
| emailAddress |
string |
Адрес электронной почты пользователя |
|
| identifier |
string |
||
| principalType |
Тип субъекта |
||
| profile |
Профиль субъекта-службы Power BI. Применимо только для решения Power BI Embedded с несколькими арендами. |
Ответы
| Имя | Тип | Описание |
|---|---|---|
| 200 OK |
ХОРОШО |
Примеры
|
Assign the Read |
| Example |
Assign the ReadOverrideEffectiveIdentity user access right to a service principal example
Образец запроса
POST https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users{
"identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
"datasourceAccessRight": "ReadOverrideEffectiveIdentity"
}Пример ответа
Example
Образец запроса
POST https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users{
"emailAddress": "john@contoso.com",
"datasourceAccessRight": "Read"
}Пример ответа
Определения
| Имя | Описание |
|---|---|
|
Datasource |
Пользователь Power BI с доступом к источнику данных |
|
Datasource |
Право доступа (уровень разрешений), которое пользователь имеет в источнике данных. |
|
Principal |
Тип субъекта |
|
Service |
Профиль субъекта-службы Power BI. Применимо только для решения Power BI Embedded с несколькими арендами. |
DatasourceUser
Пользователь Power BI с доступом к источнику данных
| Имя | Тип | Описание |
|---|---|---|
| datasourceAccessRight |
Право доступа (уровень разрешений), которое пользователь имеет в источнике данных. |
|
| displayName |
string |
Отображаемое имя субъекта |
| emailAddress |
string |
Адрес электронной почты пользователя |
| identifier |
string |
|
| principalType |
Тип субъекта |
|
| profile |
Профиль субъекта-службы Power BI. Применимо только для решения Power BI Embedded с несколькими арендами. |
DatasourceUserAccessRight
Право доступа (уровень разрешений), которое пользователь имеет в источнике данных.
| Значение | Описание |
|---|---|
| None |
Нет разрешения на доступ к источнику данных. Применяется только при обновлении разрешений пользователя. |
| Read |
Наборы данных, принадлежащие пользователю, имеют доступ на чтение к источнику данных |
| ReadOverrideEffectiveIdentity |
Пользователь может переопределить эффективное удостоверение для Power BI Embedded. Применимо только для локальных источников данных Analysis Services. |
PrincipalType
Тип субъекта
| Значение | Описание |
|---|---|
| None |
Нет типа субъекта. Используется для доступа на уровне всей организации. |
| User |
Тип субъекта-пользователя |
| Group |
Тип субъекта-группы |
| App |
Тип субъекта-службы |
ServicePrincipalProfile
Профиль субъекта-службы Power BI. Применимо только для решения Power BI Embedded с несколькими арендами.
| Имя | Тип | Описание |
|---|---|---|
| displayName |
string |
Имя профиля субъекта-службы |
| id |
string (uuid) |
Идентификатор профиля субъекта-службы |