Risolvere i problemi relativi alle API REST di Power BI

Risolvere gli errori 401 nelle chiamate API REST Power BI

Potrebbe essere necessaria un'acquisizione di Fiddler per approfondire le indagini. L'applicazione registrata in Microsoft Entra ID potrebbe non avere l'ambito di autorizzazione richiesto. Verificare che l'ambito richiesto sia presente nella registrazione dell'app per Microsoft Entra ID nel portale di Azure.

Il service principal restituisce 401 durante la chiamata alle API di amministrazione

Quando un'entità servizio chiama Power BI API REST di amministrazione, la chiamata potrebbe restituire HTTP 401 Non autorizzato anche se l'entità servizio esegue correttamente l'autenticazione e acquisisce un token. Questo problema riguarda sia le chiamate API REST dirette che i cmdlet di PowerShell, tra cui:

Un tipico errore di PowerShell è simile al seguente:

Get-PowerBIWorkspace : Operation returned an invalid status code Unauthorized

Una risposta 401 in questo scenario indica in genere un gap di configurazione del tenant o della registrazione dell'app anziché un errore di autenticazione. Eseguire i controlli seguenti nell'ordine:

  1. Verificare che le impostazioni del tenant pertinenti siano abilitate. Nel portale di amministrazione di Microsoft Fabric verificare che Consenti alle entità servizio di usare le API di amministrazione di sola lettura Power BI sia abilitata per le API di amministrazione o che Consenti alle entità servizio di usare le API Power BI sia abilitata per le API utente. Queste due impostazioni sono separate a livello di tenant. Una chiamata API amministratore ha esito negativo con 401 se si abilita solo l'impostazione dell'API utente. Per ulteriori informazioni, vedere Abilitare l'autenticazione del principale del servizio per le API di amministrazione.
  2. Confermare che l'entità servizio sia nel gruppo di sicurezza nell'ambito specificato. Ogni impostazione del tenant si applica a uno o più gruppi di sicurezza Microsoft Entra. Verificare che l'entità servizio sia membro del gruppo di sicurezza a cui fa riferimento l'impostazione. Per altre informazioni, vedere Registrare un'applicazione Microsoft Entra.
  3. Verificare che il token OAuth usi la risorsa corretta. Quando si richiede il token di accesso, il valore della risorsa (gruppo di destinatari) deve essere https://analysis.windows.net/powerbi/api per il cloud globale. Power BI rifiuta i token emessi per una risorsa diversa, ad esempio Microsoft Graph, con un valore 401.
  4. Controllare le autorizzazioni di registrazione dell'app. Verificare che la registrazione dell'app disponga delle autorizzazioni dell'applicazione richieste dall'API amministratore specifica e che un amministratore Microsoft Entra abbia concesso il consenso amministratore. Non combinare autorizzazioni delegate e autorizzazioni applicative nella stessa registrazione dell'app: usa le une o le altre in base al flusso di autenticazione.
  5. Convalida i parametri degli eventi di attività. Quando si chiama l'API REST Get Activity Events , i startDateTime parametri e endDateTime devono essere in formato ISO 8601 UTC, 2026-06-30T00:00:00Zad esempio . Un timestamp non formattato può causare un errore 401.

Risolvere gli errori 403 nelle chiamate API REST Power BI

Un errore 403 può verificarsi per uno dei motivi seguenti. Potrebbe essere necessaria un'acquisizione di Fiddler per approfondire le indagini.

  • Hai superato il numero di token di incorporamento che è possibile generare in una capacità condivisa. Per generare token di incorporamento, acquistare capacità di Azure e assegnare l'area di lavoro a tale capacità. Vedere Creare una capacità Power BI Embedded nel portale di Azure.
  • Token di autorizzazione Microsoft Entra scaduto.
  • L'utente autenticato non è un membro del gruppo (area di lavoro).
  • L'utente autenticato non è un amministratore del gruppo (area di lavoro).
  • L'utente autenticato non dispone delle autorizzazioni. Aggiornare le autorizzazioni usando l'API refreshUserPermissions.
  • L'intestazione dell'autorizzazione potrebbe non essere elencata correttamente. Assicurarsi che non ci siano errori di digitazioni.

Il back-end dell'applicazione potrebbe dover aggiornare il token di autorizzazione prima di chiamare GenerateToken. Per altre informazioni, vedere Aggiornare il token di accesso.

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

Correggere le eccezioni di timeout quando si usano le API di importazione ed esportazione

Quando si invia una richiesta api REST Power BI, potrebbe arrivare a un cluster che non contiene i dati del tenant. In tal caso, il reindirizzamento della richiesta potrebbe non riuscire a causa di un timeout.

Per correggere l'eccezione di timeout, inviare nuovamente la richiesta con il preferClientRouting parametro di query URL impostato su true. Se la richiesta arriva al cluster errato, il servizio Power BI restituisce una risposta HTTP di reindirizzamento temporaneo 307. In questi casi, è necessario reindirizzare la richiesta al nuovo indirizzo specificato nell'intestazione percorso HTTPS della risposta.

L'API di aggiornamento dei parametri o delle origini dati non riesce dopo alcuni minuti

L'errore generico seguente viene talvolta restituito nell'intestazione della risposta:

HTTP/1.1 500 Internal Server Error

An error has occurred

Quando si usano le API Datasets - Update Parameters In Group o Datasets - Update Datasources In Group, questo errore potrebbe indicare che si sta aggiornando un set di dati di grandi dimensioni che non usa il formato per set di dati di grandi dimensioni. Usare il formato del set di dati di grandi dimensioni per evitare l'errore.

Contenuti correlati

Domande frequenti su Power BI Embedded

Altre domande? Chiedi alla Comunità di Power BI

  • Last updated on