Sdílet prostřednictvím


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
dataflowId
path True

string

uuid

ID toku dat

Odpovědi

Name Typ Description
200 OK

DataflowUsers

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
DataflowUser

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

DataflowUserAccessRight

Přístupová práva, která má uživatel k toku dat (úroveň oprávnění)

DataflowUsers

Obálka odpovědi OData pro seznam uživatelů Power BI s přístupem k toku dat

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.

DataflowUser

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

Name Typ Description
DataflowUserAccessRight

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

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á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

DataflowUser[]

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