Datasets - Put Dataset User

  • Ссылка
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/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

Sample Request

PUT https://api.powerbi.com/v1.0/myorg/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/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

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