Utilisation des API REST Power BI

Les API REST Power BI fournissent des points de terminaison de service pour l’incorporation, l’administration, la gouvernance et les ressources utilisateur.

Avec les API REST Power BI, vous pouvez effectuer les opérations suivantes :

  • Gérer le contenu Power BI

  • Effectuer des opérations d’administration

  • Incorporer du contenu Power BI

Notes

  • Certaines API Power BI font référence aux espaces de travail en tant que groupes. Toute référence à des groupes signifie que vous travaillez avec des espaces de travail.

  • Lors de l’accès à l’API REST Power BI, le contenu et les données de votre demande et réponse peuvent être traités par des centres de données situés dans des régions autres que la région d’origine de votre locataire Power BI.

Étendues

Pour utiliser les API REST Power BI, vous devez inscrire une application Azure Active Directory (Azure AD) dans Azure. L’application Azure AD établit des autorisations pour les ressources REST Power BI et autorise l’accès aux API REST Power BI. Pour savoir comment inscrire une application, consultez Inscrire une application Azure AD à utiliser avec Power BI.

Après avoir inscrit une application Azure AD, vous pouvez vous authentifier auprès de celle-ci à l’aide d’Azure AD (v1.0 ; ADAL) ou le Plateforme d'identités Microsoft (v2.0 ; Points de terminaison MSAL). Pour en savoir plus sur le fonctionnement de ces méthodes d’authentification, consultez Pourquoi mettre à jour vers Plateforme d'identités Microsoft (v2.0) ?

Pour plus d’informations sur les autorisations d’accès de Power BI, consultez Autorisations et consentement dans le point de terminaison de la plateforme d’identités Microsoft.

Utilisation d’un principal de service

Les étendues ne sont pas requises si vous utilisez un principal de service. Une fois que vous avez activé l’utilisation d’un principal de service avec Power BI, les autorisations AD de l’application ne prennent plus effet. Lors de l’utilisation d’un principal de service, les autorisations de l’application sont gérées via le portail d’administration Power BI. Pour plus d’informations, consultez Activer les paramètres d’administration service Power BI.

Ajout d’étendues

Pour ajouter des autorisations à votre application Azure AD, procédez comme suit :

  1. Ouvrez votre application dans Azure.

  2. À gauche, sous Gérer, sélectionnez Autorisations de l’API.

  3. Sélectionnez Ajouter une autorisation.

  4. Dans la fenêtre Demander des autorisations d’API , sélectionnez Service Power BI.

  5. Sélectionnez Autorisations déléguées. Une liste d’API s’affiche.

  6. Développez l’API à laquelle vous souhaitez ajouter des autorisations, puis sélectionnez les autorisations que vous souhaitez y ajouter.

  7. Sélectionnez Ajouter des autorisations.

Suppression d’étendues

Pour supprimer des autorisations de votre application Azure AD, procédez comme suit :

  1. Ouvrez votre application dans Azure.

  2. À gauche, sous Gérer, sélectionnez Autorisations de l’API.

  3. Sélectionnez le menu contextuel (points de suspension d’autorisation).

  4. Sélectionnez Supprimer l’autorisation.

Limitation

Power BI utilise la limitation pour maintenir des performances et une fiabilité optimales. Pour éviter la surutilisation des ressources provenant d’utilisateurs uniques, Power BI limite le nombre d’appels d’API dans une fenêtre de temps par utilisateur.

Lorsqu’un utilisateur envoie un certain nombre de demandes qui dépassent une limite prédéterminée pendant une fenêtre de temps, Power BI limite toutes les demandes supplémentaires de cet utilisateur pendant une courte période.

Lorsque les applications rencontrent une limitation, Power BI retourne un code HTTP status 429 (Trop de requêtes) avec un en-tête HTTP Retry-After dans la réponse, indiquant le nombre de secondes pendant lesquelles l’application appelante doit attendre avant d’effectuer une nouvelle requête.

Groupes d’opérations REST

Ce tableau répertorie les groupes d’opérations de l’API REST Power BI.

Groupe d’opérations Description
Administrateur Opérations pour l’utilisation des tâches administratives.
Applications Opérations pour l’utilisation des applications.
Fonctionnalités disponibles Opérations qui retournent les fonctionnalités disponibles.
Capacités Opérations pour l’utilisation des capacités.
Tableaux de bord Opérations pour l’utilisation des tableaux de bord.
Comptes de stockage de dataflows Opérations pour l’utilisation des comptes de stockage de dataflows.
Dataflows Opérations pour l’utilisation des dataflows.
Jeux de données Opérations pour l’utilisation des jeux de données.
Jeton d’incorporation Opérations pour l’utilisation des jetons d’incorporation.
Passerelles Opérations pour l’utilisation des passerelles.
Groupes Opérations pour l’utilisation des groupes.
Importations Opérations pour l’utilisation des importations.
Pipelines Opérations d’utilisation des pipelines de déploiement.
Jeux de données push Opérations pour l’utilisation des jeux de données push.
Rapports Opérations pour l’utilisation des rapports.
Applications modèles Opérations pour l’utilisation des applications modèles.
Utilisateurs Opérations pour l’utilisation des utilisateurs.

Étapes suivantes