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

É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.

Étapes suivantes