Admin - Dataflows GetDataflowsInGroupAsAdmin

Riferimento

Servizio:: Power BI REST APIs

Versione API:: v1.0

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

Con parametri facoltativi:

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
groupId	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	Dataflows	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

Codice di stato:: 200

{
  "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
DataflowUser	Immissione del diritto di accesso utente di Power BI per un flusso di dati
DataflowUserAccessRight	Diritto di accesso che un utente ha per il flusso di dati (livello di autorizzazione)
PrincipalType	Tipo di entità
ServicePrincipalProfile	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	DataflowUser[]	(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 `getArtifactUser`.

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	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	PrincipalType	Tipo di entità
profile	ServicePrincipalProfile	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

Condividi tramite