Admin - Users GetUserSubscriptionsAsAdmin

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

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

Возвращает список подписок для указанного пользователя. Это вызов API предварительной версии.

Permissions

Пользователь должен быть администратором Fabric или пройти проверку подлинности с помощью субъекта-службы.
Поддерживаются делегированные разрешения.

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

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

Ограничения

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

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

С использованием необязательных параметров:

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

Параметры URI

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

Ответы

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

Примеры

Example

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

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

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

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

{
  "subscriptionEntities": [
    {
      "id": "9225d0bc-9f5e-4819-a637-799c0c4fh3f1",
      "title": "Team Scorecard-test",
      "artifactId": "0b50f0bf-b22b-4685-83b9-b6d17f7f4e46",
      "artifactDisplayName": "Customer Profitability Sample",
      "subArtifactDisplayName": "Team Scorecard",
      "artifactType": "Report",
      "isEnabled": false,
      "frequency": "Daily",
      "startDate": "8/10/2021 12:00:00 AM",
      "endDate": "8/10/2022 12:00:00 AM",
      "linkToContent": false,
      "previewImage": true,
      "attachmentFormat": "PNG",
      "users": []
    }
  ],
  "continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/f089354e-8366-4e18-aea3-4cb4a3a50b48/subscriptions?continuationToken='LDEsMTAwMDAwLDA%3D'",
  "continuationToken": "LDEsMTAwMDAwLDA%3D"
}

Определения

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

PrincipalType

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

Тип субъекта

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

ServicePrincipalProfile

Object

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

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

Subscription

Object

Подписка по электронной почте для элемента Power BI (например, отчета или панели мониторинга)

Имя	Тип	Описание
artifactDisplayName	string	Имя подписанного элемента Power BI (например, отчета или панели мониторинга)
artifactId	string (uuid)	Идентификатор подписанного элемента Power BI (например, отчета или панели мониторинга)
artifactType	string	Тип элемента Power BI (например `Report`, `Dashboard`или `Dataset`)
attachmentFormat	string	Формат отчета, присоединенного к подписке электронной почты
endDate	string (date-time)	Дата окончания и время подписки электронной почты
frequency	string	Частота подписки электронной почты
id	string (uuid)	Идентификатор подписки
isEnabled	boolean	Включена ли подписка на электронную почту
linkToContent	boolean	Существует ли ссылка на подписку электронной почты
previewImage	boolean	Наличие снимка экрана отчета в подписке электронной почты
startDate	string (date-time)	Дата начала и время подписки электронной почты
subArtifactDisplayName	string	Имя страницы подписанного элемента Power BI, если это отчет.
title	string	Имя приложения
users	SubscriptionUser[]	Сведения о каждом подписчике электронной почты. При использовании вызова API получения подписок пользователей в качестве администратора возвращаемое значение является пустым массивом (null). Это свойство будет удалено из ответа полезных данных в предстоящем выпуске. Вы можете получить сведения о подписке в отчете Или панели мониторинга Power BI с помощью вызовов API получения подписок отчетов от имени администратора или получения подписок панели мониторинга в качестве вызовов API администрирования .

SubscriptionsByUserResponse

Object

Оболочка ответа OData для подписок Power BI для пользователя

Имя	Тип	Описание
@odata.context	string
continuationToken	string	Маркер для получения следующего блока результирующий набор
continuationUri	string	Универсальный код ресурса (URI) для следующего блока в результирующем наборе
subscriptionEntities	Subscription[]	Подписки для пользователя

SubscriptionUser

Object

Пользователь подписки на электронную почту Power BI

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