Admin - Groups AddUserAsAdmin

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

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

Разрешения

Пользователь должен иметь права администратора (например, Office 365 глобальный администратор или администратор службы Power BI).

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

Tenant.ReadWrite.All

Ограничения

Максимум 200 запросов в час.

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

Sample Request

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"
}

Sample Response

Add service principal to workspace example

Sample Request

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"
}

Sample Response

Add user to group example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/admin/groups/206d27ca-94e8-4a69-855b-5c32bdd458a8/users
{
  "emailAddress": "john@contoso.com",
  "groupUserAccessRight": "Admin"
}

Sample Response

Определения

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

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

GroupUserAccessRight

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

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

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

PrincipalType

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

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

string

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

Group

string

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

None

string

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

User

string

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

ServicePrincipalProfile

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

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

string

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

id

string

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