Admin - Groups AddUserAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Przyznaje użytkownikowi uprawnienia do określonego obszaru roboczego.

To wywołanie interfejsu API obsługuje tylko dodawanie użytkownika, grupy zabezpieczeń, grupy M365 i jednostki usługi.

Uprawnienia

Użytkownik musi mieć uprawnienia administratora (takie jak administrator globalny Office 365 lub administrator usługi Power BI).

Zakres wymagany

Tenant.ReadWrite.All

Ograniczenia

Maksymalna liczba żądań na godzinę wynosi 200.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
groupId	path	True	string uuid	Identyfikator obszaru roboczego

Treść żądania

Nazwa	Wymagane	Typ	Opis
groupUserAccessRight	True	GroupUserAccessRight	Prawo dostępu (poziom uprawnień), które użytkownik ma w obszarze roboczym
identifier	True	string	Identyfikator podmiotu zabezpieczeń
principalType	True	PrincipalType	Typ podmiotu zabezpieczeń
displayName		string	Nazwa wyświetlana podmiotu zabezpieczeń
emailAddress		string	Adres e-mail użytkownika
graphId		string	Identyfikator podmiotu zabezpieczeń w programie Microsoft Graph. Dostępne tylko dla interfejsów API administratora.
profile		ServicePrincipalProfile	Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.
userType		string	Typ użytkownika.

Odpowiedzi

Nazwa	Typ	Opis
200 OK		OK

Przykłady

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

Definicje

Nazwa	Opis
GroupUser	Użytkownik usługi Power BI z dostępem do obszaru roboczego
GroupUserAccessRight	Prawo dostępu (poziom uprawnień), które użytkownik ma w obszarze roboczym
PrincipalType	Typ podmiotu zabezpieczeń
ServicePrincipalProfile	Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.

GroupUser

Użytkownik usługi Power BI z dostępem do obszaru roboczego

Nazwa	Typ	Opis
displayName	string	Nazwa wyświetlana podmiotu zabezpieczeń
emailAddress	string	Adres e-mail użytkownika
graphId	string	Identyfikator podmiotu zabezpieczeń w programie Microsoft Graph. Dostępne tylko dla interfejsów API administratora.
groupUserAccessRight	GroupUserAccessRight	Prawo dostępu (poziom uprawnień), które użytkownik ma w obszarze roboczym
identifier	string	Identyfikator podmiotu zabezpieczeń
principalType	PrincipalType	Typ podmiotu zabezpieczeń
profile	ServicePrincipalProfile	Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.
userType	string	Typ użytkownika.

GroupUserAccessRight

Prawo dostępu (poziom uprawnień), które użytkownik ma w obszarze roboczym

Nazwa	Typ	Opis
Admin	string	Prawa administratora do zawartości obszaru roboczego
Contributor	string	Odczyt i eksplorowanie (ReadExplore) — dostęp do zawartości obszaru roboczego
Member	string	Prawa dostępu do zawartości obszaru roboczego można odczytywać, udostępniać dalej i eksplorować (ReadReshareExplore)
None	string	Brak dostępu do zawartości obszaru roboczego
Viewer	string	Dostęp tylko do odczytu (odczyt) do zawartości obszaru roboczego

PrincipalType

Typ podmiotu zabezpieczeń

Nazwa	Typ	Opis
App	string	Typ jednostki usługi
Group	string	Typ podmiotu zabezpieczeń grupy
None	string	Brak typu podmiotu zabezpieczeń. Służy do uzyskiwania dostępu na poziomie całej organizacji.
User	string	Typ podmiotu zabezpieczeń użytkownika

ServicePrincipalProfile

Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.

Nazwa	Typ	Opis
displayName	string	Nazwa profilu jednostki usługi
id	string	Identyfikator profilu jednostki usługi