Admin - Apps GetAppUsersAsAdmin

Dienst:: Power BI REST APIs

API-Version:: v1.0

Gibt eine Liste von Benutzern zurück, die Zugriff auf die angegebene App 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/apps/{appId}/users

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
appId	path	True	string (uuid)	Die App-ID

Antworten

Name	Typ	Beschreibung
200 OK	AppUsers	OKAY

Beispiele

Example

Beispielanforderung

GET https://api.powerbi.com/v1.0/myorg/admin/apps/f089354e-8366-4e18-aea3-4cb4a3a50b48/users

Beispiel für eine Antwort

Statuscode:: 200

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

Definitionen

Name	Beschreibung
AppUser	Ein Power BI-Benutzerzugriff für eine App
AppUserAccessRight	Das Zugriffsrecht, das der Benutzer für die App hat
AppUsers	Der OData-Antwortwrapper für eine Liste von Power BI-Benutzern mit Zugriff auf eine App
PrincipalType	Der Prinzipaltyp

AppUser

Objekt

Ein Power BI-Benutzerzugriff für eine App

Name	Typ	Beschreibung
appUserAccessRight	AppUserAccessRight	Das Zugriffsrecht, das der Benutzer für die App hat
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

AppUserAccessRight

Enumeration

Das Zugriffsrecht, das der Benutzer für die App hat

Wert	Beschreibung
None	Keine Berechtigung für Inhalte in der App
Read	Gewährt Lesezugriff auf Inhalte in der App
ReadWrite	Gewährt Lese- und Schreibzugriff auf Inhalte in der App
ReadReshare	Gewährt Lese- und Freigabezugriff auf Inhalte in der App
ReadWriteReshare	Gewährt Lese-, Schreib- und Freigabezugriff auf Inhalte in der App
ReadExplore	Gewährt Lese- und Erkunden des Zugriffs auf Inhalte in der App
ReadCopy	Gewährt Lese- und Kopierzugriff auf Inhalte in der App
ReadExploreCopy	Gewährt Lese-, Durchsuchen- und Kopierzugriff auf Inhalte in der App
ReadReshareExplore	Gewährt Lese-, Freigabe- und Erkunden des Zugriffs auf Inhalte in der App
ReadReshareExploreCopy	Gewährt Lese-, Freigabe-, Durchsuchen- und Kopierzugriff auf Inhalte in der App
ReadWriteExplore	Gewährt Lese-, Schreib- und Erkunden des Zugriffs auf Inhalte in der App
ReadWriteReshareExplore	Gewährt Lese-, Schreib-, Freigabe- und Erkunden des Zugriffs auf Inhalte in der App
ReadWriteExploreCopy	Gewährt Lese-, Schreib-, Erkundungs- und Kopierzugriff auf Inhalte in der App
ReadReshareCopy	Gewährt Lese-, Freigabe- und Kopierzugriff auf Inhalte in der App
All	Gewährt Lese-, Schreib-, Explore-, Reshare- und Copy-Zugriff auf Inhalte in der App

AppUsers