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

AdminDataflows

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
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.

AdminDataflows

Wrapper di risposta OData per una raccolta di flussi di dati amministratore di Power BI

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.

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

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.

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

AdminDataflow[]

Raccolta di report

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