Admin - Dashboards GetDashboardsAsAdmin

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

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

Возвращает список панелей мониторинга для организации.

Разрешения

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

При выполнении в рамках проверки подлинности службы приложения не должны иметь необходимые разрешения администратора для Power BI, заданные на портале Azure.

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

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

Важно только при проверке подлинности через стандартный делегированный маркер доступа администратора. Не должно присутствовать при использовании проверки подлинности через субъект-службу.

Ограничения

Максимум 50 запросов в час или 5 запросов в минуту для каждого клиента.

GET https://api.powerbi.com/v1.0/myorg/admin/dashboards

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

GET https://api.powerbi.com/v1.0/myorg/admin/dashboards?$expand={$expand}&$filter={$filter}&$top={$top}&$skip={$skip}

Параметры URI

Имя	В	Тип	Описание
$expand	query	string	Принимает разделенный запятыми список типов данных, который будет развернут встроенным в ответе. Поддерживает `tiles`.
$filter	query	string	Возвращает подмножество результатов на основе условия параметра запроса Odata Odata фильтра.
$skip	query	integer (int32)	Пропускает первые результаты n
$top	query	integer (int32)	Возвращает только первые результаты n

Ответы

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

Примеры

Example

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

GET https://api.powerbi.com/v1.0/myorg/admin/dashboards

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

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

{
  "value": [
    {
      "id": "69ffaa6c-b36d-4d01-96f5-1ed67c64d4af",
      "displayName": "SalesMarketing",
      "embedUrl": "https://app.powerbi.com/dashboardEmbed?dashboardId=69ffaa6c-b36d-4d01-96f5-1ed67c64d4af",
      "isReadOnly": false,
      "workspaceId": "abfbdc89-2659-43c1-9142-93e8378eac96"
    }
  ]
}

Определения

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

AdminDashboard

Object

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

Имя	Тип	Описание
appId	string	Идентификатор приложения, возвращенный только в том случае, если панель мониторинга принадлежит приложению
displayName	string	Отображаемое имя панели мониторинга
embedUrl	string	URL-адрес внедрения панели мониторинга
id	string (uuid)	Идентификатор панели мониторинга
isReadOnly	boolean	Является ли панель мониторинга доступной только для чтения
subscriptions	Subscription[]	(Пустое значение) Сведения о подписке для элемента Power BI (например, отчета или панели мониторинга). Это свойство будет удалено из ответа полезных данных в предстоящем выпуске. Сведения о подписке для отчета Power BI можно получить с помощью вызова API получения подписок отчета в качестве администратора API.
tiles	AdminTile[]	Плитки, принадлежащие панели мониторинга
users	DashboardUser[]	(Пустое значение) Сведения о доступе пользователя к панели мониторинга. Это свойство будет удалено из ответа полезных данных в предстоящем выпуске. Вы можете получить сведения о пользователях на панели мониторинга Power BI с помощью вызова API получения пользователей панели мониторинга в качестве администратора или вызова API PostWorkspaceInfo с параметром `getArtifactUsers`.
webUrl	string	URL-адрес веб-панели мониторинга
workspaceId	string (uuid)	Идентификатор рабочей области (GUID) панели мониторинга. Это свойство будет возвращено только в GetDashboardsAsAdmin.