Datasets - Get Dataset Users

Служба:: Power BI REST APIs

Версия API:: v1.0

Возвращает список субъектов, имеющих доступ к указанному набору данных.

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

Permissions

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

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

Dataset.Read.All или Dataset.ReadWrite.All

Ограничения

Вызывающий объект должен иметь разрешения ReadWriteReshare для набора данных. То есть администраторы папок, участники и участники с разрешениями повторного доступа или владельцами наборов данных.

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

Параметры URI

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

Ответы

Имя	Тип	Описание
200 OK	DatasetUsersAccess	ХОРОШО

Примеры

Example

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

GET https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

Пример ответа

Код состояния:: 200

{
  "value": [
    {
      "identifier": "john@contoso.com",
      "principalType": "User",
      "datasetUserAccessRight": "Read"
    },
    {
      "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
      "principalType": "Group",
      "datasetUserAccessRight": "ReadReshare"
    },
    {
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App",
      "datasetUserAccessRight": "ReadWriteReshareExplore"
    }
  ]
}

Определения

Имя	Описание
DatasetUserAccess	Запись права доступа субъекта Power BI для набора данных
DatasetUserAccessRight	Право доступа, которое пользователь имеет для набора данных (уровень разрешений)
DatasetUsersAccess	Оболочка ответа OData для списка субъектов Power BI с доступом к набору данных
PrincipalType	Тип субъекта

DatasetUserAccess

Object

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

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

DatasetUserAccessRight

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

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

Значение	Описание
None	Удаляет разрешение на содержимое в наборе данных
Read	Предоставляет доступ на чтение к содержимому в наборе данных
ReadWrite	Предоставляет доступ на чтение и запись к содержимому в наборе данных
ReadReshare	Предоставляет доступ на чтение и повторное предоставление доступа к содержимому в наборе данных
ReadWriteReshare	Предоставляет доступ для чтения, записи и повторного доступа к содержимому в наборе данных
ReadExplore	Предоставляет доступ на чтение и изучение содержимого в наборе данных
ReadReshareExplore	Предоставляет доступ к содержимому в наборе данных для чтения, повторного доступа и просмотра
ReadWriteExplore	Предоставляет доступ на чтение, запись и изучение содержимого в наборе данных
ReadWriteReshareExplore	Предоставляет доступ для чтения, записи, повторного доступа к содержимому в наборе данных

DatasetUsersAccess