Condividi tramite


Groups - Update Group User

Aggiornamenti le autorizzazioni utente specificate per l'area di lavoro specificata.

Autorizzazioni

Questa chiamata API può essere chiamata da un profilo dell'entità servizio. Per altre informazioni, vedere: Profili dell'entità servizio in Power BI Embedded.

Ambito obbligatorio

Workspace.ReadWrite.All

Limitazioni

  • Le autorizzazioni utente per le aree di lavoro richiedono tempo per l'aggiornamento e potrebbero non essere immediatamente disponibili quando si usano chiamate API. Per aggiornare le autorizzazioni utente, usare la chiamata API Aggiorna autorizzazioni utente .

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
groupId
path True

string

uuid

ID area di lavoro

Corpo della richiesta

Nome Necessario Tipo Descrizione
groupUserAccessRight True

GroupUserAccessRight

Diritto di accesso (livello di autorizzazione) che un utente ha nell'area di lavoro

identifier True

string

Identificatore dell'entità

principalType True

PrincipalType

Tipo principale

displayName

string

Nome visualizzato dell'entità

emailAddress

string

Indirizzo di posta elettronica dell'utente

graphId

string

Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione.

profile

ServicePrincipalProfile

Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy.

userType

string

Tipo dell'utente.

Risposte

Nome Tipo Descrizione
200 OK

OK

Esempio

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

Definizioni

Nome Descrizione
GroupUser

Un utente di Power BI con accesso all'area di lavoro

GroupUserAccessRight

Diritto di accesso (livello di autorizzazione) che un utente ha nell'area di lavoro

PrincipalType

Tipo principale

ServicePrincipalProfile

Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy.

GroupUser

Un utente di Power BI con accesso all'area di lavoro

Nome Tipo Descrizione
displayName

string

Nome visualizzato dell'entità

emailAddress

string

Indirizzo di posta elettronica dell'utente

graphId

string

Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione.

groupUserAccessRight

GroupUserAccessRight

Diritto di accesso (livello di autorizzazione) che un utente ha nell'area di lavoro

identifier

string

Identificatore dell'entità

principalType

PrincipalType

Tipo principale

profile

ServicePrincipalProfile

Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy.

userType

string

Tipo dell'utente.

GroupUserAccessRight

Diritto di accesso (livello di autorizzazione) che un utente ha nell'area di lavoro

Nome Tipo Descrizione
Admin

string

Diritti di amministratore per il contenuto dell'area di lavoro

Contributor

string

Leggere ed esplorare (ReadExplore) l'accesso al contenuto dell'area di lavoro

Member

string

Leggi, ricondividi ed esplora (ReadReshareExplore) diritti di accesso al contenuto dell'area di lavoro

None

string

Nessun accesso al contenuto dell'area di lavoro

Viewer

string

Accesso di sola lettura (lettura) al contenuto dell'area di lavoro

PrincipalType

Tipo principale

Nome Tipo Descrizione
App

string

Tipo di entità servizio

Group

string

Tipo di entità gruppo

None

string

Nessun tipo di entità. Usare per l'accesso a livello di organizzazione intero.

User

string

Tipo di entità utente

ServicePrincipalProfile

Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy.

Nome Tipo Descrizione
displayName

string

Nome del profilo dell'entità servizio

id

string

ID profilo dell'entità servizio