Admin - Dashboards GetDashboardUsersAsAdmin

Ссылка

Service:: Power BI REST APIs

API Version:: v1.0

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

Разрешения

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

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

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

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

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

Ограничения

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

GET https://api.powerbi.com/v1.0/myorg/admin/dashboards/{dashboardId}/users

Параметры URI

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

Ответы

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

Примеры

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/dashboards/{dashboardId}/users

Sample Response

Status code:: 200

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

Определения

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

DashboardUser

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

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

DashboardUserAccessRight

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

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

DashboardUsers

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

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

PrincipalType

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

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

ServicePrincipalProfile

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

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

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