Condividi tramite

Risolvere i problemi delle API REST

  • Articolo

La chiamata API restituisce 401

Potrebbe essere necessaria un'acquisizione Fiddler per ulteriori indagini. È possibile che manchi l'ambito di autorizzazioni necessarie per l'applicazione registrata in Microsoft Entra ID. Verificare che l'ambito necessario sia presente nella registrazione dell'app per Microsoft Entra ID nel portale di Azure.

La chiamata API restituisce 403

Le possibili cause di un errore 403 sono le seguenti. Potrebbe essere necessaria un'acquisizione Fiddler per ulteriori indagini.

  • L'utente ha superato la quantità di token di incorporamento che può essere generata in una capacità condivisa. Acquistare capacità di Azure per generare token di incorporamento e assegnare l'area di lavoro a tale capacità. Vedere Creare la capacità di Power BI Embedded nel portale di Azure.
  • Token di autorizzazione di 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. Le autorizzazioni possono essere aggiornate usando l'API refreshUserPermissions.
  • L'intestazione dell'autorizzazione potrebbe non essere corretta. Assicurarsi che non siano presenti errori di ortografia.

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 di API REST di 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 parametro di query URL preferClientRouting impostato su true. Se la richiesta arriva al cluster errato, il servizio Power BI restituisce una risposta HTTP 307 Reindirizzamento temporaneo. In questi casi, è necessario reindirizzare la richiesta al nuovo indirizzo specificato nella risposta intestazione Percorso HTTPS.

L'API aggiorna parametri o origini dati ha esito negativo 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 Set di dati - Aggiornare i parametri nel gruppo o Set di dati - Aggiornare le origini dati nel gruppo, questo errore potrebbe indicare che si sta aggiornando un set di dati di grandi dimensioni che non usa il formato set di dati di grandi dimensioni. Usare il formato del set di dati di grandi dimensioni per evitare l'errore.

Contenuto correlato

Domande frequenti su Power BI Embedded

Altre domande? Inviare una domanda alla community di Power BI