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 amministratore
Incorpora contenuto di Power BI
Nota
Alcune DELLE API di Power BI fanno riferimento alle aree di lavoro come gruppi. Qualsiasi riferimento ai gruppi significa che si sta lavorando con le aree di lavoro.
Quando si accede all'API REST di Power BI, il contenuto della richiesta e della risposta e i dati 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 di 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 di Azure AD, è possibile eseguirne l'autenticazione usando Azure AD (v1.0; ADAL) o il 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 hanno più effetto. 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 amministratore servizio Power BI.
Aggiunta di ambiti
Per aggiungere autorizzazioni all'app Azure AD, seguire questa procedura:
Aprire l'app in Azure.
A sinistra, in Gestisci selezionare Autorizzazioni API.
Selezionare Aggiungi un'autorizzazione.
Nella finestra Autorizzazioni API richiesta selezionare Servizio Power BI.
Selezionare Autorizzazioni delegate. Viene visualizzato un elenco di API.
Espandere l'API a cui aggiungere autorizzazioni e selezionare le autorizzazioni che si desidera aggiungere.
Selezionare Aggiungi autorizzazioni.
Rimozione degli ambiti
Per rimuovere le autorizzazioni dall'app Azure AD, seguire questa procedura:
Aprire l'app in Azure.
A sinistra, in Gestisci selezionare Autorizzazioni API.
Selezionare il menu Di scelta rapida (puntini di sospensione dell'autorizzazione).
Selezionare Rimuovi autorizzazione.
Limitazione
Power BI usa la limitazione per mantenere prestazioni e affidabilità ottimali. Per impedire l'utilizzo eccessivo delle risorse da singoli utenti, Power BI limita il numero di chiamate API entro 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 hanno la limitazione della limitazione, Power BI restituisce un codice di stato HTTP 429 (troppe richieste) con un'intestazione HTTP Retry-After nella risposta, indicando quanti secondi l'applicazione chiamante deve attendere prima di effettuare una nuova richiesta.
Gruppi di operazioni REST
Questa tabella elenca i gruppi di operazioni dell'API REST di Power BI.
Nota
Per gestire le capacità di Power BI Embedded, usare le API REST Power BI Embedded di Azure Resource Manager Power BI Embedded.
| Gruppo di operazioni | Descrizione |
|---|---|
| Admin | Operazioni per l'uso di attività amministrative. |
| App | Operazioni per l'uso di app. |
| Funzionalità disponibili | Operazioni che restituiscono le funzionalità disponibili. |
| Capacities | Operazioni per l'uso di capacità. |
| Dashboard | Operazioni per l'uso di dashboard. |
| Account di archiviazione del flusso di dati | Operazioni per l'uso di account di archiviazione del flusso di dati. |
| Flussi di dati | Operazioni per l'uso di flussi di dati. |
| Set di dati | Operazioni per l'uso di set di dati. |
| Token di incorporamento | Operazioni per l'uso di token di incorporamento. |
| Gateway | Operazioni per l'uso di gateway. |
| Gruppi | Operazioni per l'uso di gruppi. |
| Importazioni | Operazioni per l'uso di importazioni. |
| Pipeline | Operazioni per l'uso delle pipeline di distribuzione. |
| Set di dati di push | Operazioni per l'uso di set di dati di push. |
| Report | Operazioni per l'uso di report. |
| App modello | Operazioni per l'uso di app modello. |
| Utenti | Operazioni per l'uso di utenti. |