Freigeben über

Admin - Reports GetReportUsersAsAdmin

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

Gibt eine Liste von Benutzern zurück, die Zugriff auf den angegebenen Bericht 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/reports/{reportId}/users

URI-Parameter

Name In Erforderlich Typ Beschreibung
reportId
 path True

string (uuid)

Die Berichts-ID

Antworten

Name Typ Beschreibung
200 OK

ReportUsers

OKAY

Beispiele

Example

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/admin/reports/{reportId}/users

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
PrincipalType

Der Prinzipaltyp
ReportUser

Ein Power BI-Benutzerzugriffsrecht für einen Bericht
ReportUserAccessRight

Das Zugriffsrecht, das der Benutzer für den Bericht hat (Berechtigungsstufe)
ReportUsers

Der OData-Antwortwrapper für eine Liste von Power BI-Benutzern mit Zugriff auf einen Bericht
ServicePrincipalProfile

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

PrincipalType

Enumeration

Der Prinzipaltyp

Wert Beschreibung
None

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

Benutzerprinzipaltyp
Group

Gruppenprinzipaltyp
App

Dienstprinzipaltyp

ReportUser

Objekt

Ein Power BI-Benutzerzugriffsrecht für einen Bericht

Name Typ Beschreibung
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.
reportUserAccessRight

ReportUserAccessRight

Das Zugriffsrecht, das der Benutzer für den Bericht hat (Berechtigungsstufe)
userType

string

Typ des Benutzers.

ReportUserAccessRight

Enumeration

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

Wert Beschreibung
None

Keine Berechtigung für Inhalte im Bericht
Read

Gewährt Lesezugriff auf Inhalte im Bericht
ReadWrite

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

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

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

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

ReportUsers

Objekt

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

Name Typ Beschreibung
@odata.context

string

value

ReportUser[]

Die Liste der Benutzer mit Zugriff auf einen Bericht

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