Condividi tramite

Datasets - Put Dataset User In Group

  • Riferimento
Servizio:
Power BI REST APIs
Versione API:
v1.0

Aggiornamenti le autorizzazioni del set di dati esistenti 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 le 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 in Autorizzazioni set di dati.

Limitazioni

  • L'aggiornamento delle autorizzazioni per le entità servizio (principalType dell'app) non è supportato
  • 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.
  • 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 e i membri delle cartelle, l'autorizzazione ReadWriteReshareExplore per i set di dati della cartella viene ereditata. Per i collaboratori alle cartelle, l'autorizzazione ReadWriteExplore per i set di dati della cartella viene ereditata. Per i visualizzatori di cartelle, l'autorizzazione Lettura per i set di dati della cartella viene ereditata. 

PUT https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/users

Parametri dell'URI

Nome In Necessario Tipo Descrizione
datasetId
 path True

string

ID del set di dati
groupId
 path True

string

uuid

ID area di lavoro

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

PrincipalType

Tipo di entità

Risposte

Nome Tipo Descrizione
200 OK

OK

Esempio

Example
Example for updating security group dataset permissions to ReadExplore

Example

Esempio di richiesta

PUT https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users
Corpo della richiesta
{
  "identifier": "john@contoso.com",
  "principalType": "User",
  "datasetUserAccessRight": "Read"
}

Risposta di esempio

Codice di stato:
200

Example for updating security group dataset permissions to ReadExplore

Esempio di richiesta

PUT https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users
Corpo della richiesta
{
  "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "principalType": "Group",
  "datasetUserAccessRight": "ReadReshare"
}

Risposta di esempio

Codice di stato:
200

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

PrincipalType

Tipo di entità

DatasetUserAccessRight

Enumeration

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
ReadExplore

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

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

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

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

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

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

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

PrincipalType

Enumeration

Tipo di entità

Valore Descrizione
App

Tipo di entità servizio
Group

Tipo di entità gruppo
None

Nessun tipo di entità. Usare per l'accesso a livello di intera organizzazione.
User

Tipo di entità utente