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

Datasets - Put Dataset User In Group

  • Ссылка
Служба:
Power BI REST APIs
Версия API:
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

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

PUT https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users
Текст запроса
{
  "identifier": "john@contoso.com",
  "principalType": "User",
  "datasetUserAccessRight": "Read"
}

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

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

Example for updating security group dataset permissions to ReadExplore

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

PUT https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users
Текст запроса
{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "principalType": "Group",
  "datasetUserAccessRight": "ReadReshare"
}

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

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

Определения

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

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

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

Тип субъекта

DatasetUserAccess

Object

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

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

DatasetUserAccessRight

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

string

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

PrincipalType

Тип субъекта

DatasetUserAccessRight

Enumeration

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

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

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

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

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

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

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

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

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

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

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

PrincipalType

Enumeration

Тип субъекта

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

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

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

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

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