Admin - Dataflows GetDataflowsAsAdmin

Reference

Služba:: Power BI REST APIs

Verze rozhraní API:: v1.0

Vrátí seznam toků dat pro organizaci.

Dovolení

Uživatel musí být správcem infrastruktury nebo se musí ověřit pomocí instančního objektu.
Delegovaná oprávnění jsou podporována.

Při spuštění v rámci ověřování prinicipal služby nesmí aplikace nesmí mít na webu Azure Portal nastavené žádné žádosti o udělení souhlasu správce pro Power BI.

Požadovaný obor

Tenant.Read.All nebo Tenant.ReadWrite.All

Relevantní pouze při ověřování prostřednictvím standardního delegovaného přístupového tokenu správce. Při ověřování pomocí instančního objektu nesmí být k dispozici.

Omezení

Maximálně 200 požadavků za hodinu.

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows

S volitelnými parametry:

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows?$filter={$filter}&$top={$top}&$skip={$skip}

Parametry identifikátoru URI

Name	V	Typ	Description
$filter	query	string	Vrátí podmnožinu výsledků na základě Odata podmínky parametru dotazu filtru.
$skip	query	integer int32	Přeskočí první n výsledků.
$top	query	integer int32	Vrátí pouze první n výsledků.

Odpovědi

Name	Typ	Description
200 OK	AdminDataflows	OK

Příklady

Example

Ukázkový požadavek

GET https://api.powerbi.com/v1.0/myorg/admin/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",
      "configuredBy": "john@contoso.com",
      "workspaceId": "6369a442-4bc4-425c-916d-460c42be746b"
    }
  ]
}

Definice

Name	Description
AdminDataflow	Metadata toku dat vrácená rozhraními API pro správu. 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.
AdminDataflows	Obálka odpovědí OData pro kolekci toku dat správce Power BI
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.

AdminDataflow

Metadata toku dat vrácená rozhraními API pro správu. 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	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`.
workspaceId	string	ID pracovního prostoru toku dat.

AdminDataflows

Obálka odpovědí OData pro kolekci toku dat správce Power BI

Name	Typ	Description
@odata.context	string	Kontext OData
value	AdminDataflow[]	Kolekce sestav

DataflowUser

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

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

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

PrincipalType

Typ objektu zabezpečení

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

ServicePrincipalProfile

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	ID profilu instančního objektu

Sdílet prostřednictvím