Datasets - Post Dataset User

Service:

Power BI REST APIs

API Version:

v1.0

Accorde les autorisations de l’utilisateur spécifié au jeu de données spécifié.

Lorsque des 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 d’API Actualiser les autorisations utilisateur .

Étendue requise

Dataset.ReadWrite.All

Limites

• L’ajout d’autorisations aux principaux de service (app principalType) n’est pas pris en charge
• L’appelant doit disposer d’autorisations ReadReshare sur le jeu de données.
• Cet appel d’API ne peut pas être utilisé pour accorder l’autorisation d’écriture du jeu de données sur le jeu de données
  
  

POST 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	DatasetUserAccessRightEntry	Obligatoire. Droit d’accès à accorder à l’utilisateur pour le jeu de données.
identifier	True	string	Pour le type Userprincipal, fournissez 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 granting ReadExplore right to a security group

Example

Sample Request

POST 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 granting ReadExplore right to a security group

Sample Request

POST 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
DatasetUserAccessRightEntry	Obligatoire. Droit d’accès à accorder à l’utilisateur pour le jeu de données.
PostDatasetUserAccess	Entrée de droit d’accès utilisateur Power BI pour un jeu de données
PrincipalType	Type de principal

DatasetUserAccessRightEntry

Obligatoire. Droit d’accès à accorder à l’utilisateur pour le jeu de données.

Nom	Type	Description
Read	string	Octroie l’accès en lecture au contenu dans le jeu de données
ReadExplore	string	Octroie l’accès en lecture et explorer au contenu dans le jeu de données
ReadReshare	string	Accorde l’accès en lecture et repartage au contenu dans le jeu de données
ReadReshareExplore	string	Octroie l’accès en lecture, repartage et Explorer le contenu dans le jeu de données

PostDatasetUserAccess

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

Nom	Type	Description
datasetUserAccessRight	DatasetUserAccessRightEntry	Obligatoire. Droit d’accès à accorder à l’utilisateur pour le jeu de données.
identifier	string	Pour le type Userprincipal, fournissez l’UPN. Sinon, fournissez l’ID d’objet du principal.
principalType	PrincipalType	Type de principal

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 principal. Utiliser pour l’ensemble de l’accès au niveau de l’organisation.
User	string	Type de principal de l’utilisateur