Datasets - Put Dataset User

Service:

Power BI REST APIs

API Version:

v1.0

Aggiornamenti le autorizzazioni esistenti del set di dati dell'utente specificato per le autorizzazioni specificate.

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 . Questa chiamata API può essere usata per rimuovere tutte le autorizzazioni del set di dati dell'utente specificato usando datasetUserAccessRight: None

Ambito obbligatorio

Dataset.ReadWrite.All

Autorizzazioni

Le autorizzazioni per questa chiamata API sono elencate nelle autorizzazioni Set di dati.

Limitazioni

• L'aggiornamento delle autorizzazioni alle entità servizio (entità app) non è supportato
• Il chiamante deve disporre delle autorizzazioni ReadWriteReshare nel set di dati. Ovvero, amministratori delle cartelle, membri e collaboratori con autorizzazioni di ricondividizione o proprietari di set di dati.
• Questa API non può essere usata per aggiungere o rimuovere l'autorizzazione di scrittura .
• Questa API non può essere usata per rimuovere le autorizzazioni ereditate a livello di cartella. Per gli amministratori delle cartelle e i membri, l'autorizzazione ReadWriteReshareExplore per i set di dati della cartella viene ereditata. Per i collaboratori delle cartelle, l'autorizzazione ReadWriteExplore per i set di dati della cartella viene ereditata. Per i visualizzatori di cartelle, viene ereditata l'autorizzazione Lettura per i set di dati della cartella.
  
  

PUT 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

Corpo della richiesta

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

Risposte

Nome	Tipo	Descrizione
200 OK		OK

Esempio

Example

Example for updating security group dataset permissions to ReadExplore

Example

Sample Request

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

Request Body

{
  "identifier": "john@contoso.com",
  "principalType": "User",
  "datasetUserAccessRight": "Read"
}

Sample Response

Status code:

200

Example for updating security group dataset permissions to ReadExplore

Sample Request

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

Request Body

{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "principalType": "Group",
  "datasetUserAccessRight": "ReadReshare"
}

Sample Response

Status code:

200

Definizioni

Nome	Descrizione
DatasetUserAccess	Voce di accesso a un'entità Power BI per un set di dati
DatasetUserAccessRight	Diritto di accesso che l'utente ha per il set di dati (livello di autorizzazione)
PrincipalType	Tipo principale

DatasetUserAccess

Voce di accesso a un'entità 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 principale User, specificare l'UPN. In caso contrario, specificare l'ID oggetto dell'entità.
principalType	PrincipalType	Tipo principale

DatasetUserAccessRight

Diritto di accesso che 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 rishare al contenuto nel set di dati
ReadReshareExplore	string	Concede lettura, ricondividi e Esplora l'accesso 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 esplora 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 lettura, scrittura, ricondividi e esplora l'accesso al contenuto nel set di dati

PrincipalType

Tipo principale

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 organizzazione intero.
User	string	Tipo di entità utente