Использование REST API Power BI

Статья
05.02.2025

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 и разрешает доступ к REST API 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 (слишком много запросов) с заголовком HTTP Retry-After в ответе, указывая, сколько секунд вызову приложению придется ждать, прежде чем выполнять новый запрос.

Скачивание между географическими регионами

Операции, связанные с скачиванием файлов в другом регионе, отличном от региона, в котором был выполнен вызов, может занять больше времени, чем ожидалось.

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

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

Примечание

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

Группа операций	Описание
администратора	Операции для работы с административными задачами.
приложения	Операции для работы с приложениями.
доступные функции	Операции, возвращающие доступные функции.
емкости	Операции для работы с емкостями.
панели мониторинга	Операции для работы с панелями мониторинга.
учетные записи хранения потоков данных	Операции для работы с учетными записями хранения потоков данных.
потоки данных	Операции для работы с потоками данных.
наборы данных	Операции для работы с наборами данных.
токена внедрения	Операции для работы с маркерами внедрения.
шлюзов	Операции для работы с шлюзами.
группы	Операции для работы с группами.
Импорт	Операции для работы с импортом.
конвейеры	Операции для работы с конвейерами развертывания.
push-наборы данных	Операции для работы с push-наборами данных.
Отчеты	Операции для работы с отчетами.
приложения шаблонов	Операции для работы с приложениями-шаблонами.
пользователи	Операции для работы с пользователями.