Admin - Apps GetAppUsersAsAdmin

Referenz

Service:: Power BI REST APIs

API Version:: v1.0

Gibt eine Liste der Benutzer zurück, die Zugriff auf die angegebene App haben.

Berechtigungen

Der Benutzer muss über Administratorrechte (z. B. Office 365 globalen Administrator oder Power BI-Dienstadministrator) verfügen oder sich mithilfe eines Dienstprinzipals authentifizieren.
Delegierte Berechtigungen werden unterstützt.

Bei der Ausführung unter dienstprinizipaler Authentifizierung dürfen für eine App keine erforderlichen Administratoreinwilligungsvoreinstellungen für Power BI im Azure-Portal festgelegt sein.

Erforderlicher Bereich

Tenant.Read.All oder Tenant.ReadWrite.All

Nur bei der Authentifizierung über ein standardmäßiges delegiertes Administratorzugriffstoken relevant. 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	OK

Beispiele

Example

Sample Request

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

Sample Response

Status code:: 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-Benutzerzugriffsrechteintrag 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

Ein Power BI-Benutzerzugriffsrechteintrag 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

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

Name	Typ	Beschreibung
All	string	Gewährt Lese-, Schreib-, Erkundungs-, Freigabe- und Kopierzugriff auf Inhalte in der App
None	string	Keine Berechtigung für Inhalte in der App
Read	string	Gewährt Lesezugriff auf Inhalte in der App
ReadCopy	string	Gewährt Lese- und Kopierzugriff auf Inhalte in der App
ReadExplore	string	Gewährt Lese- und Erkundungszugriff auf Inhalte in der App
ReadExploreCopy	string	Gewährt Lese-, Erkundungs- und Kopierzugriff auf Inhalte in der App
ReadReshare	string	Gewährt lese- und erneuten Zugriff auf Inhalte in der App
ReadReshareCopy	string	Gewährt Lese-, Freigabe- und Kopierzugriff auf Inhalte in der App
ReadReshareExplore	string	Gewährt Lese-, Freigabe- und Erkundungszugriff auf Inhalte in der App
ReadReshareExploreCopy	string	Gewährt Lese-, Freigabe-, Erkundungs- und Kopierzugriff auf Inhalte in der App
ReadWrite	string	Gewährt Lese- und Schreibzugriff auf Inhalte in der App
ReadWriteExplore	string	Gewährt Lese-, Schreib- und Erkundungszugriff auf Inhalte in der App
ReadWriteExploreCopy	string	Gewährt Lese-, Schreib-, Erkundungs- und Kopierzugriff auf Inhalte in der App
ReadWriteReshare	string	Gewährt Lese-, Schreib- und erneuten Zugriff auf Inhalte in der App
ReadWriteReshareExplore	string	Gewährt Lese-, Schreib-, Freigabe- und Erkundungszugriff auf Inhalte in der App

AppUsers

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

Name	Typ	Beschreibung
odata.context	string
value	AppUser[]	Die Liste der Benutzer mit Zugriff auf eine App

PrincipalType

Der Prinzipaltyp

Name	Typ	Beschreibung
App	string	Dienstprinzipaltyp
Group	string	Gruppenprinzipaltyp
None	string	Kein Prinzipaltyp. Verwenden Sie für den Gesamten Zugriff auf Organisationsebene.
User	string	Benutzerprinzipaltyp