Datasets - Get Dataset Users

Ссылка

Service:: Power BI REST APIs

API Version:: v1.0

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

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

Разрешения

Разрешения для этого вызова 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

Sample Request

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

Sample Response

Status code:: 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

Запись правого доступа субъекта 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	Предоставляет доступ на чтение, запись, повторное предоставление доступа к содержимому в наборе данных

DatasetUsersAccess

Оболочка ответа OData для списка субъектов Power BI с доступом к набору данных

Имя	Тип	Описание
odata.context	string
value	DatasetUserAccess[]	Список пользователей с доступом к набору данных

PrincipalType

Тип субъекта

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

Поделиться через