Groups - Add Group User

  • Riferimento
Service:
Power BI REST APIs
API Version:
v1.0

Concede all'utente specificato le autorizzazioni specificate all'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 . 

POST 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

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

Sample Response

Status code:
200

Example

Sample Request

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

Sample Response

Status code:
200

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