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:

  1. Öffnen Sie Ihre App in Azure.

  2. Wählen Sie links unter Verwaltendie Option API-Berechtigungen aus.

  3. Wählen Sie Berechtigung hinzufügen aus.

  4. Wählen Sie im Fenster API-Berechtigungen anforderndie Option Power BI-Dienst aus.

  5. Wählen Sie Delegierte Berechtigungen aus. Eine Liste von APIs wird angezeigt.

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

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

  1. Öffnen Sie Ihre App in Azure.

  2. Wählen Sie links unter Verwaltendie Option API-Berechtigungen aus.

  3. Wählen Sie das Kontextmenü (Berechtigungspunkte) aus.

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

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.

Nächste Schritte