Admin - Dataflows GetDataflowsAsAdmin
Restituisce un elenco di flussi di dati per l'organizzazione.
Autorizzazioni
- L'utente deve essere un amministratore di Fabric o eseguire l'autenticazione usando un'entità servizio.
- Le autorizzazioni delegate sono supportate.
Durante l'esecuzione con l'autenticazione priniciale del servizio, un'app non deve avere premissioni necessarie per il consenso amministratore per Power BI impostate nel portale di Azure.
Ambito obbligatorio
Tenant.Read.All o Tenant.ReadWrite.All
Rilevante solo quando si esegue l'autenticazione tramite un token di accesso amministratore delegato standard. Non deve essere presente quando viene usata l'autenticazione tramite un'entità servizio.
Limitazioni
Massimo 200 richieste all'ora.
GET https://api.powerbi.com/v1.0/myorg/admin/dataflows
GET https://api.powerbi.com/v1.0/myorg/admin/dataflows?$filter={$filter}&$top={$top}&$skip={$skip}
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
$filter
|
query |
string |
Restituisce un sottoinsieme di risultati in base condizione del parametro di query di filtro Odata. |
|
$skip
|
query |
integer int32 |
Ignora i primi n risultati |
|
$top
|
query |
integer int32 |
Restituisce solo i primi n risultati |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK |
Esempio
Example
Esempio di richiesta
GET https://api.powerbi.com/v1.0/myorg/admin/dataflows
Risposta di esempio
{
"value": [
{
"objectId": "bd32e5c0-363f-430b-a03b-5535a4804b9b",
"name": "AdventureWorks",
"description": "Our Adventure Works",
"modelUrl": "https://MyDataflowStorageAccount.dfs.core.windows.net/powerbi/contoso/AdventureWorks/model.json",
"configuredBy": "john@contoso.com",
"workspaceId": "6369a442-4bc4-425c-916d-460c42be746b"
}
]
}
Definizioni
Nome | Descrizione |
---|---|
Admin |
Metadati di un flusso di dati restituito dalle API di amministrazione. Di seguito è riportato un elenco di proprietà che possono essere restituite per un flusso di dati. Solo un subset delle proprietà verrà restituito a seconda dell'API chiamata, delle autorizzazioni del chiamante e della disponibilità dei dati nel database di Power BI. |
Admin |
Wrapper di risposta OData per una raccolta di flussi di dati amministratore di Power BI |
Dataflow |
Immissione del diritto di accesso utente di Power BI per un flusso di dati |
Dataflow |
Diritto di accesso che un utente ha per il flusso di dati (livello di autorizzazione) |
Principal |
Tipo di entità |
Service |
Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded. |
AdminDataflow
Metadati di un flusso di dati restituito dalle API di amministrazione. Di seguito è riportato un elenco di proprietà che possono essere restituite per un flusso di dati. Solo un subset delle proprietà verrà restituito a seconda dell'API chiamata, delle autorizzazioni del chiamante e della disponibilità dei dati nel database di Power BI.
Nome | Tipo | Descrizione |
---|---|---|
configuredBy |
string |
Proprietario del flusso di dati |
description |
string |
Descrizione del flusso di dati |
modelUrl |
string |
URL del file di definizione del flusso di dati (model.json) |
modifiedBy |
string |
Utente che ha modificato il flusso di dati |
modifiedDateTime |
string |
Data e ora dell'ultima modifica del flusso di dati |
name |
string |
Nome del flusso di dati |
objectId |
string |
ID flusso di dati |
users |
(Valore vuoto) Dettagli di accesso utente del flusso di dati. Questa proprietà verrà rimossa dalla risposta del payload in una versione futura. È possibile recuperare informazioni utente su un flusso di dati di Power BI usando il Get Dataflow Users as Admin API call oppure la chiamata API PostWorkspaceInfo con il parametro |
|
workspaceId |
string |
ID dell'area di lavoro del flusso di dati. |
AdminDataflows
Wrapper di risposta OData per una raccolta di flussi di dati amministratore di Power BI
Nome | Tipo | Descrizione |
---|---|---|
odata.context |
string |
Contesto OData |
value |
Raccolta di report |
DataflowUser
Immissione del diritto di accesso utente di Power BI per un flusso di dati
Nome | Tipo | Descrizione |
---|---|---|
DataflowUserAccessRight |
Diritto di accesso che un utente ha per il flusso di dati (livello di autorizzazione) |
|
displayName |
string |
Nome visualizzato dell'entità |
emailAddress |
string |
Indirizzo di posta elettronica dell'utente |
graphId |
string |
Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione. |
identifier |
string |
Identificatore dell'entità |
principalType |
Tipo di entità |
|
profile |
Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded. |
|
userType |
string |
Tipo di utente. |
DataflowUserAccessRight
Diritto di accesso che un utente ha per il flusso di dati (livello di autorizzazione)
Nome | Tipo | Descrizione |
---|---|---|
None |
string |
Rimuove l'autorizzazione per il contenuto nel flusso di dati |
Owner |
string |
Concede l'accesso in lettura, scrittura e ricondivisione al contenuto nel flusso di dati |
Read |
string |
Concede l'accesso in lettura al contenuto nel flusso di dati |
ReadReshare |
string |
Concede l'accesso in lettura e ricondivisione al contenuto nel flusso di dati |
ReadWrite |
string |
Concede l'accesso in lettura e scrittura al contenuto nel flusso di dati |
PrincipalType
Tipo di entità
Nome | Tipo | Descrizione |
---|---|---|
App |
string |
Tipo di entità servizio |
Group |
string |
Tipo di entità gruppo |
None |
string |
Nessun tipo di entità. Usare per l'accesso a livello di organizzazione intero. |
User |
string |
Tipo di entità utente |
ServicePrincipalProfile
Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.
Nome | Tipo | Descrizione |
---|---|---|
displayName |
string |
Nome del profilo dell'entità servizio |
id |
string |
ID del profilo dell'entità servizio |