Partager via

Datasets - Post Dataset User In Group

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

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

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 .

É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/groups/{groupId}/datasets/{datasetId}/users

Paramètres URI

Nom Dans Obligatoire Type Description
datasetId
 path True

string

ID du jeu de données
groupId
 path True

string

uuid

L’ID de l’espace de travail

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

Example

Exemple de requête

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

Exemple de réponse

Code d’état:
200

Example for granting ReadExplore right to a security group

Exemple de requête

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

Exemple de réponse

Code d’état:
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

Enumeration

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

Valeur Description
Read

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

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

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

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

PostDatasetUserAccess

Object

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 Userde principal, indiquez l’UPN. Sinon, fournissez l’ID d’objet du principal.
principalType

PrincipalType

Type de principal

PrincipalType

Enumeration

Type de principal

Valeur Description
App

Type de principal de service
Group

Type de principal de groupe
None

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

Type d’utilisateur principal