Admin - Apps GetAppUsersAsAdmin

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

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

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

Разрешения

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

При выполнении в рамках проверки подлинности службы приложения не должны иметь необходимые разрешения администратора для 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

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

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

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

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

Object

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

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

AppUserAccessRight

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

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

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

AppUsers

Object

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

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

PrincipalType

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

Тип субъекта

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