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	Тип участника-пользователя