Admin - Dataflows GetDataflowUsersAsAdmin
Vrátí seznam uživatelů, kteří mají přístup k zadanému toku dat.
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.
Omezení
Maximálně 200 požadavků za hodinu.
GET https://api.powerbi.com/v1.0/myorg/admin/dataflows/{dataflowId}/users
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
dataflow
|
path | True |
string uuid |
ID toku dat |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
OK |
Příklady
Example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/dataflows/{dataflowId}/users
Sample Response
{
"value": [
{
"displayName": "John Nick",
"emailAddress": "john@contoso.com",
"dataflowUserAccessRight": "ReadWrite",
"identifier": "john@contoso.com",
"graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
"principalType": "User"
}
]
}
Definice
Name | Description |
---|---|
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í) |
Dataflow |
Obálka odpovědi OData pro seznam uživatelů Power BI s přístupem k toku dat |
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. |
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. |
DataflowUsers
Obálka odpovědi OData pro seznam uživatelů Power BI s přístupem k toku dat
Name | Typ | Description |
---|---|---|
odata.context |
string |
|
value |
Seznam uživatelů s přístupem k 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 |