Condividi tramite


Datasets - Get Dataset Users

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 le chiamate API. Per aggiornare le autorizzazioni utente, usare la chiamata API Aggiorna autorizzazioni utente .

Autorizzazioni

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 del set di dati

Risposte

Nome Tipo Descrizione
200 OK

DatasetUsersAccess

OK

Esempio

Example

Sample Request

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

Sample Response

{
  "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

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 Userentità specificare l'UPN. In caso contrario, specificare l'ID oggetto dell'entità.

principalType

PrincipalType

Tipo di entità

DatasetUserAccessRight

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

Nome Tipo Descrizione
None

string

Rimuove l'autorizzazione per il contenuto nel set di dati

Read

string

Concede l'accesso in lettura al contenuto nel set di dati

ReadExplore

string

Concede l'accesso in lettura ed esplora al contenuto nel set di dati

ReadReshare

string

Concede l'accesso in lettura e ricondivisione al contenuto nel set di dati

ReadReshareExplore

string

Concede l'accesso in lettura, ricondivisione ed esplora al contenuto nel set di dati

ReadWrite

string

Concede l'accesso in lettura e scrittura al contenuto nel set di dati

ReadWriteExplore

string

Concede l'accesso in lettura, scrittura ed esplorazione al contenuto nel set di dati

ReadWriteReshare

string

Concede l'accesso in lettura, scrittura e ricondividi al contenuto nel set di dati

ReadWriteReshareExplore

string

Concede l'accesso in lettura, scrittura, ricondivisione ed esplora al contenuto nel set di dati

DatasetUsersAccess

Wrapper di risposta OData per un elenco di entità di Power BI con accesso a un set di dati

Nome Tipo Descrizione
odata.context

string

value

DatasetUserAccess[]

Elenco di utenti con accesso a un set di 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