Admin - Apps GetAppUsersAsAdmin

Ссылка

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/apps/{appId}/users

Параметры URI

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

Ответы

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

Примеры

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/apps/f089354e-8366-4e18-aea3-4cb4a3a50b48/users

Sample Response

Status code:: 200

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

Определения

Имя	Описание
AppUser	Запись права доступа пользователя Power BI для приложения
AppUserAccessRight	Право доступа, которое пользователь имеет для приложения
AppUsers	Оболочка ответа OData для списка пользователей Power BI с доступом к приложению
PrincipalType	Тип участника

AppUser

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

Имя	Тип	Описание
appUserAccessRight	AppUserAccessRight	Право доступа, которое пользователь имеет для приложения
displayName	string	Отображаемое имя участника
emailAddress	string	Адрес электронной почты пользователя
graphId	string	Идентификатор субъекта в Майкрософт Graph. Доступно только для api-интерфейсов администратора.
identifier	string	Идентификатор субъекта
principalType	PrincipalType	Тип участника

AppUserAccessRight

Право доступа, которое пользователь имеет для приложения

Имя	Тип	Описание
All	string	Предоставляет доступ для чтения, записи, просмотра, повторного доступа и копирования к содержимому в приложении
None	string	Нет разрешений на содержимое в приложении
Read	string	Предоставляет доступ на чтение к содержимому в приложении
ReadCopy	string	Предоставляет доступ на чтение и копирование содержимого в приложении
ReadExplore	string	Предоставляет доступ на чтение и просмотр к содержимому в приложении
ReadExploreCopy	string	Предоставляет доступ на чтение, просмотр и копирование содержимого в приложении
ReadReshare	string	Предоставляет доступ на чтение и повторное предоставление общего доступа к содержимому в приложении
ReadReshareCopy	string	Предоставляет доступ на чтение, повторное предоставление общего доступа и копирование к содержимому в приложении
ReadReshareExplore	string	Предоставляет доступ на чтение, повторное предоставление общего доступа и просмотр к содержимому в приложении
ReadReshareExploreCopy	string	Предоставляет доступ на чтение, повторное предоставление общего доступа, просмотр и копирование содержимого в приложении
ReadWrite	string	Предоставляет доступ на чтение и запись к содержимому в приложении
ReadWriteExplore	string	Предоставляет доступ на чтение, запись и просмотр содержимого в приложении
ReadWriteExploreCopy	string	Предоставляет доступ на чтение, запись, просмотр и копирование содержимого в приложении
ReadWriteReshare	string	Предоставляет доступ для чтения, записи и повторного доступа к содержимому в приложении
ReadWriteReshareExplore	string	Предоставляет доступ для чтения, записи, повторного доступа и просмотра содержимого в приложении

AppUsers

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

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

PrincipalType

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

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