Datasets - Put Dataset User

  • Référence
Service:
Power BI REST APIs
API Version:
v1.0

Met à jour les autorisations de jeu de données existantes de l’utilisateur spécifié avec les autorisations spécifiées.

Lorsque les autorisations utilisateur sur un jeu de données ont été récemment mises à jour, les nouvelles autorisations peuvent ne pas être immédiatement disponibles via des appels d’API. Pour actualiser les autorisations utilisateur, utilisez l’appel de l’API Actualiser les autorisations utilisateur . Cet appel d’API peut être utilisé pour supprimer toutes les autorisations de jeu de données de l’utilisateur spécifié à l’aide de datasetUserAccessRight: None

Étendue requise

Dataset.ReadWrite.All

Autorisations

Les autorisations pour cet appel d’API sont répertoriées dans les autorisations jeux de données.

Limites

  • La mise à jour des autorisations sur les principaux de service (app principalType) n’est pas prise en charge
  • L’appelant doit disposer d’autorisations ReadWriteReshare sur le jeu de données. Autrement dit, les administrateurs de dossiers, les membres et les contributeurs disposant d’autorisations de repartage ou de propriétaires de jeux de données.
  • Cette API ne peut pas être utilisée pour ajouter ou supprimer l’autorisation d’écriture .
  • Cette API ne peut pas être utilisée pour supprimer les autorisations héritées au niveau du dossier. Pour les administrateurs de dossiers et les membres, l’autorisation ReadWriteReshareExplore sur les jeux de données du dossier est héritée. Pour les contributeurs de dossiers, l’autorisation ReadWriteExplore sur les jeux de données du dossier est héritée. Pour les visionneuses de dossiers, l’autorisation lecture sur les jeux de données du dossier est héritée. 

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

Paramètres URI

Nom Dans Obligatoire Type Description
datasetId
 path True

string

ID du jeu de données

Corps de la demande

Nom Obligatoire Type Description
datasetUserAccessRight True

DatasetUserAccessRight

Droits d’accès à affecter à l’utilisateur pour le jeu de données (niveau d’autorisation)
identifier True

string

Pour le type Userde principal, indiquez l’UPN. Sinon, fournissez l’ID d’objet du principal.
principalType True

PrincipalType

Type de principal

Réponses

Nom Type Description
200 OK

Ok

Exemples

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

Définitions

Nom Description
DatasetUserAccess

Entrée de droit d’accès du principal Power BI pour un jeu de données
DatasetUserAccessRight

Droit d’accès dont dispose l’utilisateur pour le jeu de données (niveau d’autorisation)
PrincipalType

Type de principal

DatasetUserAccess

Entrée de droit d’accès du principal Power BI pour un jeu de données

Nom Type Description
datasetUserAccessRight

DatasetUserAccessRight

Droits d’accès à affecter à l’utilisateur pour le jeu de données (niveau d’autorisation)
identifier

string

Pour le type Userde principal, indiquez l’UPN. Sinon, fournissez l’ID d’objet du principal.
principalType

PrincipalType

Type de principal

DatasetUserAccessRight

Droit d’accès dont dispose l’utilisateur pour le jeu de données (niveau d’autorisation)

Nom Type Description
None

string

Supprime l’autorisation du contenu dans le jeu de données
Read

string

Octroie l’accès en lecture au contenu du jeu de données
ReadExplore

string

Octroie l’accès en lecture et explorer au contenu du jeu de données
ReadReshare

string

Octroie l’accès en lecture et repartage au contenu du jeu de données
ReadReshareExplore

string

Octroie des autorisations de lecture, de partage et d’exploration de l’accès au contenu dans le jeu de données
ReadWrite

string

Octroie l’accès en lecture et en écriture au contenu du jeu de données
ReadWriteExplore

string

Octroie l’accès en lecture, écriture et exploration au contenu du jeu de données
ReadWriteReshare

string

Octroie l’accès en lecture, écriture et repartage du contenu dans le jeu de données
ReadWriteReshareExplore

string

Octroie l’accès en lecture, écriture, repartage et exploration du contenu dans le jeu de données

PrincipalType

Type de principal

Nom Type Description
App

string

Type de principal de service
Group

string

Type de principal de groupe
None

string

Aucun type de principal. Utiliser pour l’ensemble de l’accès au niveau de l’organisation.
User

string

Type d’utilisateur principal