Freigeben über

Admin - Dashboards GetDashboardUsersAsAdmin

Dienst:
Power BI REST APIs
API-Version:
v1.0

Gibt eine Liste von Benutzern zurück, die Zugriff auf das angegebene Dashboard haben.

Erlaubnisse

  • Der Benutzer muss ein Fabric-Administrator sein oder sich mit einem Dienstprinzipal authentifizieren.
  • Delegierte Berechtigungen werden unterstützt.

Bei der Ausführung unter der dienst prinicipalen Authentifizierung darf eine App keine erforderlichen Administratorzustimmungen für Power BI im Azure-Portal haben.

Erforderlicher Bereich

Tenant.Read.All oder Tenant.ReadWrite.All

Relevant nur bei der Authentifizierung über ein standardmäßiges delegiertes Administratorzugriffstoken. Darf nicht vorhanden sein, wenn die Authentifizierung über einen Dienstprinzipal verwendet wird.

Einschränkungen

Maximal 200 Anforderungen pro Stunde. 

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
dashboardId
 path True

string (uuid)

Die Dashboard-ID

Antworten

Name Typ Beschreibung
200 OK

DashboardUsers

OKAY

Beispiele

Example

Beispielanforderung

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

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
DashboardUser

Ein Power BI-Benutzerzugriff für ein Dashboard
DashboardUserAccessRight

Das Zugriffsrecht, das der Benutzer für das Dashboard hat (Berechtigungsstufe)
DashboardUsers

Der OData-Antwortwrapper für eine Liste von Power BI-Benutzern mit Zugriff auf ein Dashboard
PrincipalType

Der Prinzipaltyp
ServicePrincipalProfile

Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Mandantenlösung relevant.

DashboardUser

Objekt

Ein Power BI-Benutzerzugriff für ein Dashboard

Name Typ Beschreibung
dashboardUserAccessRight

DashboardUserAccessRight

Das Zugriffsrecht, das der Benutzer für das Dashboard hat (Berechtigungsstufe)
displayName

string

Anzeigename des Prinzipals
emailAddress

string

E-Mail-Adresse des Benutzers
graphId

string

Bezeichner des Prinzipals in Microsoft Graph. Nur für Administrator-APIs verfügbar.
identifier

string

Bezeichner des Prinzipals
principalType

PrincipalType

Der Prinzipaltyp
profile

ServicePrincipalProfile

Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Mandantenlösung relevant.
userType

string

Typ des Benutzers.

DashboardUserAccessRight

Enumeration

Das Zugriffsrecht, das der Benutzer für das Dashboard hat (Berechtigungsstufe)

Wert Beschreibung
None

Keine Berechtigung für Inhalte im Dashboard
Read

Gewährt Lesezugriff auf Inhalte im Dashboard
ReadWrite

Gewährt Lese- und Schreibzugriff auf Inhalte im Dashboard
ReadReshare

Gewährt Lese- und Freigabezugriff auf Inhalte im Dashboard
ReadCopy

Gewährt Lese- und Kopierzugriff auf Inhalte im Dashboard
Owner

Gewährt Lese-, Schreib- und Freigabezugriff auf Inhalte im Bericht

DashboardUsers

Objekt

Der OData-Antwortwrapper für eine Liste von Power BI-Benutzern mit Zugriff auf ein Dashboard

Name Typ Beschreibung
@odata.context

string

value

DashboardUser[]

Die Liste der Benutzer mit Zugriff auf ein Dashboard

PrincipalType

Enumeration

Der Prinzipaltyp

Wert Beschreibung
None

Kein Prinzipaltyp. Wird für den Zugriff auf ganze Organisationsebene verwendet.
User

Benutzerprinzipaltyp
Group

Gruppenprinzipaltyp
App

Dienstprinzipaltyp

ServicePrincipalProfile

Objekt

Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Mandantenlösung relevant.

Name Typ Beschreibung
displayName

string

Der Dienstprinzipalprofilname
id

string (uuid)

Die Dienstprinzipalprofil-ID