Datasets - Put Dataset User In Group

  • Ссылка
Service:
Power BI REST APIs
API Version:
v1.0

Обновления разрешения существующего набора данных указанного пользователя на указанные разрешения.

Когда недавно были обновлены разрешения пользователя на набор данных, новые разрешения могут быть недоступны сразу через вызовы API. Чтобы обновить разрешения пользователя, используйте вызов API "Обновить разрешения пользователя ". Этот вызов API можно использовать для удаления всех разрешений набора данных указанного пользователя с помощью datasetUserAccessRight: None

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

Dataset.ReadWrite.All

Разрешения

Разрешения для этого вызова API перечислены в разрешениях наборов данных.

Ограничения

  • Обновление разрешений для субъектов-служб (app principalType) не поддерживается
  • Вызывающий объект должен иметь разрешения ReadWriteReshare для набора данных. Это значит, что администраторы папок, члены и участники с разрешениями на повторное предоставление общего доступа или владельцы наборов данных.
  • Этот API нельзя использовать для добавления или удаления разрешения на запись .
  • Этот API нельзя использовать для удаления наследуемых разрешений на уровне папок. Для администраторов папок и участников разрешение ReadWriteReshareExplore на наборы данных папки наследуется. Для участников папок разрешение ReadWriteExplore на наборы данных папки наследуется. Для средств просмотра папок разрешение на чтение наборов данных папки наследуется. 

PUT https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/users

Параметры URI

Имя В Обязательно Тип Описание
datasetId
 path True

string

Идентификатор набора данных
groupId
 path True

string

uuid

идентификатор рабочей области;

Текст запроса

Имя Обязательно Тип Описание
datasetUserAccessRight True

DatasetUserAccessRight

Права доступа, назначаемые пользователю для набора данных (уровень разрешений)
identifier True

string

Для типа Userсубъекта укажите имя участника-пользователя. В противном случае укажите идентификатор объекта субъекта.
principalType True

PrincipalType

Тип субъекта

Ответы

Имя Тип Описание
200 OK

ОК

Примеры

Example
Example for updating security group dataset permissions to ReadExplore

Example

Sample Request

PUT https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users
Request Body
{
  "identifier": "john@contoso.com",
  "principalType": "User",
  "datasetUserAccessRight": "Read"
}

Sample Response

Status code:
200

Example for updating security group dataset permissions to ReadExplore

Sample Request

PUT https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users
Request Body
{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "principalType": "Group",
  "datasetUserAccessRight": "ReadReshare"
}

Sample Response

Status code:
200

Определения

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

Запись правого доступа субъекта Power BI для набора данных
DatasetUserAccessRight

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

Тип субъекта

DatasetUserAccess

Запись правого доступа субъекта Power BI для набора данных

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

DatasetUserAccessRight

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

string

Для типа Userсубъекта укажите имя участника-пользователя. В противном случае укажите идентификатор объекта субъекта.
principalType

PrincipalType

Тип субъекта

DatasetUserAccessRight

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

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

string

Удаляет разрешение на содержимое в наборе данных.
Read

string

Предоставляет доступ на чтение к содержимому в наборе данных
ReadExplore

string

Предоставляет доступ на чтение и изучение содержимого в наборе данных
ReadReshare

string

Предоставляет доступ на чтение и повторное предоставление доступа к содержимому в наборе данных
ReadReshareExplore

string

Предоставляет доступ для чтения, повторного доступа и просмотра содержимого в наборе данных
ReadWrite

string

Предоставляет доступ на чтение и запись к содержимому в наборе данных.
ReadWriteExplore

string

Предоставляет доступ на чтение, запись и изучение содержимого в наборе данных
ReadWriteReshare

string

Предоставляет доступ для чтения, записи и повторного доступа к содержимому в наборе данных
ReadWriteReshareExplore

string

Предоставляет доступ на чтение, запись, повторное предоставление доступа к содержимому в наборе данных

PrincipalType

Тип субъекта

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

string

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

string

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

string

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

string

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