Partager via


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

Note

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

  • Lorsque vous accédez à l’API REST Power BI, votre contenu de demande et de réponse et vos données peuvent être traités par des centres de données dans des régions autres que la région d’accueil 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 la 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 la plateforme d’identités Microsoft (v2.0) ?

Pour plus d’informations sur les autorisations d’accès 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. Lorsque vous utilisez 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 du 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 d’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 à 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 d’API.

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

  4. Sélectionnez Supprimer l’autorisation.

Strangulation

Power BI utilise la limitation pour maintenir des performances et une fiabilité optimales. Pour empêcher l’utilisation excessive des ressources 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 requêtes qui dépassent une limite prédéterminée pendant une fenêtre de temps, Power BI limite les demandes supplémentaires de cet utilisateur pendant une courte période.

Lorsque les applications rencontrent une limitation, Power BI retourne un code d’état HTTP 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.

Téléchargement dans les régions géographiques

Les opérations qui impliquent le téléchargement de fichiers dans une région différente de la région où l’appel a été exécuté peuvent prendre plus de temps que prévu.

Groupes d’opérations REST

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

Note

Pour gérer capacités de Power BI Embedded, utilisez les API REST Power BI Embedded Azure Resource Manager.

Groupe d’opérations Description
d’administration Opérations d’utilisation des tâches administratives.
Apps Opérations d’utilisation d’applications.
fonctionnalités disponibles Opérations qui retournent les fonctionnalités disponibles.
capacités Opérations d’utilisation des capacités.
tableaux de bord Opérations d’utilisation de tableaux de bord.
comptes de stockage dataflow Opérations d’utilisation des comptes de stockage de flux de données.
dataflows Opérations d’utilisation de dataflows.
jeux de données Opérations d’utilisation de jeux de données.
incorporer des de jetons Opérations d’utilisation de jetons incorporés.
passerelles Opérations d’utilisation des passerelles.
groupes Opérations d’utilisation de groupes.
Importations Opérations d’utilisation des importations.
pipelines Opérations d’utilisation des pipelines de déploiement.
les jeux de données Push Opérations d’utilisation de jeux de données Push.
rapports Opérations d’utilisation des rapports.
modèles d’applications Opérations d’utilisation des applications modèles.
Utilisateurs Opérations d’utilisation des utilisateurs.

Étapes suivantes

Playground

documentation d’analytique incorporée Power BI

sdk .NET