Admin - Reports GetReportUsersAsAdmin

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

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

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

Permissions

Пользователь должен быть администратором Fabric или пройти проверку подлинности с помощью субъекта-службы.
Поддерживаются делегированные разрешения.

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

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

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

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

Ограничения

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

GET https://api.powerbi.com/v1.0/myorg/admin/reports/{reportId}/users

Параметры URI

Имя	В	Обязательно	Тип	Описание
reportId	path	True	string (uuid)	Идентификатор отчета

Ответы

Имя	Тип	Описание
200 OK	ReportUsers	ХОРОШО

Примеры

Example

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

GET https://api.powerbi.com/v1.0/myorg/admin/reports/{reportId}/users

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

Код состояния:: 200

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

Определения

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

PrincipalType

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

Тип субъекта

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

ReportUser

Object

Запись права доступа пользователя Power BI для отчета

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

ReportUserAccessRight

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

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

Значение	Описание
None	Нет разрешения на содержимое в отчете
Read	Предоставляет доступ на чтение к содержимому в отчете
ReadWrite	Предоставляет доступ на чтение и запись к содержимому в отчете
ReadReshare	Предоставление доступа к содержимому в отчете для чтения и повторного доступа к содержимому
ReadCopy	Предоставление доступа к содержимому в отчете для чтения и копирования
Owner	Предоставляет доступ к содержимому в отчете для чтения, записи и повторного доступа к содержимому

ReportUsers

Object

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

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

ServicePrincipalProfile

Object

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

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