Admin - Groups AddUserAsAdmin

  • Referenz
Service:
Power BI REST APIs
API Version:
v1.0

Gewährt Dem angegebenen Arbeitsbereich Benutzerberechtigungen.

Dieser API-Aufruf unterstützt nur das Hinzufügen eines Benutzers, einer Sicherheitsgruppe, einer M365-Gruppe und eines Dienstprinzipals.

Berechtigungen

Der Benutzer muss über Administratorrechte verfügen (z. B. Office 365 globaler Administrator oder Power BI-Dienstadministrator).

Erforderlicher Bereich

Tenant.ReadWrite.All

Einschränkungen

Maximal 200 Anforderungen pro Stunde. 

POST https://api.powerbi.com/v1.0/myorg/admin/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

Add security group to workspace example
Add service principal to workspace example
Add user to group example

Add security group to workspace example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/admin/groups/206d27ca-94e8-4a69-855b-5c32bdd458a8/users
Request Body
{
  "identifier": "ece007fa-2f19-4df1-bdd5-539881ec5f83",
  "principalType": "Group",
  "groupUserAccessRight": "Member"
}

Sample Response

Status code:
200

Add service principal to workspace example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/admin/groups/206d27ca-94e8-4a69-855b-5c32bdd458a8/users
Request Body
{
  "identifier": "84c468ad-12f1-471e-af6f-0999da422391",
  "principalType": "App",
  "groupUserAccessRight": "Viewer"
}

Sample Response

Status code:
200

Add user to group example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/admin/groups/206d27ca-94e8-4a69-855b-5c32bdd458a8/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), ü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