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


Groups - Add Group User

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

Разрешения

Этот вызов 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

Sample Request

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

Sample Response

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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

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