Поделиться через


с помощью интерфейсов 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. Выберите Удалить разрешение.

Регулирование

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 Операции для работы с импортом.
Конвейеры Операции для работы с конвейерами развертывания.
Наборы данных для принудительной отправки Операции для работы с наборами данных для принудительной отправки.
Отчеты Операции для работы с отчетами.
Приложения-шаблоны Операции для работы с приложениями-шаблонами.
Пользователи Операции для работы с пользователями.

Дальнейшие действия