Rozwiązywanie problemów z interfejsami REST API Power BI

Rozwiązywanie problemów z błędami 401 w wywołaniach interfejsu API REST Power BI

Może być konieczne zarejestrowanie śladu w programie Fiddler, aby przeprowadzić dalszą analizę. Zarejestrowana aplikacja w Microsoft Entra ID może nie mieć wymaganego zakresu uprawnień. Sprawdź, czy wymagany zakres znajduje się w rejestracji aplikacji dla Microsoft Entra ID w portalu Azure.

Jednostka usługi zwraca wartość 401 podczas wywoływania interfejsów API administratora

Gdy jednostka usługi wywołuje interfejsy API REST Power BI administratora, wywołanie może zwrócić błąd HTTP 401 Brak autoryzacji, mimo że jednostka usługi pomyślnie uwierzytelnia się i uzyskuje token. Ten problem dotyczy zarówno bezpośrednich wywołań interfejsu API REST, jak i poleceń cmdlet programu PowerShell, w tym:

• Pobieranie zdarzeń aktywności (GET /admin/activityevents)
• Pobierz grupy jako administrator (GET /admin/groups)
• Inne punkty końcowe w obszarze /admin/
• Polecenia cmdlet programu PowerShell, takie jak Get-PowerBIWorkspace -Scope Organization, Get-PowerBIActivityEventi Invoke-PowerBIRestMethod względem tras administracyjnych

Typowy błąd programu PowerShell wygląda następująco:

Get-PowerBIWorkspace : Operation returned an invalid status code Unauthorized

Odpowiedź 401 w tym scenariuszu zwykle wskazuje lukę w konfiguracji dzierżawy lub rejestracji aplikacji, a nie błąd uwierzytelniania. Wykonaj następujące kontrole w następującej kolejności:

1. Upewnij się, że odpowiednie ustawienia dzierżawcy są włączone. W portalu administracyjnym Microsoft Fabric sprawdź, czy opcja Zezwalaj jednostkom usługi na korzystanie z interfejsów API administratora Power BI tylko do odczytu jest włączona dla interfejsów API administratora, lub czy opcja Zezwalaj jednostkom usługi na korzystanie z interfejsów API Power BI jest włączona dla interfejsów API użytkowników. Te dwa ustawienia są oddzielnymi ustawieniami dzierżawy. Wywołanie interfejsu API administratora kończy się niepowodzeniem z błędem 401, jeśli włączysz tylko ustawienie interfejsu API użytkownika. Aby uzyskać więcej informacji, zobacz Włączanie uwierzytelniania jednostki usługi dla interfejsów API administratorów.
2. Upewnij się, że nazwa główna usługi należy do grupy zabezpieczeń o określonym zakresie. Każde ustawienie dzierżawy ma zastosowanie do jednej lub większej liczby grup zabezpieczeń Microsoft Entra. Sprawdź, czy nazwa główna usługi jest członkiem grupy zabezpieczeń wskazanej w tym ustawieniu. Aby uzyskać więcej informacji, zobacz Rejestrowanie aplikacji Microsoft Entra.
3. Upewnij się, że token OAuth używa odpowiedniego zasobu. Gdy żądasz tokenu dostępu, wartość zasobu (audience) dla chmury globalnej musi wynosić https://analysis.windows.net/powerbi/api. Power BI odrzuca tokeny wystawione dla innego zasobu — takiego jak Microsoft Graph — kodem 401.
4. Sprawdź uprawnienia rejestracji aplikacji. Upewnij się, że rejestracja aplikacji ma uprawnienia aplikacji wymagane przez określony interfejs API administratora oraz że administrator Microsoft Entra udzielił zgody administratora. Nie mieszaj uprawnień delegowanych i uprawnień aplikacji w ramach tej samej rejestracji aplikacji — użyj jednych albo drugich, w zależności od przepływu uwierzytelniania.
5. Weryfikowanie parametrów zdarzeń działania. Podczas wywoływania interfejsu API REST Get Activity Events parametry startDateTime i endDateTime muszą być w formacie ISO 8601 UTC — na przykład 2026-06-30T00:00:00Z. Nieprawidłowo sformatowany znacznik czasu może spowodować błąd 401.

Rozwiązywanie problemów z błędami 403 w wywołaniach interfejsu API REST Power BI

Błąd 403 może wystąpić z dowolnego z następujących powodów. Może być potrzebna rejestracja w programie Fiddler, aby przeprowadzić dalszą analizę.

• Przekroczono dozwoloną liczbę tokenów osadzonych, które można wygenerować w ramach pojemności współdzielonej. Aby wygenerować tokeny osadzania, kup pojemności platformy Azure i przypisz do nich obszar roboczy. Zobacz Tworzenie pojemności Power BI Embedded w portalu Azure.
• Token autoryzacji Microsoft Entra wygasł.
• Uwierzytelniony użytkownik nie jest członkiem grupy (obszaru roboczego).
• Uwierzytelniony użytkownik nie jest administratorem grupy (obszaru roboczego).
• Uwierzytelniony użytkownik nie ma uprawnień. Zaktualizuj uprawnienia przy użyciu interfejsu API refreshUserPermissions.
• Nagłówek autoryzacji może nie być wyświetlany poprawnie. Upewnij się, że nie ma literówek.

Zaplecze aplikacji może wymagać odświeżenia tokenu autoryzacji przed wywołaniem metody GenerateToken. Aby uzyskać więcej informacji, zobacz Odśwież token dostępu.

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"}}

Naprawianie wyjątków przekroczenia limitu czasu podczas używania interfejsów API importowania i eksportowania

Po wysłaniu żądania do interfejsu API REST Power BI może ono trafić do klastra, który nie zawiera danych Twojej dzierżawy. W takim przypadku przekierowanie żądania może zakończyć się niepowodzeniem z powodu przekroczenia limitu czasu.

Aby rozwiązać problem z wyjątkiem przekroczenia limitu czasu, wyślij ponownie żądanie z parametrem zapytania adresu URL ustawionym preferClientRouting na true. Jeśli żądanie zostanie dostarczone do nieprawidłowego klastra, usługa Power BI zwróci odpowiedź HTTP przekierowania tymczasowego 307. W takich przypadkach należy przekierować żądanie do nowego adresu określonego w nagłówku lokalizacji HTTPS odpowiedzi.

Parametry aktualizacji lub interfejs API aktualizacji źródeł danych kończą się błędem po kilku minutach

Następujący błąd ogólny jest czasami zwracany w nagłówku odpowiedzi:

HTTP/1.1 500 Internal Server Error

An error has occurred

Jeśli używasz interfejsów API Datasets - Update Parameters In Group lub Datasets - Update Datasources In Group, ten błąd może oznaczać, że aktualizujesz duży zestaw danych, który nie korzysta z formatu large dataset. Użyj dużego formatu zestawu danych, aby uniknąć błędu.

Treści powiązane

Power BI Embedded — często zadawane pytania

Więcej pytań? Zapytaj Społeczność usługi Power BI