Condividi tramite

Gateways - Add Datasource User

  • Riferimento
Service:
Power BI REST APIs
API Version:
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 (VNet) 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) di un utente nell'origine dati
displayName

string

Nome visualizzato dell'entità
emailAddress

string

L'indirizzo e-mail dell'utente
identifier

string

ID oggetto dell'entità
principalType

PrincipalType

Tipo di entità
profile

ServicePrincipalProfile

Profilo principale servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy.

Risposte

Nome Tipo Descrizione
200 OK

OK

Esempio

Assign the ReadOverrideEffectiveIdentity user access right to a service principal example
Example

Assign the ReadOverrideEffectiveIdentity user access right to a service principal example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users
Request Body
{
  "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
  "datasourceAccessRight": "ReadOverrideEffectiveIdentity"
}

Sample Response

Status code:
200

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users
Request Body
{
  "emailAddress": "john@contoso.com",
  "datasourceAccessRight": "Read"
}

Sample Response

Status code:
200

Definizioni

Nome Descrizione
DatasourceUser

Un utente di Power BI con accesso all'origine dati
DatasourceUserAccessRight

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

Tipo di entità
ServicePrincipalProfile

Profilo principale servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy.

DatasourceUser

Un utente di Power BI con accesso all'origine dati

Nome Tipo Descrizione
datasourceAccessRight

DatasourceUserAccessRight

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

string

Nome visualizzato dell'entità
emailAddress

string

L'indirizzo e-mail dell'utente
identifier

string

ID oggetto dell'entità
principalType

PrincipalType

Tipo di entità
profile

ServicePrincipalProfile

Profilo principale servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy.

DatasourceUserAccessRight

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

Nome Tipo Descrizione
None

string

Nessuna autorizzazione per accedere all'origine dati. Si applica solo quando si aggiornano le autorizzazioni utente.
Read

string

I set di dati di proprietà dell'utente hanno accesso in lettura all'origine dati
ReadOverrideEffectiveIdentity

string

L'utente può eseguire l'override dell'identità effettiva per Power BI Embedded. Applicabile solo per le origini dati di Analysis Services locali.

PrincipalType

Tipo di entità

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 intera organizzazione.
User

string

Tipo di entità utente

ServicePrincipalProfile

Profilo principale servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy.

Nome Tipo Descrizione
displayName

string

Nome del profilo dell'entità servizio
id

string

ID del profilo dell'entità servizio