Admin - Dataflows GetDataflowsAsAdmin
Vrátí seznam toků dat pro organizaci.
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 ověřování prinicipal služby nesmí mít aplikace v Azure Portal nastavená oprávnění pro Power BI vyžadovaná správcem.
Požadovaný obor
Tenant.Read.All nebo Tenant.ReadWrite.All
Relevantní pouze při ověřování prostřednictvím standardního přístupového tokenu delegovaného správce. Nesmí být přítomen, když se používá ověřování prostřednictvím instančního objektu.
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}
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
$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 |
OK |
Příklady
Example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/dataflows
Sample Response
{
"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 |
---|---|
Admin |
Metadata toku dat vrácená rozhraními API Správa. Níže je seznam vlastností, které se můžou pro tok dat vrátit. 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í. |
Admin |
Obálka odpovědi OData pro kolekci toku dat Power BI Správa |
Dataflow |
Přístupová práva uživatele Power BI pro tok dat |
Dataflow |
Přístupová práva, která má uživatel k toku dat (úroveň oprávnění) |
Principal |
Typ objektu zabezpečení |
Service |
Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty. |
AdminDataflow
Metadata toku dat vrácená rozhraními API Správa. Níže je seznam vlastností, které se můžou pro tok dat vrátit. 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ý tok dat upravil |
modifiedDateTime |
string |
Datum a čas poslední změny toku dat |
name |
string |
Název toku dat |
objectId |
string |
ID toku dat |
users |
(Prázdná hodnota) Podrobnosti o přístupu uživatele k toku dat Tato vlastnost se odebere 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 volání rozhraní API Správa nebo volání rozhraní API PostWorkspaceInfo s parametrem |
|
workspaceId |
string |
ID pracovního prostoru toku dat. |
AdminDataflows
Obálka odpovědi OData pro kolekci toku dat Power BI Správa
Name | Typ | Description |
---|---|---|
odata.context |
string |
Kontext OData |
value |
Kolekce sestav |
DataflowUser
Přístupová práva uživatele Power BI pro tok dat
Name | Typ | Description |
---|---|---|
DataflowUserAccessRight |
Přístupová práva, 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 Graphu. K dispozici pouze pro rozhraní API pro správu. |
identifier |
string |
Identifikátor objektu zabezpečení |
principalType |
Typ objektu zabezpečení |
|
profile |
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áva, 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žijte 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 |