Datasets - Post Dataset User

Service:

Power BI REST APIs

API Version:

v1.0

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

Когда недавно были обновлены разрешения пользователя для набора данных, новые разрешения могут быть недоступны сразу через вызовы API. Чтобы обновить разрешения пользователя, используйте вызов API "Обновить разрешения пользователя ".

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

Dataset.ReadWrite.All

Ограничения

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

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
datasetId	path	True	string	Идентификатор набора данных

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

Имя	Обязательно	Тип	Описание
datasetUserAccessRight	True	DatasetUserAccessRightEntry	Обязательный. Право доступа, предоставляемое пользователю для набора данных.
identifier	True	string	Для типа Userсубъекта укажите имя участника-пользователя. В противном случае укажите идентификатор объекта субъекта.
principalType	True	PrincipalType	Тип субъекта

Ответы

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

Примеры

Example

Example for granting ReadExplore right to a security group

Example

Sample Request

POST 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 granting ReadExplore right to a security group

Sample Request

POST 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

Определения

Имя	Описание
DatasetUserAccessRightEntry	Обязательный элемент. Право доступа, предоставляемое пользователю для набора данных.
PostDatasetUserAccess	Запись правого доступа пользователя Power BI для набора данных
PrincipalType	Тип субъекта

DatasetUserAccessRightEntry

Обязательный элемент. Право доступа, предоставляемое пользователю для набора данных.

Имя	Тип	Описание
Read	string	Предоставляет доступ на чтение содержимого в наборе данных
ReadExplore	string	Предоставляет доступ на чтение и изучение содержимого в наборе данных
ReadReshare	string	Предоставляет доступ на чтение и повторное предоставление доступа к содержимому в наборе данных
ReadReshareExplore	string	Предоставляет доступ для чтения, повторного доступа и просмотра содержимого в наборе данных

PostDatasetUserAccess

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

Имя	Тип	Описание
datasetUserAccessRight	DatasetUserAccessRightEntry	Обязательный. Право доступа, предоставляемое пользователю для набора данных.
identifier	string	Для типа Userсубъекта укажите имя участника-пользователя. В противном случае укажите идентификатор объекта субъекта.
principalType	PrincipalType	Тип субъекта

PrincipalType

Тип субъекта

Имя	Тип	Описание
App	string	Тип субъекта-службы
Group	string	Тип субъекта-группы
None	string	Нет типа субъекта. Используется для доступа на уровне всей организации.
User	string	Тип участника-пользователя