Gateways - Get Datasource Users

Служба:: Power BI REST APIs

Версия API:: v1.0

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

Permissions

У пользователя должны быть разрешения администратора шлюза.

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

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

Образец запроса

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

Пример ответа

Код состояния:: 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

Object

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

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

DatasourceUserAccessRight

Перечисление

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

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

DatasourceUsers

Object

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

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

PrincipalType

Перечисление

Тип субъекта

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

ServicePrincipalProfile

Object

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

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