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 :
Ouvrez votre application dans Azure.
À gauche, sous Gérer, sélectionnez autorisations d’API.
Sélectionnez Ajouter une autorisation.
Dans la fenêtre Demander des autorisations d’API, sélectionnez service Power BI.
Sélectionnez autorisations déléguées. Une liste d’API s’affiche.
Développez l’API à laquelle vous souhaitez ajouter des autorisations, puis sélectionnez les autorisations à y ajouter.
Sélectionnez Ajouter des autorisations.
Suppression d’étendues
Pour supprimer des autorisations de votre application Azure AD, procédez comme suit :
Ouvrez votre application dans Azure.
À gauche, sous Gérer, sélectionnez autorisations d’API.
Sélectionnez le menu contextuel (points de suspension d’autorisation).
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. |