Datasets - Get Dataset Users

Service:: Power BI REST APIs

Version d'API:: v1.0

Retourne une liste de principaux qui ont accès 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 par le biais d’appels d’API. Pour actualiser les autorisations utilisateur, utilisez l’appel de l’API Actualiser les autorisations utilisateur .

Permissions

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

Étendue requise

Dataset.Read.All ou Dataset.ReadWrite.All

Limites

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 partage ou de propriétaires de jeux de données.

GET 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

Réponses

Nom	Type	Description
200 OK	DatasetUsersAccess	Ok

Exemples

Example

Exemple de requête

GET https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/users

Exemple de réponse

Code d’état:: 200

{
  "value": [
    {
      "identifier": "john@contoso.com",
      "principalType": "User",
      "datasetUserAccessRight": "Read"
    },
    {
      "identifier": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
      "principalType": "Group",
      "datasetUserAccessRight": "ReadReshare"
    },
    {
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App",
      "datasetUserAccessRight": "ReadWriteReshareExplore"
    }
  ]
}

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 que l’utilisateur a pour le jeu de données (niveau d’autorisation)
DatasetUsersAccess	Wrapper de réponse OData pour une liste de principaux Power BI ayant accès à un jeu de données
PrincipalType	Type de principal

DatasetUserAccess

Object

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 `User`principal, indiquez l’UPN. Sinon, fournissez l’ID d’objet du principal.
principalType	PrincipalType	Type de principal

DatasetUserAccessRight

Énumération

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

Valeur	Description
None	Supprime l’autorisation du contenu dans le jeu de données
Read	Octroie l’accès en lecture au contenu dans le jeu de données
ReadWrite	Octroie l’accès en lecture et écriture au contenu du jeu de données
ReadReshare	Accorde l’accès en lecture et repartage au contenu du jeu de données
ReadWriteReshare	Accorde l’accès en lecture, écriture et partage à nouveau au contenu du jeu de données
ReadExplore	Octroie l’accès en lecture et explorer au contenu du jeu de données
ReadReshareExplore	Accorde l’accès en lecture, repartage et exploration du contenu dans le jeu de données
ReadWriteExplore	Accorde l’accès en lecture, écriture et exploration au contenu du jeu de données
ReadWriteReshareExplore	Accorde l’accès en lecture, écriture, partage et exploration du contenu dans le jeu de données

DatasetUsersAccess