Udostępnij przez

Groups - Add Group User

Usługa:
Power BI REST APIs
Wersja interfejsu API:
v1.0

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

Uprawnienia

To wywołanie interfejsu API może być wywoływane przez profil jednostki usługi. Aby uzyskać więcej informacji, zobacz: profile jednostki usługi w usłudze Power BI Embedded.

Wymagany zakres

Workspace.ReadWrite.All

Ograniczenia

  • Czas aktualizacji uprawnień użytkownika dla obszarów roboczych i może nie być natychmiast dostępny podczas korzystania z wywołań interfejsu API. Aby odświeżyć uprawnienia użytkownika, użyj wywołania interfejsu API Odśwież uprawnienia użytkownika.
  • 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/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 wielodostępu usługi Power BI Embedded.
userType

string

Typ użytkownika.

Odpowiedzi

Nazwa Typ Opis
200 OK

OK

Przykłady

Assign administrator user access rights to a service principal example
Example

Assign administrator user access rights to a service principal example

Przykładowe żądanie

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users
Treść żądania
{
  "identifier": "1f69e798-5852-4fdd-ab01-33bb14b6e934",
  "groupUserAccessRight": "Admin",
  "principalType": "App"
}

Przykładowa odpowiedź

Kod stanu:
200

Example

Przykładowe żądanie

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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 wielodostępu 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 wielodostępu 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 wielodostępu usługi Power BI Embedded.

Nazwa Typ Opis
displayName

string

Nazwa profilu jednostki usługi
id

string (uuid)

Identyfikator profilu jednostki usługi