Admin - Users GetUserArtifactAccessAsAdmin

Ссылка

Service:: Power BI REST APIs

API Version:: v1.0

Возвращает список элементов Power BI (например, отчетов или панелей мониторинга), к которым у указанного пользователя есть доступ.

Разрешения

Пользователь должен иметь права администратора (например, Office 365 глобального администратора или администратора службы Power BI) или пройти проверку подлинности с помощью субъекта-службы.
Поддерживаются делегированные разрешения.

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

Tenant.Read.All или Tenant.ReadWrite.All

Ограничения

Максимум 200 запросов в час.

GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/artifactAccess

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/artifactAccess?continuationToken={continuationToken}&artifactTypes={artifactTypes}

Параметры URI

Имя	В	Обязательно	Тип	Описание
userId	path	True	string	Идентификатор графа или имя участника-пользователя (UPN) пользователя
artifactTypes	query		string	Разделенный запятыми список типов артефактов.
continuationToken	query		string	Маркер, необходимый для получения следующего блока результирующих наборов

Ответы

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

Примеры

Example

Example with artifactTypes

Example with Guest User

Example with UPN

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/users/f089354e-8366-4e18-aea3-4cb4a3a50b48/artifactAccess

Sample Response

Status code:: 200

{
  "artifactAccessEntities": [
    {
      "artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
      "displayName": "test report",
      "artifactType": "Report",
      "accessRight": "ReadWrite"
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/f089354e-8366-4e18-aea3-4cb4a3a50b48/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Example with artifactTypes

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/users/testUser@microsoft.com/artifactAccess?artifactTypes=Dataflow,Dashboard

Sample Response

Status code:: 200

{
  "artifactAccessEntities": [
    {
      "artifactId": "09ce06d1-e81b-fea0-1c6d-8fe3dd2f8e87",
      "displayName": "Test Dataflow",
      "artifactType": "Dataflow",
      "accessRight": "ReadWrite"
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/testUser%40microsoft.com/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Example with Guest User

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/users/testUser_microsoft.com%23EXT%23@contoso.com/artifactAccess

Sample Response

Status code:: 200

{
  "artifactAccessEntities": [
    {
      "artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
      "displayName": "test report",
      "artifactType": "Report",
      "accessRight": "ReadWrite"
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/testUser_microsoft.com%23EXT%23%40contoso.com/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Example with UPN

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/users/testUser@microsoft.com/artifactAccess

Sample Response

Status code:: 200

{
  "artifactAccessEntities": [
    {
      "artifactId": "41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
      "displayName": "test report",
      "artifactType": "Report",
      "accessRight": "ReadWrite"
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/testUser%40microsoft.com/artifactAccess?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Определения

Имя	Описание
ArtifactAccessEntry	Запись доступа пользователя для элемента Power BI
ArtifactAccessResponse	Оболочка ответа OData для списка элементов Power BI (например, отчетов или панелей мониторинга), к которым может получить доступ пользователь
ArtifactType	Тип артефакта
PrincipalType	Тип субъекта
ServicePrincipalProfile	Профиль субъекта служба Power BI. Применимо только для Power BI Embedded мультитенантного решения.
User	Пользователь Power BI

ArtifactAccessEntry

Запись доступа пользователя для элемента Power BI

Имя	Тип	Описание
accessRight	string	Право доступа, которое пользователь имеет для элемента Power BI
artifactId	string	Идентификатор элемента Power BI
artifactType	ArtifactType	Тип элемента Power BI
displayName	string	Отображаемое имя элемента Power BI
shareType	string	Тип доступа к элементу Power BI. Доступно только для api-интерфейсов артефактов с широким доступом.
sharer	User	Пользователь, который предоставил общий доступ к элементу Power BI. Доступно только для api-интерфейсов артефактов с широким доступом.

ArtifactAccessResponse

Оболочка ответа OData для списка элементов Power BI (например, отчетов или панелей мониторинга), к которым может получить доступ пользователь

Имя	Тип	Описание
artifactAccessEntities	ArtifactAccessEntry[]	Список элементов Power BI, к которым может получить доступ пользователь
continuationToken	string	Токен для следующего блока в результирующем наборе
continuationUri	string	Универсальный код ресурса (URI) следующего блока в результирующем наборе
odata.context	string

ArtifactType

Тип артефакта

Имя	Тип	Описание
App	string	Приложения Power BI
Capacity	string	Объект Capacity
Dashboard	string	Панель мониторинга Power BI
Dataflow	string	Поток данных Power BI
Dataset	string	Набор данных Power BI
Group	string	Объект общей рабочей области версии 1
PaginatedReport	string	Отчет Power BI с разбивкой на страницы
PersonalGroup	string	Объект "Моя рабочая область"
Report	string	Отчет Power BI
Workspace	string	Объект общей рабочей области

PrincipalType

Тип субъекта

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

ServicePrincipalProfile

Профиль субъекта служба Power BI. Применимо только для Power BI Embedded мультитенантного решения.

Имя	Тип	Описание
displayName	string	Имя профиля субъекта-службы
id	string	Идентификатор профиля субъекта-службы

User

Пользователь Power BI

Имя	Тип	Описание
displayName	string	Отображаемое имя субъекта
emailAddress	string	Адрес электронной почты пользователя
graphId	string	Идентификатор субъекта в Microsoft Graph. Доступно только для api-интерфейсов администратора.
identifier	string	Идентификатор субъекта
principalType	PrincipalType	Тип субъекта
profile	ServicePrincipalProfile	Профиль субъекта служба Power BI. Применимо только для Power BI Embedded мультитенантного решения.
userType	string	Тип пользователя.

Share via

Admin - Users GetUserArtifactAccessAsAdmin

Разрешения

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

Ограничения

Параметры URI

Ответы

Примеры

Example

Sample Request

Sample Response

Example with artifactTypes

Sample Request

Sample Response

Example with Guest User

Sample Request

Sample Response

Example with UPN

Sample Request

Sample Response

Определения

ArtifactAccessEntry

ArtifactAccessResponse

ArtifactType

PrincipalType

ServicePrincipalProfile

User

Дополнительные ресурсы