Condividi tramite

Datasets - Post Dataset User

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

Concede le autorizzazioni dell'utente specificato 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 .

Ambito obbligatorio

Dataset.ReadWrite.All

Limitazioni

  • L'aggiunta di autorizzazioni alle entità servizio (principalType app) non è supportata
  • Il chiamante deve disporre delle autorizzazioni ReadReshare per il set di dati.
  • Questa chiamata API non può essere usata per concedere l'autorizzazione di scrittura del set di dati per il set di dati

POST 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

DatasetUserAccessRightEntry

Obbligatorio. Diritto di accesso da concedere all'utente per il set di dati.
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 granting ReadExplore right to a security group

Example

Esempio di richiesta

POST https://api.powerbi.com/v1.0/myorg/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 granting ReadExplore right to a security group

Esempio di richiesta

POST https://api.powerbi.com/v1.0/myorg/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
DatasetUserAccessRightEntry

Obbligatorio. Diritto di accesso da concedere all'utente per il set di dati.
PostDatasetUserAccess

Immissione del diritto di accesso utente di Power BI per un set di dati
PrincipalType

Tipo di entità

DatasetUserAccessRightEntry

Enumeration

Obbligatorio. Diritto di accesso da concedere all'utente per il set di dati.

Valore Descrizione
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

PostDatasetUserAccess

Object

Immissione del diritto di accesso utente di Power BI per un set di dati

Nome Tipo Descrizione
datasetUserAccessRight

DatasetUserAccessRightEntry

Obbligatorio. Diritto di accesso da concedere all'utente per il set di dati.
identifier

string

Per il tipo di Userentità specificare l'UPN. In caso contrario, specificare l'ID oggetto dell'entità.
principalType

PrincipalType

Tipo di entità

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