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

Datasets - Put Dataset User

Служба:
Power BI REST APIs
Версия API:
v1.0

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

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

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

Dataset.ReadWrite.All

Permissions

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

Ограничения

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

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

Параметры URI

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

string

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

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

Имя Обязательно Тип Описание
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/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/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

Перечисление

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

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

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

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

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

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

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

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

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

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

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

PrincipalType

Перечисление

Тип субъекта

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

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

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

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

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