Udostępnij przez

Admin - Groups AddUserAsAdmin

Usługa:
Power BI REST APIs
Wersja interfejsu API:
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.

Permissions

Użytkownik musi być administratorem sieci szkieletowej.

Wymagany zakres

Tenant.ReadWrite.All

Ograniczenia

  • Maksymalna liczba żądań na godzinę wynosi 200.
  • Każdy obszar roboczy jest ograniczony do maksymalnie 1000 użytkowników lub grup w rolach obszaru roboczego (administrator, członek, współautor, osoba przeglądająca). Liczba użytkowników w grupie nie jest ograniczona. Ograniczenie obejmuje również gości zewnętrznych. 

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óry 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 administratorów.
profile

ServicePrincipalProfile

Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania z wieloma dzierżawami usługi Power BI Embedded.
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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:
200

Add service principal to workspace example

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:
200

Add user to group example

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:
200

Definicje

Nazwa Opis
GroupUser

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

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

Typ podmiotu zabezpieczeń
ServicePrincipalProfile

Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania z wieloma dzierżawami usługi Power BI Embedded.

GroupUser

Objekt

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 administratorów.
groupUserAccessRight

GroupUserAccessRight

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

string

Identyfikator podmiotu zabezpieczeń
principalType

PrincipalType

Typ podmiotu zabezpieczeń
profile

ServicePrincipalProfile

Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania z wieloma dzierżawami usługi Power BI Embedded.
userType

string

Typ użytkownika.

GroupUserAccessRight

Wyliczanie

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

Wartość Opis
None

Brak dostępu do zawartości obszaru roboczego
Member

Odczyt, ponowne udostępnianie i eksplorowanie (ReadReshareExplore) praw dostępu do zawartości obszaru roboczego
Admin

Uprawnienia administratora do zawartości obszaru roboczego
Contributor

Odczyt i eksplorowanie (ReadExplore) dostęp do zawartości obszaru roboczego
Viewer

Dostęp tylko do odczytu (odczyt) do zawartości obszaru roboczego

PrincipalType

Wyliczanie

Typ podmiotu zabezpieczeń

Wartość Opis
None

Brak typu podmiotu zabezpieczeń. Służy do uzyskiwania dostępu na poziomie całej organizacji.
User

Typ podmiotu zabezpieczeń użytkownika
Group

Typ podmiotu zabezpieczeń grupy
App

Typ jednostki usługi

ServicePrincipalProfile

Objekt

Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania z wieloma dzierżawami usługi Power BI Embedded.

Nazwa Typ Opis
displayName

string

Nazwa profilu jednostki usługi
id

string (uuid)

Identyfikator profilu jednostki usługi