Dataflows - Get Dataflows

Služba:

Power BI REST APIs

Verze rozhraní API:

v1.0

Vrátí seznam všech toků dat ze zadaného pracovního prostoru.

Dovolení

Toto volání rozhraní API může volat instanční profil. Další informace najdete v tématu: profily instančního objektu v Power BI Embedded.

Požadovaný obor

Dataflow.ReadWrite.All nebo Dataflow.Read.All

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/dataflows

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
groupId	path	True	string (uuid)	ID pracovního prostoru

Odpovědi

Name	Typ	Description
200 OK	Dataflows	OK

Příklady

Example

Ukázkový požadavek

GET https://api.powerbi.com/v1.0/myorg/groups/a2f89923-421a-464e-bf4c-25eab39bb09f/dataflows

Ukázková odpověď

Stavový kód:

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"
    }
  ]
}

Definice

Name	Description
Dataflow	Metadata toku dat. Níže je seznam vlastností, které mohou být vráceny pro tok dat. V závislosti na volaného rozhraní API se vrátí jenom podmnožina vlastností, oprávnění volajícího a dostupnost dat v databázi Power BI.
Dataflows	Obálka odpovědi OData pro seznam metadat toku dat
DataflowUser	Přístup uživatele Power BI ke správnému zadání toku dat
DataflowUserAccessRight	Přístupové právo, které má uživatel pro tok dat (úroveň oprávnění)
PrincipalType	Typ objektu zabezpečení
ServicePrincipalProfile	Profil instančního objektu Power BI. Relevantní pouze pro víceklientské řešení Power BI Embedded.

Dataflow

Objekt

Metadata toku dat. Níže je seznam vlastností, které mohou být vráceny pro tok dat. V závislosti na volaného rozhraní API se vrátí jenom podmnožina vlastností, oprávnění volajícího a dostupnost dat v databázi Power BI.

Name	Typ	Description
configuredBy	string	Vlastník toku dat
description	string	Popis toku dat
modelUrl	string	Adresa URL definičního souboru toku dat (model.json)
name	string	Název toku dat
objectId	string (uuid)	ID toku dat
users	DataflowUser[]	(Prázdná hodnota) Podrobnosti o přístupu uživatele toku dat. Tato vlastnost bude odebrána z odpovědi datové části v nadcházející verzi. Informace o uživatelích v toku dat Power BI můžete načíst pomocí volání rozhraní API Získat tok dat jako správce rozhraní API nebo volání rozhraní API PostWorkspaceInfo rozhraní API s parametrem getArtifactUser.

Dataflows

Objekt

Obálka odpovědi OData pro seznam metadat toku dat

Name	Typ	Description
@odata.context	string
value	Dataflow[]	Seznam metadat toku dat

DataflowUser

Objekt

Přístup uživatele Power BI ke správnému zadání toku dat

Name	Typ	Description
DataflowUserAccessRight	DataflowUserAccessRight	Přístupové právo, které má uživatel pro tok dat (úroveň oprávnění)
displayName	string	Zobrazovaný název objektu zabezpečení
emailAddress	string	E-mailová adresa uživatele
graphId	string	Identifikátor objektu zabezpečení v Microsoft Graphu K dispozici pouze pro rozhraní API pro správu.
identifier	string	Identifikátor objektu zabezpečení
principalType	PrincipalType	Typ objektu zabezpečení
profile	ServicePrincipalProfile	Profil instančního objektu Power BI. Relevantní pouze pro víceklientské řešení Power BI Embedded.
userType	string	Typ uživatele

DataflowUserAccessRight

Výčet

Přístupové právo, které má uživatel pro tok dat (úroveň oprávnění)

Hodnota	Description
None	Odebere oprávnění k obsahu v toku dat.
Read	Uděluje přístup pro čtení k obsahu v toku dat.
ReadWrite	Uděluje přístup pro čtení a zápis k obsahu v toku dat.
ReadReshare	Uděluje přístup ke čtení a sdílení obsahu v toku dat.
Owner	Uděluje přístup ke čtení, zápisu a opětovnému sdílení obsahu v toku dat.

PrincipalType

Výčet

Typ objektu zabezpečení

Hodnota	Description
None	Žádný typ objektu zabezpečení. Používá se pro přístup na úrovni celé organizace.
User	Typ objektu zabezpečení uživatele
Group	Typ objektu zabezpečení skupiny
App	Typ instančního objektu

ServicePrincipalProfile

Objekt

Profil instančního objektu Power BI. Relevantní pouze pro víceklientské řešení Power BI Embedded.

Name	Typ	Description
displayName	string	Název instančního profilu
id	string (uuid)	ID profilu instančního objektu