Gateways - Get Datasource Users

Ссылка

Service:: Power BI REST APIs

API Version:: v1.0

Возвращает список пользователей, имеющих доступ к указанному источнику данных.

Разрешения

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

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

Dataset.ReadWrite.All или Dataset.Read.All

Ограничения

Шлюзы виртуальной сети не поддерживаются.

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

Параметры URI

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

Ответы

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

Примеры

Example

Sample Request

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

Sample Response

Status code:: 200

{
  "value": [
    {
      "datasourceAccessRight": "Read",
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "identifier": "john@contoso.com",
      "principalType": "User"
    },
    {
      "datasourceAccessRight": "ReadOverrideEffectiveIdentity",
      "displayName": "ContosoTestApp",
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App"
    }
  ]
}

Определения

Имя	Описание
DatasourceUser	Пользователь Power BI с доступом к источнику данных
DatasourceUserAccessRight	Право доступа (уровень разрешений), которое пользователь имеет в источнике данных
DatasourceUsers	Оболочка ответа OData для списка пользователей Power BI с доступом к источнику данных
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.

DatasourceUsers

Оболочка ответа OData для списка пользователей Power BI с доступом к источнику данных

Имя	Тип	Описание
odata.context	string
value	DatasourceUser[]	Список пользователей с доступом к источнику данных

PrincipalType

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

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

ServicePrincipalProfile

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

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

Поделиться через