Gateways - Get Datasource Users

Riferimento

Servizio:: Power BI REST APIs

Versione API:: v1.0

Restituisce un elenco di utenti che hanno accesso all'origine dati specificata.

Autorizzazioni

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

Ambito obbligatorio

Dataset.ReadWrite.All o Dataset.Read.All

Limitazioni

I gateway di rete virtuale (VNet) non sono supportati.

GET 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.

Risposte

Nome	Tipo	Descrizione
200 OK	DatasourceUsers	OK

Esempio

Example

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 200

{
  "value": [
    {
      "datasourceAccessRight": "Read",
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "identifier": "john@contoso.com",
      "principalType": "User"
    },
    {
      "datasourceAccessRight": "ReadOverrideEffectiveIdentity",
      "displayName": "ContosoTestApp",
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App"
    }
  ]
}

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
DatasourceUsers	Wrapper di risposta OData per un elenco di utenti di Power BI con accesso a un'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.

DatasourceUsers

Wrapper di risposta OData per un elenco di utenti di Power BI con accesso a un'origine dati

Nome	Tipo	Descrizione
odata.context	string
value	DatasourceUser[]	Elenco di utenti con accesso a un'origine dati

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

Condividi tramite