Admin - Dataflows GetDataflowsInGroupAsAdmin
Restituisce un elenco di flussi di dati dall'area di lavoro specificata.
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/groups/{groupId}/dataflows
GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/dataflows?$filter={$filter}&$top={$top}&$skip={$skip}
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
group
|
path | True |
string uuid |
ID dell'area di lavoro |
$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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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"
}
]
}
Definizioni
Nome | Descrizione |
---|---|
Dataflow |
Metadati di un flusso di dati. 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. |
Dataflows |
Wrapper di risposta OData per un elenco di metadati del flusso di dati |
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. |
Dataflow
Metadati di un flusso di dati. 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) |
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 |
Dataflows
Wrapper di risposta OData per un elenco di metadati del flusso di dati
Nome | Tipo | Descrizione |
---|---|---|
@odata.context |
string |
|
value |
Dataflow[] |
Elenco di metadati del flusso di dati |
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 |