Datasets - Post Dataset User

Служба:

Power BI REST APIs

Версия API:

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

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

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

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

POST 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

Определения

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

DatasetUserAccessRightEntry

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

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

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

PostDatasetUserAccess

Object

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

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

PrincipalType

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

Тип субъекта

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