Groups - Get Group Users

Referenz

Service:: Power BI REST APIs

API Version:: v1.0

Gibt eine Liste der Benutzer zurück, die Zugriff auf den angegebenen Arbeitsbereich haben.

Berechtigungen

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 dauern, bis sie aktualisiert 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

With optional parameters:

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	Arbeitsbereich-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	OK

Beispiele

Example

Sample Request

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

Sample Response

Status code:: 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), das ein Benutzer im Arbeitsbereich hat
GroupUsers	Der OData-Antwort-Wrapper 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 Lösung mit mehreren Mandanten.

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), das ein Benutzer im Arbeitsbereich hat
identifier	string	Bezeichner des Prinzipals
principalType	PrincipalType	Der Prinzipaltyp
profile	ServicePrincipalProfile	Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Lösung mit mehreren Mandanten.
userType	string	Typ des Benutzers.

GroupUserAccessRight

Das Zugriffsrecht (Berechtigungsstufe), das ein Benutzer im Arbeitsbereich hat

Name	Typ	Beschreibung
Admin	string	Administratorrechte für Arbeitsbereichsinhalte
Contributor	string	Lesen und Erkunden des Zugriffs (ReadExplore) auf Arbeitsbereichsinhalte
Member	string	Lese-, Weiterfreigabe- und Sondierungsrechte (ReadReshareExplore) für Arbeitsbereichsinhalte
None	string	Kein Zugriff auf Arbeitsbereichsinhalte
Viewer	string	Schreibgeschützter Zugriff (Lesezugriff) auf Arbeitsbereichsinhalte

GroupUsers

Der OData-Antwort-Wrapper 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 Zugriff auf organization ganzen Organization ebene.
User	string	Benutzerprinzipaltyp

ServicePrincipalProfile

Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Lösung mit mehreren Mandanten.

Name	Typ	Beschreibung
displayName	string	Der Dienstprinzipalprofilname
id	string	Die Dienstprinzipalprofil-ID

Freigeben über