Admin - Groups AddUserAsAdmin

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

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

Этот вызов API поддерживает только добавление пользователя, группы безопасности, группы M365 и субъекта-службы.

Разрешения

Пользователь должен быть администратором Fabric.

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

Tenant.ReadWrite.All

Ограничения

  • Максимум 200 запросов в час.
  • Каждая рабочая область ограничена не более 1000 пользователей или групп в ролях рабочей области (администратор, участник, участник, средство просмотра). Количество пользователей в группе не ограничено. Ограничение также охватывает внешних гостей. 

POST https://api.powerbi.com/v1.0/myorg/admin/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

ХОРОШО

Примеры

Add security group to workspace example
Add service principal to workspace example
Add user to group example

Add security group to workspace example

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

POST https://api.powerbi.com/v1.0/myorg/admin/groups/206d27ca-94e8-4a69-855b-5c32bdd458a8/users
Текст запроса
{
  "identifier": "ece007fa-2f19-4df1-bdd5-539881ec5f83",
  "principalType": "Group",
  "groupUserAccessRight": "Member"
}

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

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

Add service principal to workspace example

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

POST https://api.powerbi.com/v1.0/myorg/admin/groups/206d27ca-94e8-4a69-855b-5c32bdd458a8/users
Текст запроса
{
  "identifier": "84c468ad-12f1-471e-af6f-0999da422391",
  "principalType": "App",
  "groupUserAccessRight": "Viewer"
}

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

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

Add user to group example

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

POST https://api.powerbi.com/v1.0/myorg/admin/groups/206d27ca-94e8-4a69-855b-5c32bdd458a8/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

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

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

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

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

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

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

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

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

PrincipalType

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

Тип субъекта

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

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

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

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

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

ServicePrincipalProfile

Object

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

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

string

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

string (uuid)

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