с помощью интерфейсов REST API для Power BI;

REST API Power BI предоставляют конечные точки службы для внедрения, администрирования, управления и пользовательских ресурсов.

С помощью REST API Power BI можно выполнить следующие действия:

  • Управление содержимым Power BI

  • Выполнение операций администратора

  • Внедрение содержимого Power BI

Примечание

  • Некоторые API Power BI относятся к рабочим областям как группам. Любая ссылка на группы означает, что вы работаете с рабочими областями.

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

Области действия

Чтобы использовать REST API Power BI, необходимо зарегистрировать приложение Azure Active Directory (Azure AD) в Azure. Приложение Azure AD задает разрешения ресурсам REST Power BI, а также предоставляет доступ к API-интерфейсам REST Power BI. Сведения о регистрации приложения см. в статье "Регистрация приложения Azure AD для использования с Power BI".

После регистрации приложения Azure AD его можно пройти проверку подлинности с помощью Azure AD (версия 1.0; ADAL) или платформа удостоверений Майкрософт (версия 2.0; Конечные точки MSAL. Дополнительные сведения о том, как работают эти методы проверки подлинности, см. в статье "Зачем обновлять платформа удостоверений Майкрософт (версия 2.0)?

Дополнительные сведения о разрешениях на доступ к Power BI см. в статье Разрешения и согласие для конечной точки платформы удостоверений Майкрософт.

Использование субъекта-службы

Области не требуются, если вы используете субъект-службу. После включения субъекта-службы для использования с Power BI разрешения AD приложения больше не вступают в силу. При использовании субъекта-службы разрешения приложения управляются с помощью портала администрирования Power BI. Дополнительные сведения см. в разделе "Включение параметров администратора служба Power BI".

Добавление областей

Чтобы добавить разрешения в приложение Azure AD, выполните следующие действия.

  1. Откройте приложение в Azure.

  2. Слева в разделе "Управление" выберите разрешения API.

  3. Выберите Добавить разрешение.

  4. В окне разрешений API запроса выберите службу Power BI.

  5. Нажмите Делегированные разрешения. Отобразится список API.

  6. Разверните API, к которому вы хотите добавить разрешения, и выберите разрешения, к которым вы хотите добавить.

  7. Выберите Добавить разрешения.

Удаление областей

Чтобы удалить разрешения из приложения Azure AD, выполните следующие действия.

  1. Откройте приложение в Azure.

  2. Слева в разделе "Управление" выберите разрешения API.

  3. Выберите контекстное меню (многоточие разрешений).

  4. Выберите Удалить разрешение.

Группы операций REST

В этой таблице перечислены группы операций REST API Power BI.

Примечание

Для управления емкостями Power BI Embedded используйте Power BI Embedded REST API Azure Resource Manager.

Группа операций Описание
Администратор Операции для работы с задачами администрирования.
Приложения Операции для работы с приложениями.
Доступные компоненты Операции, возвращающие доступные компоненты.
Производительность Операции для работы с емкостями.
Панели мониторинга Операции для работы с панелями мониторинга.
Учетные записи хранения потоков данных Операции для работы с учетными записями хранения потоков данных.
Потоки данных Операции для работы с потоками данных.
Наборы данных Операции для работы с наборами данных.
Токен внедрения Операции для работы с токенами внедрения.
Шлюзы Операции для работы со шлюзами.
Группы Операции для работы с группами
Imports Операции для работы с импортом.
Конвейеры Операции для работы с конвейерами развертывания.
Наборы данных для принудительной отправки Операции для работы с наборами данных для принудительной отправки.
Отчеты Операции для работы с отчетами.
Приложения-шаблоны Операции для работы с приложениями-шаблонами.
Пользователи Операции для работы с пользователями.

Следующие шаги