Freigeben über


Admin - Groups GetGroupUsersAsAdmin

Gibt eine Liste der Benutzer zurück, die Zugriff auf den angegebenen Arbeitsbereich 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/groups/{groupId}/users

URI-Parameter

Name In Erforderlich Typ Beschreibung
groupId
path True

string

uuid

Arbeitsbereich-ID

Antworten

Name Typ Beschreibung
200 OK

GroupUsers

OK

Beispiele

Example

Sample Request

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

Sample Response

{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "groupUserAccessRight": "Admin",
      "identifier": "john@contoso.com",
      "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
      "principalType": "User"
    },
    {
      "displayName": "Adam Wood",
      "emailAddress": "Adam@contoso.com",
      "groupUserAccessRight": "Member",
      "identifier": "Adam@contoso.com",
      "graphId": "785e192c-0f1f-41ca-ae7a-a85da28e565a",
      "principalType": "User"
    },
    {
      "displayName": "ContosoTestApp",
      "groupUserAccessRight": "Admin",
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "graphId": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App"
    }
  ]
}

Definitionen

Name Beschreibung
GroupUser

Ein Power BI-Benutzer mit Zugriff auf den Arbeitsbereich

GroupUserAccessRight

Das Zugriffsrecht (Berechtigungsstufe), über das ein Benutzer im Arbeitsbereich verfügt

GroupUsers

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

PrincipalType

Der Prinzipaltyp

ServicePrincipalProfile

Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Mehrinstanzenlösung.

GroupUser

Ein Power BI-Benutzer mit Zugriff auf den Arbeitsbereich

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.

groupUserAccessRight

GroupUserAccessRight

Das Zugriffsrecht (Berechtigungsstufe), über das ein Benutzer im Arbeitsbereich verfügt

identifier

string

Bezeichner des Prinzipals

principalType

PrincipalType

Der Prinzipaltyp

profile

ServicePrincipalProfile

Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Mehrinstanzenlösung.

userType

string

Typ des Benutzers.

GroupUserAccessRight

Das Zugriffsrecht (Berechtigungsstufe), über das ein Benutzer im Arbeitsbereich verfügt

Name Typ Beschreibung
Admin

string

Administratorrechte für Arbeitsbereichsinhalte

Contributor

string

Lesen und Erkunden des Zugriffs (ReadExplore) auf Arbeitsbereichsinhalte

Member

string

Lese-, Freigabe- und Erkundungsrechte (ReadReshareExplore) für Arbeitsbereichsinhalte

None

string

Kein Zugriff auf Arbeitsbereichsinhalte

Viewer

string

Schreibgeschützter (Lesezugriff) auf Arbeitsbereichsinhalte

GroupUsers

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

Name Typ Beschreibung
odata.context

string

value

GroupUser[]

Die Liste der Benutzer mit Zugriff auf einen Arbeitsbereich

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

ServicePrincipalProfile

Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Mehrinstanzenlösung.

Name Typ Beschreibung
displayName

string

Der Dienstprinzipalprofilname

id

string

Die Dienstprinzipalprofil-ID