Datasets - Post Dataset User In Group

Service:

Power BI REST APIs

API Version:

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 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 (entità app) non è supportata
• Il chiamante deve disporre delle autorizzazioni ReadReshare nel set di dati.
• Questa chiamata API non può essere usata per concedere l'autorizzazione di scrittura del set di dati nel set di dati
  
  

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

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

Request Body

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

Sample Response

Status code:

200

Example for granting ReadExplore right to a security group

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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
DatasetUserAccessRightEntry	Obbligatorio. Diritto di accesso per concedere all'utente per il set di dati.
PostDatasetUserAccess	Voce a destra dell'accesso utente di Power BI per un set di dati
PrincipalType	Tipo principale

DatasetUserAccessRightEntry

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

Nome	Tipo	Descrizione
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

PostDatasetUserAccess

Voce a destra dell'accesso utente di Power BI per un set di dati

Nome	Tipo	Descrizione
datasetUserAccessRight	DatasetUserAccessRightEntry	Obbligatorio. Diritto di accesso per concedere all'utente per il set di dati.
identifier	string	Per il tipo principale User, specificare l'UPN. In caso contrario, specificare l'ID oggetto dell'entità.
principalType	PrincipalType	Tipo principale

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