Freigeben über


Admin - Apps GetAppUsersAsAdmin

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

{
  "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