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


Admin - Apps GetAppUsersAsAdmin

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

Разрешения

  • Пользователь должен иметь права администратора (например, 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

{
  "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

Тип участника-пользователя