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