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 |
---|---|---|---|---|
group
|
path | True |
string uuid |
Arbeitsbereich-ID |
Anforderungstext
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
groupUserAccessRight | True |
Das Zugriffsrecht (Berechtigungsstufe), über das ein Benutzer im Arbeitsbereich verfügt |
|
identifier | True |
string |
Bezeichner des Prinzipals |
principalType | True |
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 |
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 |
---|---|
Group |
Ein Power BI-Benutzer mit Zugriff auf den Arbeitsbereich |
Group |
Das Zugriffsrecht (Berechtigungsstufe), über das ein Benutzer im Arbeitsbereich verfügt |
Principal |
Der Prinzipaltyp |
Service |
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 |
Das Zugriffsrecht (Berechtigungsstufe), über das ein Benutzer im Arbeitsbereich verfügt |
|
identifier |
string |
Bezeichner des Prinzipals |
principalType |
Der Prinzipaltyp |
|
profile |
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 |