Groups - Update Group User

Service:

Power BI REST APIs

API Version:

v1.0

Updates die angegebenen Benutzerberechtigungen für den angegebenen Arbeitsbereich.

Berechtigungen

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

Erforderlicher Bereich

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 .
  
  

PUT https://api.powerbi.com/v1.0/myorg/groups/{groupId}/users

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
groupId	path	True	string uuid	Arbeitsbereich-ID

Anforderungstext

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

Antworten

Name	Typ	Beschreibung
200 OK		OK

Beispiele

Assign administrator user access rights to a service principal example

Example

Assign administrator user access rights to a service principal example

Sample Request

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

Request Body

{
  "identifier": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "groupUserAccessRight": "Admin",
  "principalType": "App"
}

Sample Response

Status code:

200

Example

Sample Request

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

Request Body

{
  "emailAddress": "john@contoso.com",
  "groupUserAccessRight": "Admin"
}

Sample Response

Status code:

200

Definitionen

Name	Beschreibung
GroupUser	Ein Power BI-Benutzer mit Zugriff auf den Arbeitsbereich
GroupUserAccessRight	Das Zugriffsrecht (Berechtigungsstufe), das ein Benutzer im Arbeitsbereich hat
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

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