Groups - Get Group Users

Ссылка

Service:: Power BI REST APIs

API Version:: v1.0

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

Разрешения

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

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

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

Ограничения

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

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

With optional parameters:

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

Sample Request

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

Sample Response

Status code:: 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

Пользователь 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

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

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

GroupUsers

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

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

PrincipalType

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

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

ServicePrincipalProfile

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

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