Uso delle API REST di Power BI
Le API REST di Power BI forniscono endpoint di servizio per l'incorporamento, l'amministrazione, la governance e le risorse utente.
Con le API REST di Power BI è possibile eseguire le operazioni seguenti:
Gestire il contenuto di Power BI
Eseguire operazioni di amministrazione
Incorporare contenuto di Power BI
Nota
Alcune API di Power BI fanno riferimento alle aree di lavoro come gruppi. Qualsiasi riferimento ai gruppi significa che si lavora con le aree di lavoro.
Quando si accede all'API REST di Power BI, i dati e il contenuto delle richieste e delle risposte possono essere elaborati dai data center in aree diverse dall'area principale del tenant di Power BI.
Ambiti
Per usare le API REST di Power BI, è necessario registrare un'applicazione Azure Active Directory (Azure AD) in Azure. L'app Azure AD stabilisce le autorizzazioni per le risorse REST di Power BI e consente l'accesso alle API REST di Power BI. Per informazioni su come registrare un'app, vedere Registrare un'applicazione Azure AD da usare con Power BI.
Dopo aver registrato un'app Azure AD, è possibile eseguire l'autenticazione usando Azure AD (v1.0; ADAL) o Microsoft Identity Platform (v2.0; Endpoint MSAL). Per altre informazioni sul funzionamento di questi metodi di autenticazione, vedere Perché eseguire l'aggiornamento a Microsoft Identity Platform (v2.0)?
Per altre informazioni sulle autorizzazioni di accesso di Power BI, vedere Autorizzazioni e consenso nell'endpoint di Microsoft Identity Platform.
Uso di un'entità servizio
Gli ambiti non sono necessari se si usa un'entità servizio . Dopo aver abilitato un'entità servizio da usare con Power BI, le autorizzazioni di Active Directory dell'applicazione non diventano più effettive. Quando si usa un'entità servizio, le autorizzazioni dell'applicazione vengono gestite tramite il portale di amministrazione di Power BI. Per altre informazioni, vedere Abilitare le impostazioni di amministrazione del servizio Power BI.
Aggiunta di ambiti
Per aggiungere autorizzazioni all'app Azure AD, seguire questa procedura:
Aprire l'app in Azure.
A sinistra, in Gestisciselezionare autorizzazioni API .
Selezionare Aggiungi un'autorizzazione.
Nella finestra Richiedi autorizzazioni API selezionare servizio Power BI.
Selezionare Autorizzazioni delegate. Viene visualizzato un elenco di API.
Espandere l'API a cui si vogliono aggiungere le autorizzazioni e selezionare le autorizzazioni da aggiungere.
Selezionare Aggiungi autorizzazioni.
Rimozione di ambiti
Per rimuovere un'autorizzazione dall'app Azure AD, seguire questa procedura:
Aprire l'app in Azure.
A sinistra, in Gestisciselezionare autorizzazioni API .
Selezionare il menu di scelta rapida (puntini di sospensione delle autorizzazioni).
Selezionare Rimuovi autorizzazione.
Strozzatura
Power BI usa la limitazione per mantenere prestazioni e affidabilità ottimali. Per evitare l'uso eccessivo delle risorse da singoli utenti, Power BI limita il numero di chiamate API in un intervallo di tempo per utente.
Quando un utente invia un numero di richieste che superano un limite predeterminato durante un intervallo di tempo, Power BI limita eventuali richieste aggiuntive da tale utente per un breve periodo.
Quando le applicazioni riscontrano limitazioni, Power BI restituisce un codice di stato HTTP 429 (troppe richieste) con un'intestazione HTTP Retry-After nella risposta, che indica il numero di secondi di attesa dell'applicazione chiamante prima di effettuare una nuova richiesta.
Download tra aree geografiche
Le operazioni che comportano il download di file in un'area diversa dall'area in cui è stata eseguita la chiamata potrebbero richiedere più tempo del previsto.
Gruppi di operazioni REST
Questa tabella elenca i gruppi di operazioni dell'API REST di Power BI.
Nota
Per gestire capacità di di Power BI Embedded, usare le API REST di Azure Resource Manager Power BI Embedded.
| Gruppo di operazioni | Descrizione |
|---|---|
| amministratore di | Operazioni per l'utilizzo delle attività amministrative. |
| app | Operazioni per l'uso delle app. |
| funzionalità disponibili | Operazioni che restituiscono funzionalità disponibili. |
| capacità di | Operazioni per l'uso delle capacità. |
| dashboard | Operazioni per l'uso dei dashboard. |
| account di archiviazione del flusso di dati | Operazioni per l'uso degli account di archiviazione del flusso di dati. |
| flussi di dati di | Operazioni per l'uso dei flussi di dati. |
| set di dati | Operazioni per l'uso dei set di dati. |
| embed token | Operazioni per l'uso dei token di incorporamento. |
| gateway | Operazioni per l'uso dei gateway. |
| gruppi di | Operazioni per l'uso dei gruppi. |
| Imports | Operazioni per l'utilizzo delle importazioni. |
| pipeline | Operazioni per l'uso delle pipeline di distribuzione. |
| set di dati push | Operazioni per l'uso di set di dati push. |
| report | Operazioni per l'utilizzo dei report. |
| app modello | Operazioni per l'uso delle app modello. |
| utenti | Operazioni per l'uso degli utenti. |