Freigeben über

Groups - Get Group Users

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

Gibt eine Liste von Benutzern zurück, die Zugriff auf den angegebenen Arbeitsbereich haben.

Erlaubnisse

Dieser API-Aufruf kann von einem Dienstprinzipalprofil aufgerufen werden. Weitere Informationen finden Sie unter: Dienstprinzipalprofile in Power BI Embedded.

Erforderlicher Bereich

Workspace.Read.All oder Workspace.ReadWrite.All

Einschränkungen

  • Benutzerberechtigungen für Arbeitsbereiche nehmen Zeit in Anspruch, um aktualisiert zu werden und sind möglicherweise nicht sofort verfügbar, wenn API-Aufrufe verwendet werden. Verwenden Sie zum Aktualisieren von Benutzerberechtigungen den API-Aufruf " Benutzerberechtigungen aktualisieren" . 

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/users
Mit optionalen Parametern: 
GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/users?$top={$top}&$skip={$skip}

URI-Parameter

Name In Erforderlich Typ Beschreibung
groupId
 path True

string (uuid)

Die Arbeitsbereichs-ID
$skip
 query

integer (int32)

Überspringt die ersten n Ergebnisse.
$top
 query

integer (int32)

Gibt nur die ersten n Ergebnisse zurück.

Antworten

Name Typ Beschreibung
200 OK

GroupUsers

OKAY

Beispiele

Example

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
200 
{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "groupUserAccessRight": "Admin",
      "identifier": "john@contoso.com",
      "principalType": "User"
    },
    {
      "displayName": "Adam Wood",
      "emailAddress": "Adam@contoso.com",
      "groupUserAccessRight": "Member",
      "identifier": "Adam@contoso.com",
      "principalType": "User"
    },
    {
      "displayName": "ContosoTestApp",
      "groupUserAccessRight": "Admin",
      "identifier": "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-Dienstprinzipalprofil. Nur für Power BI Embedded Mandantenlösung relevant.

GroupUser

Objekt

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-Dienstprinzipalprofil. Nur für Power BI Embedded Mandantenlösung relevant.
userType

string

Typ des Benutzers.

GroupUserAccessRight

Enumeration

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

Wert Beschreibung
None

Kein Zugriff auf Arbeitsbereichsinhalte
Member

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

Administratorrechte für Arbeitsbereichsinhalte
Contributor

Lese- und Erkundungszugriff (ReadExplore) auf Arbeitsbereichsinhalte
Viewer

Schreibgeschützter (Lesezugriff) auf Arbeitsbereichsinhalte

GroupUsers

Objekt

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

Enumeration

Der Prinzipaltyp

Wert Beschreibung
None

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

Benutzerprinzipaltyp
Group

Gruppenprinzipaltyp
App

Dienstprinzipaltyp

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