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

Groups - Update Group User

  • Ссылка
Служба:
Power BI REST APIs
Версия API:
v1.0

Обновления указанные разрешения пользователя для указанной рабочей области.

Разрешения

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

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

Workspace.ReadWrite.All

Ограничения

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

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

Параметры URI

Имя В Обязательно Тип Описание
groupId
 path True

string

uuid

идентификатор рабочей области;

Текст запроса

Имя Обязательно Тип Описание
groupUserAccessRight True

GroupUserAccessRight

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

string

Идентификатор субъекта
principalType True

PrincipalType

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

string

Отображаемое имя участника
emailAddress

string

Адрес электронной почты пользователя
graphId

string

Идентификатор участника в Microsoft Graph. Доступно только для api-интерфейсов администратора.
profile

ServicePrincipalProfile

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

string

Тип пользователя.

Ответы

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

ОК

Примеры

Assign administrator user access rights to a service principal example
Example

Assign administrator user access rights to a service principal example

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

PUT https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users
Текст запроса
{
  "identifier": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "groupUserAccessRight": "Admin",
  "principalType": "App"
}

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

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

Example

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

PUT https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users
Текст запроса
{
  "emailAddress": "john@contoso.com",
  "groupUserAccessRight": "Admin"
}

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

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

Определения

Имя Описание
GroupUser

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

Право доступа (уровень разрешений), которое пользователь имеет в рабочей области
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

Enumeration

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

Значение Описание
Admin

Права администратора на содержимое рабочей области
Contributor

Чтение и просмотр (ReadExplore) доступ к содержимому рабочей области
Member

Права на чтение, повторное предоставление общего доступа и изучение (ReadReshareExplore) к содержимому рабочей области
None

Нет доступа к содержимому рабочей области
Viewer

Доступ только для чтения (чтение) к содержимому рабочей области

PrincipalType

Enumeration

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

Значение Описание
App

Тип субъекта-службы
Group

Тип участника группы
None

Нет типа субъекта. Используйте для доступа на уровне всей организации.
User

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

ServicePrincipalProfile

Object

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

Имя Тип Описание
displayName

string

Имя профиля субъекта-службы
id

string

Идентификатор профиля субъекта-службы