Admin - Dataflows GetDataflowUsersAsAdmin

Ссылка

Service:: Power BI REST APIs

API Version:: v1.0

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

Разрешения

Пользователь должен иметь права администратора (например, Office 365 глобального администратора или администратора службы Power BI) или пройти проверку подлинности с помощью субъекта-службы.
Поддерживаются делегированные разрешения.

При выполнении в режиме предварительной проверки подлинности службы в портал Azure приложение не должно иметь необходимых предустановок согласия администратора для Power BI.

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

Tenant.Read.All или Tenant.ReadWrite.All

Применимо только при проверке подлинности с помощью стандартного маркера доступа делегированного администратора. Не должно присутствовать при использовании проверки подлинности через субъект-службу.

Ограничения

Максимум 200 запросов в час.

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows/{dataflowId}/users

Параметры URI

Имя	В	Обязательно	Тип	Описание
dataflowId	path	True	string uuid	Идентификатор потока данных

Ответы

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

Примеры

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows/{dataflowId}/users

Sample Response

Status code:: 200

{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "dataflowUserAccessRight": "ReadWrite",
      "identifier": "john@contoso.com",
      "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
      "principalType": "User"
    }
  ]
}

Определения

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

DataflowUser

Запись права доступа пользователя Power BI для потока данных

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

DataflowUserAccessRight

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

Имя	Тип	Описание
None	string	Удаляет разрешение на доступ к содержимому в потоке данных
Owner	string	Предоставляет доступ для чтения, записи и повторного доступа к содержимому в потоке данных
Read	string	Предоставляет доступ на чтение к содержимому в потоке данных
ReadReshare	string	Предоставляет доступ на чтение и повторное предоставление общего доступа к содержимому в потоке данных
ReadWrite	string	Предоставляет доступ на чтение и запись к содержимому в потоке данных

DataflowUsers

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

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

PrincipalType

Тип субъекта

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

ServicePrincipalProfile

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

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

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