Admin - Groups AddUserAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Concede le autorizzazioni utente all'area di lavoro specificata.

Questa chiamata API supporta solo l'aggiunta di un utente, un gruppo di sicurezza, un gruppo M365 e un'entità servizio.

Autorizzazioni

L'utente deve avere diritti di amministratore, ad esempio Office 365 amministratore globale o amministratore del servizio Power BI.

Ambito obbligatorio

Tenant.ReadWrite.All

Limitazioni

Massimo 200 richieste all'ora.

POST https://api.powerbi.com/v1.0/myorg/admin/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

Add security group to workspace example

Add service principal to workspace example

Add user to group example

Add security group to workspace example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/admin/groups/206d27ca-94e8-4a69-855b-5c32bdd458a8/users

Request Body

{
  "identifier": "ece007fa-2f19-4df1-bdd5-539881ec5f83",
  "principalType": "Group",
  "groupUserAccessRight": "Member"
}

Sample Response

Status code:

200

Add service principal to workspace example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/admin/groups/206d27ca-94e8-4a69-855b-5c32bdd458a8/users

Request Body

{
  "identifier": "84c468ad-12f1-471e-af6f-0999da422391",
  "principalType": "App",
  "groupUserAccessRight": "Viewer"
}

Sample Response

Status code:

200

Add user to group example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/admin/groups/206d27ca-94e8-4a69-855b-5c32bdd458a8/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