Gateways - Add Datasource User

Servizio:

Power BI REST APIs

Versione API:

v1.0

Concede o aggiorna le autorizzazioni necessarie per usare l'origine dati specificata per l'utente specificato.

Autorizzazioni

L'utente deve disporre delle autorizzazioni di amministratore del gateway.

Ambito obbligatorio

Dataset.ReadWrite.All

Limitazioni

I gateway di rete virtuale non sono supportati. L'aggiunta di gruppi tramite l'API non è supportata.

POST https://api.powerbi.com/v1.0/myorg/gateways/{gatewayId}/datasources/{datasourceId}/users

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
datasourceId	path	True	string (uuid)	ID origine dati
gatewayId	path	True	string (uuid)	ID gateway. Quando si usa un cluster gateway, l'ID gateway fa riferimento al gateway primario (primo) nel cluster. In questi casi, l'ID gateway è simile all'ID cluster del gateway.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
datasourceAccessRight	True	DatasourceUserAccessRight	Diritto di accesso (livello di autorizzazione) dell'utente nell'origine dati
displayName		string	Nome visualizzato dell'entità
emailAddress		string	Indirizzo di posta elettronica dell'utente
identifier		string	ID oggetto dell'entità
principalType		PrincipalType	Tipo di entità
profile		ServicePrincipalProfile	Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.

Risposte

Nome	Tipo	Descrizione
200 OK		Va bene

Esempio

Assign the ReadOverrideEffectiveIdentity user access right to a service principal example

Example

Assign the ReadOverrideEffectiveIdentity user access right to a service principal example

Esempio di richiesta

POST https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users

Corpo della richiesta

{
  "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
  "datasourceAccessRight": "ReadOverrideEffectiveIdentity"
}

Risposta di esempio

Codice di stato:

200

Example

Esempio di richiesta

POST https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users

Corpo della richiesta

{
  "emailAddress": "john@contoso.com",
  "datasourceAccessRight": "Read"
}

Risposta di esempio

Codice di stato:

200

Definizioni

Nome	Descrizione
DatasourceUser	Un utente di Power BI con accesso all'origine dati
DatasourceUserAccessRight	Diritto di accesso (livello di autorizzazione) dell'utente nell'origine dati
PrincipalType	Tipo di entità
ServicePrincipalProfile	Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.

DatasourceUser

Object

Un utente di Power BI con accesso all'origine dati

Nome	Tipo	Descrizione
datasourceAccessRight	DatasourceUserAccessRight	Diritto di accesso (livello di autorizzazione) dell'utente nell'origine dati
displayName	string	Nome visualizzato dell'entità
emailAddress	string	Indirizzo di posta elettronica dell'utente
identifier	string	ID oggetto dell'entità
principalType	PrincipalType	Tipo di entità
profile	ServicePrincipalProfile	Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.

DatasourceUserAccessRight

Enumerazione

Diritto di accesso (livello di autorizzazione) dell'utente nell'origine dati

Valore	Descrizione
None	Nessuna autorizzazione per accedere all'origine dati. Si applica solo quando si aggiornano le autorizzazioni utente.
Read	I set di dati di proprietà dell'utente hanno accesso in lettura all'origine dati
ReadOverrideEffectiveIdentity	L'utente può eseguire l'override dell'identità effettiva per Power BI Embedded. Applicabile solo per le origini dati di Analysis Services locali.

PrincipalType

Enumerazione

Tipo di entità

Valore	Descrizione
None	Nessun tipo di entità. Usare per l'accesso a livello di organizzazione intero.
User	Tipo di entità utente
Group	Tipo di entità gruppo
App	Tipo di entità servizio

ServicePrincipalProfile

Object

Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.

Nome	Tipo	Descrizione
displayName	string	Nome del profilo dell'entità servizio
id	string (uuid)	ID del profilo dell'entità servizio