Admin - Dashboards GetDashboardsAsAdmin

Ссылка

Service:: Power BI REST APIs

API Version:: v1.0

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

Разрешения

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

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

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

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

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

Ограничения

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

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

With optional parameters:

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	Фильтрует результаты на основе логического условия.
$skip	query	integer int32	Пропускает первые n результатов
$top	query	integer int32	Возвращает только первые n результатов

Ответы

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

Примеры

Example

Sample Request

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

Sample Response

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

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

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