Groups - Add Group User

Service:

Power BI REST APIs

API Version:

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

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users

Request Body

{
  "identifier": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "groupUserAccessRight": "Admin",
  "principalType": "App"
}

Sample Response

Status code:

200

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users

Request Body

{
  "emailAddress": "john@contoso.com",
  "groupUserAccessRight": "Admin"
}

Sample Response

Status code:

200

Определения

Имя	Описание
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	Идентификатор профиля субъекта-службы