Udostępnij za pośrednictwem


Groups - Update Group User

Aktualizacje określonych uprawnień użytkownika 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 Power BI Embedded.

Zakres wymagany

Workspace.ReadWrite.All

Ograniczenia

PUT 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ó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

Assign administrator user access rights to a service principal example
Example

Assign administrator user access rights to a service principal example

Sample Request

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

Sample Response

Example

Sample Request

PUT https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users
{
  "emailAddress": "john@contoso.com",
  "groupUserAccessRight": "Admin"
}

Sample Response

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