Datasets - Get Dataset Users

Servizio:: Power BI REST APIs

Versione API:: v1.0

Restituisce un elenco di entità che hanno accesso al set di dati specificato.

Quando le autorizzazioni utente per un set di dati sono state aggiornate di recente, le nuove autorizzazioni potrebbero non essere immediatamente disponibili tramite chiamate API. Per aggiornare le autorizzazioni utente, usare la chiamata API Aggiorna autorizzazioni utente .

Permissions

Le autorizzazioni per questa chiamata API sono elencate in Autorizzazioni set di dati.

Ambito obbligatorio

Dataset.Read.All o Dataset.ReadWrite.All

Limitazioni

Il chiamante deve disporre delle autorizzazioni ReadWriteReshare per il set di dati. ovvero amministratori di cartelle, membri e collaboratori con autorizzazioni di ricondividi o proprietari di set di dati.

GET https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/users

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
datasetId	path	True	string	ID set di dati

Risposte

Nome	Tipo	Descrizione
200 OK	DatasetUsersAccess	Va bene

Esempio

Example

Esempio di richiesta

GET https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

Risposta di esempio

Codice di stato:: 200

{
  "value": [
    {
      "identifier": "john@contoso.com",
      "principalType": "User",
      "datasetUserAccessRight": "Read"
    },
    {
      "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
      "principalType": "Group",
      "datasetUserAccessRight": "ReadReshare"
    },
    {
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App",
      "datasetUserAccessRight": "ReadWriteReshareExplore"
    }
  ]
}

Definizioni

Nome	Descrizione
DatasetUserAccess	Immissione del diritto di accesso dell'entità di Power BI per un set di dati
DatasetUserAccessRight	Diritto di accesso a cui l'utente ha per il set di dati (livello di autorizzazione)
DatasetUsersAccess	Wrapper di risposta OData per un elenco di entità di Power BI con accesso a un set di dati
PrincipalType	Tipo di entità

DatasetUserAccess

Object

Immissione del diritto di accesso dell'entità di Power BI per un set di dati

Nome	Tipo	Descrizione
datasetUserAccessRight	DatasetUserAccessRight	Diritti di accesso da assegnare all'utente per il set di dati (livello di autorizzazione)
identifier	string	Per il tipo di `User`entità specificare l'UPN. In caso contrario, specificare l'ID oggetto dell'entità.
principalType	PrincipalType	Tipo di entità

DatasetUserAccessRight

Enumerazione

Diritto di accesso a cui l'utente ha per il set di dati (livello di autorizzazione)

Valore	Descrizione
None	Rimuove l'autorizzazione per il contenuto nel set di dati
Read	Concede l'accesso in lettura al contenuto nel set di dati
ReadWrite	Concede l'accesso in lettura e scrittura al contenuto nel set di dati
ReadReshare	Concede l'accesso in lettura e ricondivisione al contenuto nel set di dati
ReadWriteReshare	Concede l'accesso in lettura, scrittura e ricondivisione al contenuto nel set di dati
ReadExplore	Concede l'accesso in lettura ed esplora al contenuto nel set di dati
ReadReshareExplore	Concede l'accesso in lettura, ricondivisione ed esplora al contenuto nel set di dati
ReadWriteExplore	Concede l'accesso in lettura, scrittura ed esplorazione al contenuto nel set di dati
ReadWriteReshareExplore	Concede l'accesso al contenuto nel set di dati di lettura, scrittura, ricondivisione ed esplora

DatasetUsersAccess