Groups - Get Group Users

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

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

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

Permissions

Этот вызов API может вызываться профилем субъекта-службы. Дополнительные сведения см. в разделе "Профили субъектов-служб" в Power BI Embedded.

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

Workspace.Read.All или Workspace.ReadWrite.All

Ограничения

Разрешения пользователей для рабочих областей занимают некоторое время для обновления и могут быть не сразу доступны при использовании вызовов API. Чтобы обновить разрешения пользователя, используйте вызов API "Обновить разрешения пользователей ".

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/users

С использованием необязательных параметров:

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/users?$top={$top}&$skip={$skip}

Параметры URI

Имя	В	Обязательно	Тип	Описание
groupId	path	True	string (uuid)	Идентификатор рабочей области
$skip	query		integer (int32)	Пропускает первые результаты n
$top	query		integer (int32)	Возвращает только первые результаты n

Ответы

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

Примеры

Example

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

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

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

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

{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "groupUserAccessRight": "Admin",
      "identifier": "john@contoso.com",
      "principalType": "User"
    },
    {
      "displayName": "Adam Wood",
      "emailAddress": "Adam@contoso.com",
      "groupUserAccessRight": "Member",
      "identifier": "Adam@contoso.com",
      "principalType": "User"
    },
    {
      "displayName": "ContosoTestApp",
      "groupUserAccessRight": "Admin",
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App"
    }
  ]
}

Определения

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

GroupUser

Object

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

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

GroupUserAccessRight

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

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

Значение	Описание
None	Нет доступа к содержимому рабочей области
Member	Чтение, повторное использование и изучение прав доступа (ReadReshareExplore) к содержимому рабочей области
Admin	Права администратора на содержимое рабочей области
Contributor	Доступ к содержимому рабочей области для чтения и изучения (ReadExplore)
Viewer	Доступ только для чтения (чтение) к содержимому рабочей области

GroupUsers

Object

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

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

PrincipalType

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

Тип субъекта

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

ServicePrincipalProfile

Object

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

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