Freigeben über


Groups - Add Group User

Gewährt dem angegebenen Benutzer die angegebenen Berechtigungen 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

  • Die Aktualisierung von Benutzerberechtigungen für Arbeitsbereiche dauert einige Zeit und steht bei Verwendung von API-Aufrufen möglicherweise nicht sofort zur Verfügung. Verwenden Sie zum Aktualisieren von Benutzerberechtigungen den Api-Aufruf Benutzerberechtigungen aktualisieren .

POST 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), über das ein Benutzer im Arbeitsbereich verfügt

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 Mehrinstanzenlösung.

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

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users
{
  "identifier": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "groupUserAccessRight": "Admin",
  "principalType": "App"
}

Sample Response

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users
{
  "emailAddress": "john@contoso.com",
  "groupUserAccessRight": "Admin"
}

Sample Response

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

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

PrincipalType

Der Prinzipaltyp

Name Typ Beschreibung
App

string

Dienstprinzipaltyp

Group

string

Gruppenprinzipaltyp

None

string

Kein Prinzipaltyp. Verwenden Sie für den Zugriff auf die gesamte organization ebene.

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