Admin - Dataflows GetDataflowsInGroupAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

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

Oprávnění

• Uživatel musí mít oprávnění správce (například Office 365 globálního správce nebo správce služby Power BI) nebo ověřování pomocí instančního objektu.
• Delegovaná oprávnění jsou podporovaná.

Při spuštění v rámci původního ověřování služby nesmí mít aplikace v Azure Portal nastavené žádné předpoklady vyžadované správcem 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. Nesmí být k dispozici při použití ověřování prostřednictvím instančního objektu.

Omezení

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

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

With optional parameters:

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
groupId	path	True	string uuid	ID pracovního prostoru
$filter	query		string	Filtruje výsledky na základě logické podmínky.
$skip	query		integer int32	Přeskočí prvních n výsledků.
$top	query		integer int32	Vrátí pouze prvních n výsledků.

Odpovědi

Name	Typ	Description
200 OK	Dataflows	OK

Příklady

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dataflows

Sample Response

Status code:

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

Definice

Name	Description
Dataflow	Metadata toku dat. Níže je seznam vlastností, které se můžou vrátit pro tok dat. V závislosti na volaných rozhraní API, oprávněních volajícího a dostupnosti dat v databázi Power BI se vrátí jenom podmnožina vlastností.
Dataflows	Obálka odpovědi OData pro seznam metadat toku dat
DataflowUser	Přístupová práva uživatele Power BI pro tok dat
DataflowUserAccessRight	Přístupové právo, které má uživatel k toku dat (úroveň oprávnění)
PrincipalType	Typ objektu zabezpečení
ServicePrincipalProfile	Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.

Dataflow

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

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)
modifiedBy	string	Uživatel, který upravil tok dat
modifiedDateTime	string	Datum a čas poslední změny toku dat
name	string	Název toku dat
objectId	string	ID toku dat
users	DataflowUser[]	(Prázdná hodnota) Podrobnosti o přístupu uživatele k 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í Získat uživatele toku dat jako Správa rozhraní API nebo volání rozhraní API PostWorkspaceInfo s parametremgetArtifactUser.

Dataflows

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

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

DataflowUser

Přístupová práva uživatele Power BI pro tok dat

Name	Typ	Description
DataflowUserAccessRight	DataflowUserAccessRight	Přístupové právo, které má uživatel k toku 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 Graph. 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 objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.
userType	string	Typ uživatele.

DataflowUserAccessRight

Přístupové právo, které má uživatel k toku 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 sdílení obsahu v toku dat.
Read	string	Uděluje přístup ke čtení 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 ke čtení a zápisu 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 objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.

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