с помощью интерфейсов 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, выполните следующие действия.
Откройте приложение в Azure.
Слева в разделе "Управление" выберите разрешения API.
Выберите Добавить разрешение.
В окне разрешений API запроса выберите службу Power BI.
Нажмите Делегированные разрешения. Отобразится список API.
Разверните API, к которому вы хотите добавить разрешения, и выберите разрешения, к которым вы хотите добавить.
Выберите Добавить разрешения.
Удаление областей
Чтобы удалить разрешения из приложения Azure AD, выполните следующие действия.
Откройте приложение в Azure.
Слева в разделе "Управление" выберите разрешения API.
Выберите контекстное меню (многоточие разрешений).
Выберите Удалить разрешение.
Группы операций REST
В этой таблице перечислены группы операций REST API Power BI.
Примечание
Для управления емкостями Power BI Embedded используйте Power BI Embedded REST API Azure Resource Manager.
| Группа операций | Описание |
|---|---|
| Администратор | Операции для работы с задачами администрирования. |
| Приложения | Операции для работы с приложениями. |
| Доступные компоненты | Операции, возвращающие доступные компоненты. |
| Производительность | Операции для работы с емкостями. |
| Панели мониторинга | Операции для работы с панелями мониторинга. |
| Учетные записи хранения потоков данных | Операции для работы с учетными записями хранения потоков данных. |
| Потоки данных | Операции для работы с потоками данных. |
| Наборы данных | Операции для работы с наборами данных. |
| Токен внедрения | Операции для работы с токенами внедрения. |
| Шлюзы | Операции для работы со шлюзами. |
| Группы | Операции для работы с группами |
| Imports | Операции для работы с импортом. |
| Конвейеры | Операции для работы с конвейерами развертывания. |
| Наборы данных для принудительной отправки | Операции для работы с наборами данных для принудительной отправки. |
| Отчеты | Операции для работы с отчетами. |
| Приложения-шаблоны | Операции для работы с приложениями-шаблонами. |
| Пользователи | Операции для работы с пользователями. |