Admin - Dashboards GetDashboardUsersAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Vrátí seznam uživatelů, kteří mají přístup k zadanému řídicímu panelu.

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/dashboards/{dashboardId}/users

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
dashboardId	path	True	string uuid	ID řídicího panelu

Odpovědi

Name	Typ	Description
200 OK	DashboardUsers	OK

Příklady

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/dashboards/{dashboardId}/users

Sample Response

Status code:

200

{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "dashboardUserAccessRight": "Owner",
      "identifier": "john@contoso.com",
      "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
      "principalType": "User"
    }
  ]
}

Definice

Name	Description
DashboardUser	Přístupová práva uživatele Power BI k řídicímu panelu
DashboardUserAccessRight	Přístupová práva, která má uživatel k řídicímu panelu (úroveň oprávnění)
DashboardUsers	Obálka odpovědi OData pro seznam uživatelů Power BI s přístupem k řídicímu panelu
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.

DashboardUser

Přístupová práva uživatele Power BI k řídicímu panelu

Name	Typ	Description
dashboardUserAccessRight	DashboardUserAccessRight	Přístupová práva, která má uživatel k řídicímu panelu (ú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.

DashboardUserAccessRight

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

Name	Typ	Description
None	string	Žádná oprávnění k obsahu na řídicím panelu
Owner	string	Uděluje přístup ke čtení, zápisu a sdílení obsahu v sestavě.
Read	string	Uděluje oprávnění ke čtení obsahu na řídicím panelu.
ReadCopy	string	Uděluje přístup ke čtení a kopírování obsahu na řídicím panelu.
ReadReshare	string	Uděluje přístup ke čtení a sdílení obsahu na řídicím panelu.
ReadWrite	string	Udělí oprávnění ke čtení a zápisu k obsahu na řídicím panelu.

DashboardUsers

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

Name	Typ	Description
odata.context	string
value	DashboardUser[]	Seznam uživatelů s přístupem k řídicímu panelu

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