Freigeben über

Admin - Groups AddUserAsAdmin

Dienst:
Power BI REST APIs
API-Version:
v1.0

Gewährt Benutzern Berechtigungen für den angegebenen Arbeitsbereich.

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

Erlaubnisse

Der Benutzer muss ein Fabric-Administrator sein.

Erforderlicher Bereich

Tenant.ReadWrite.All

Begrenzungen

  • Maximal 200 Anforderungen pro Stunde.
  • Jeder Arbeitsbereich ist auf maximal 1.000 Benutzer oder Gruppen in Arbeitsbereichsrollen beschränkt (Administrator, Mitglied, Mitwirkender, Viewer). Die Anzahl der Benutzer innerhalb einer Gruppe ist nicht beschränkt. Die Einschränkung deckt auch externe Gäste ab. 

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
groupId
 path True

string (uuid)

Die Arbeitsbereichs-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-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.
userType

string

Typ des Benutzers.

Antworten

Name Typ Beschreibung
200 OK

OKAY

Beispiele

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

Add security group to workspace example

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
200

Add service principal to workspace example

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
200

Add user to group example

Beispielanforderung

POST https://api.powerbi.com/v1.0/myorg/admin/groups/206d27ca-94e8-4a69-855b-5c32bdd458a8/users
Anforderungstext
{
  "emailAddress": "john@contoso.com",
  "groupUserAccessRight": "Admin"
}

Beispiel für eine Antwort

Statuscode:
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-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.

GroupUser

Objekt

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-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.
userType

string

Typ des Benutzers.

GroupUserAccessRight

Enumeration

Das Zugriffsrecht (Berechtigungsstufe), über das ein Benutzer im Arbeitsbereich verfügt

Wert Beschreibung
None

Kein Zugriff auf Arbeitsbereichsinhalte
Member

Lese-, Freigabe- und Erkundungsrechte (ReadReshareExplore) für Arbeitsbereichsinhalte
Admin

Administratorrechte für Arbeitsbereichsinhalte
Contributor

Lese- und Erkundungszugriff (ReadExplore) auf Arbeitsbereichsinhalte
Viewer

Schreibgeschützter (Lesezugriff) auf Arbeitsbereichsinhalte

PrincipalType

Enumeration

Der Prinzipaltyp

Wert Beschreibung
None

Kein Prinzipaltyp. Wird für den Zugriff auf ganze Organisationsebene verwendet.
User

Benutzerprinzipaltyp
Group

Gruppenprinzipaltyp
App

Dienstprinzipaltyp

ServicePrincipalProfile

Objekt

Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Multi-Mandantenlösungrelevant.

Name Typ Beschreibung
displayName

string

Der Dienstprinzipalprofilname
id

string (uuid)

Die Dienstprinzipalprofil-ID