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

Groups - Add Group User

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

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

Разрешения

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

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

Workspace.ReadWrite.All

Ограничения

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

POST 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

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

POST 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

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

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users
Текст запроса
{
  "emailAddress": "[email protected]",
  "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

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

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

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

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

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

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

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

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

PrincipalType

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

Тип субъекта

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

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

Тип субъекта-группы
None

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

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

ServicePrincipalProfile

Object

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

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

string

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

string (uuid)

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