Sdílet prostřednictvím


Admin - Dataflows GetDataflowsInGroupAsAdmin

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

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/groups/{groupId}/dataflows
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

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

Dataflows

OK

Příklady

Example

Ukázkový požadavek

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

Ukázková odpověď

{
  "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é 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

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

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

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

Name Typ Description
@odata.context

string

value

Dataflow[]

Seznam metadat toku dat

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