Mit den Power BI-REST-APIs
Die Power BI-REST-APIs bieten Dienstendpunkte für Einbettung, Verwaltung, Governance und Benutzerressourcen.
Mit Power BI-REST-APIs können Sie die folgenden Schritte ausführen:
Verwalten von Power BI-Inhalten
Ausführen von Administratorvorgängen
Einbetten von Power BI-Inhalten
Hinweis
Einige der Power BI-APIs beziehen sich auf Arbeitsbereiche als Gruppen. Jeder Verweis auf Gruppen bedeutet, dass Sie mit Arbeitsbereichen arbeiten.
Beim Zugriff auf die Power BI-REST-API werden Ihre Anforderungs- und Antwortinhalte und -daten möglicherweise von Rechenzentren in anderen Regionen als der Basisregion Ihres Power BI-Mandanten verarbeitet.
Bereiche
Um die Power BI-REST-APIs verwenden zu können, müssen Sie eine Azure Active Directory-Anwendung (Azure AD) in Azure registrieren. Die Azure AD-App stellt Berechtigungen für Power BI-REST-Ressourcen bereit und ermöglicht den Zugriff auf die Power BI-REST-APIs. Informationen zum Registrieren einer App finden Sie unter Registrieren einer Azure AD-Anwendung für die Verwendung mit Power BI.
Nach der Registrierung einer Azure AD-App können Sie sich mithilfe von Azure AD (v1.0; ADAL) oder die Microsoft Identity Platform (v2.0; MSAL)-Endpunkte. Weitere Informationen zur Funktionsweise dieser Authentifizierungsmethoden finden Sie unter Why update to Microsoft Identity Platform (v2.0)?
Weitere Informationen zu Power BI-Zugriffsberechtigungen finden Sie unter Berechtigungen und Zustimmung im Microsoft Identity Platform-Endpunkt.
Verwenden eines Dienstprinzipals
Bereiche sind nicht erforderlich, wenn Sie einen Dienstprinzipal verwenden. Sobald Sie einen Dienstprinzipal für die Verwendung mit Power BI aktiviert haben, werden die AD-Berechtigungen der Anwendung nicht mehr wirksam. Bei Verwendung eines Dienstprinzipals werden die Berechtigungen der Anwendung über das Power BI-Verwaltungsportal verwaltet. Weitere Informationen finden Sie unter Aktivieren der Power BI-Dienst-Administratoreinstellungen.
Hinzufügen von Bereichen
Führen Sie die folgenden Schritte aus, um Ihrer Azure AD-App Berechtigungen hinzuzufügen:
Öffnen Sie Ihre App in Azure.
Wählen Sie links unter Verwaltendie Option API-Berechtigungen aus.
Wählen Sie Berechtigung hinzufügen aus.
Wählen Sie im Fenster API-Berechtigungen anforderndie Option Power BI-Dienst aus.
Wählen Sie Delegierte Berechtigungen aus. Eine Liste von APIs wird angezeigt.
Erweitern Sie die API, der Sie Berechtigungen hinzufügen möchten, und wählen Sie die Berechtigungen aus, die Sie ihr hinzufügen möchten.
Wählen Sie Berechtigungen hinzufügen aus.
Entfernen von Bereichen
Führen Sie die folgenden Schritte aus, um Berechtigungen aus Ihrer Azure AD-App zu entfernen:
Öffnen Sie Ihre App in Azure.
Wählen Sie links unter Verwaltendie Option API-Berechtigungen aus.
Wählen Sie das Kontextmenü (Berechtigungspunkte) aus.
Klicken Sie auf Berechtigung entfernen.
Drosselung
Power BI nutzt die Drosselung, um eine optimale Leistung und Zuverlässigkeit zu gewährleisten. Um eine übermäßige Nutzung von Ressourcen durch einzelne Benutzer zu verhindern, schränkt Power BI die Anzahl der API-Aufrufe innerhalb eines Zeitfensters pro Benutzer ein.
Wenn ein Benutzer während eines Zeitfensters eine Anzahl von Anforderungen sendet, die ein vordefiniertes Limit überschreitet, drosselt Power BI alle weiteren Anforderungen dieses Benutzers für einen kurzen Zeitraum.
Wenn anwendungen eine Einschränkung erfahren, gibt Power BI einen HTTP-status Code 429 (Zu viele Anforderungen) mit einem Retry-After HTTP-Header in der Antwort zurück, der angibt, wie viele Sekunden die aufrufende Anwendung warten muss, bevor eine neue Anforderung gestellt wird.
REST-Vorgangsgruppen
In dieser Tabelle sind die Power BI-REST-API-Vorgangsgruppen aufgeführt.
Hinweis
Verwenden Sie zum Verwalten Power BI Embedded Kapazitäten die Power BI Embedded Azure Resource Manager REST-APIs.
| Vorgangsgruppe | BESCHREIBUNG |
|---|---|
| Administrator | Vorgänge zum Arbeiten mit administrativen Aufgaben. |
| Apps | Vorgänge für das Arbeiten mit Apps. |
| Verfügbare Features | Vorgänge, die verfügbare Features zurückgeben. |
| Kapazitäten | Vorgänge für das Arbeiten mit Kapazitäten. |
| Dashboards | Vorgänge für das Arbeiten mit Dashboards. |
| Dataflow-Speicherkonten | Vorgänge für das Arbeiten mit Speicherkonten für Dataflows. |
| Dataflows | Vorgänge für das Arbeiten mit Dataflows. |
| Datasets | Vorgänge für das Arbeiten mit Datasets. |
| Einbettungstoken | Vorgänge für das Arbeiten mit Einbettungstoken. |
| Gateways | Vorgänge für das Arbeiten mit Gateways. |
| Gruppen | Vorgänge für das Arbeiten mit Gruppen. |
| Importe | Vorgänge für das Arbeiten mit Importen. |
| Pipelines | Vorgänge zum Arbeiten mit Bereitstellungspipelines. |
| Pushdatasets | Vorgänge für das Arbeiten mit Pushdatasets. |
| Berichte | Vorgänge für das Arbeiten mit Berichten. |
| Vorlagen-Apps | Vorgänge für das Arbeiten mit Vorlagen-Apps. |
| Benutzer | Vorgänge für das Arbeiten mit Benutzern. |