Share via


Problembehandlung für REST-APIs

API-Aufruf gibt 401 zurück

Für eine genauere Untersuchung muss möglicherweise eine Fiddler-Überwachung ausgeführt werden. Möglicherweise fehlt der erforderliche Berechtigungsbereich für die registrierte Anwendung in Microsoft Entra ID. Stellen Sie sicher, dass der erforderliche Bereich innerhalb der App-Registrierung für Microsoft Entra ID im Azure-Portal vorhanden ist.

API-Aufruf gibt 403 zurück

Der Fehler 403 kann aus folgenden Gründen auftreten. Für eine genauere Untersuchung muss möglicherweise eine Fiddler-Überwachung ausgeführt werden.

  • Der Benutzer hat die Anzahl von Einbettungstoken überschritten, die mit einer gemeinsam genutzten Kapazität generiert werden können. Erwerben Sie weitere Azure-Kapazitäten, und weisen Sie den Arbeitsbereich dieser Kapazität zu, um weitere Einbettungstoken generieren zu können. Weitere Informationen finden Sie unter Einrichten von Power BI Embedded-Kapazität im Azure-Portal.
  • Das Microsoft Entra-Autorisierungstoken ist abgelaufen.
  • Der authentifizierte Benutzer ist kein Mitglied der Gruppe (Arbeitsbereich).
  • Der authentifizierte Benutzer ist kein Administrator der Gruppe (Arbeitsbereich).
  • Der authentifizierte Benutzer verfügt über keine Berechtigungen. Berechtigungen können mit der refreshUserPermissions-API aktualisiert werden.
  • Der Autorisierungsheader wird möglicherweise nicht ordnungsgemäß aufgeführt. Stellen Sie sicher, dass keine Rechtschreibfehler enthalten sind.

Das Back-End der Anwendung muss das Auth-Token möglicherweise vor dem Aufrufen von GenerateToken aktualisieren. Weitere Informationen finden Sie unter Zugriffstoken aktualisieren.

GET https://wabi-us-north-central-redirect.analysis.windows.net/metadata/cluster HTTP/1.1
Host: wabi-us-north-central-redirect.analysis.windows.net
...
Authorization: Bearer eyJ0eXAiOi...
...

HTTP/1.1 403 Forbidden
...

{"error":{"code":"TokenExpired","message":"Access token has expired, resubmit with a new access token"}}

Beheben von Timeoutausnahmen bei Verwendung von Import- und Export-APIs

Wenn Sie eine Power BI-REST-API-Anforderung senden, kann sie in einem Cluster eintreffen, der nicht die Daten Ihres Mandanten enthält. In diesem Fall kann das Umleiten der Anforderung aufgrund eines Timeouts fehlschlagen.

Zum Beheben der Timeoutausnahme senden Sie die Anforderung erneut mit auf true festgelegtem Parameter für die URL-Abfrage preferClientRouting. Wenn Ihre Anforderung im falschen Cluster eintrifft, gibt der Power BI-Dienst HTTP-Antwort 307 Temporäre Umleitung zurück. In solchen Fällen müssen Sie Ihre Anforderung an die neue Adresse umleiten, die im HTTPS-Adressheader der Antwort angegeben ist.

Die API für Updateparameter oder -Datenquellen schlägt nach einigen Minuten fehl.

Der folgende generische Fehler wird manchmal im Antwortheader zurückgegeben:

HTTP/1.1 500 Internal Server Error

An error has occurred

Bei Verwendung von Datasets – Aktualisieren von Parametern in gruppe oder Datasets – Aktualisieren von Datenquellen in Gruppen-APIs weist dieser Fehler möglicherweise darauf hin, dass Sie ein großes Dataset aktualisieren, das nicht das große Datasetformat verwendet. Verwenden Sie das große Datasetformat, um den Fehler zu vermeiden.

Weitere Fragen? Fragen an die Power BI-Community