Admin - Datasets GetDatasetUsersAsAdmin

Référence

Service:: Power BI REST APIs

API Version:: v1.0

Retourne une liste d’utilisateurs qui ont accès au jeu de données spécifié.

Autorisations

L’utilisateur doit disposer de droits d’administrateur (tels que Office 365 administrateur général ou administrateur de service Power BI) ou s’authentifier à l’aide d’un principal de service.
Les autorisations déléguées sont prises en charge.
Les autorisations pour cet appel d’API sont répertoriées dans Autorisations jeux de données.

Lors de l’exécution sous l’authentification prinicipal de service, une application ne doit pas avoir de prémissions requises de consentement administrateur pour Power BI définies sur elle dans le Portail Azure.

Étendue requise

Tenant.Read.All ou Tenant.ReadWrite.All

Pertinent uniquement lors de l’authentification via un jeton d’accès administrateur délégué standard. Ne doit pas être présent lors de l’utilisation de l’authentification via un principal de service.

Limites

Maximum 200 requêtes par heure.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
datasetId	path	True	string uuid	ID du jeu de données

Réponses

Nom	Type	Description
200 OK	DatasetUsers	OK

Exemples

Example

Sample Request

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

Sample Response

Status code:: 200

{
  "value": [
    {
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "datasetUserAccessRight": "ReadWriteReshareExplore",
      "identifier": "john@contoso.com",
      "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
      "principalType": "User"
    }
  ]
}

Définitions

Nom	Description
DatasetUser	Entrée de droit d’accès utilisateur 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)
DatasetUsers	Wrapper de réponse OData pour une liste d’utilisateurs Power BI ayant accès à un jeu de données
PrincipalType	Type principal
ServicePrincipalProfile	Profil principal service Power BI. Ne concerne que Power BI Embedded solution multilocataire.

DatasetUser

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

Nom	Type	Description
datasetUserAccessRight	DatasetUserAccessRight	Droit d’accès dont dispose l’utilisateur pour le jeu de données (niveau d’autorisation)
displayName	string	Nom d’affichage du principal
emailAddress	string	Adresse e-mail de l’utilisateur
graphId	string	Identificateur du principal dans Microsoft Graph. Disponible uniquement pour les API d’administration.
identifier	string	Identificateur du principal
principalType	PrincipalType	Type principal
profile	ServicePrincipalProfile	Profil principal service Power BI. Ne concerne que Power BI Embedded solution multilocataire.
userType	string	Type de l’utilisateur.

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 sur le contenu dans le jeu de données
Read	string	Octroie l’accès en lecture au contenu dans le jeu de données
ReadExplore	string	Octroie l’accès lecture et exploration au contenu dans le jeu de données
ReadReshare	string	Octroie l’accès en lecture et en partage au contenu dans le jeu de données
ReadReshareExplore	string	Octroie l’accès en lecture, partage et exploration au contenu du 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 au contenu du jeu de données
ReadWriteReshareExplore	string	Octroie l’accès en lecture, écriture, partage et exploration au contenu du jeu de données

DatasetUsers

Wrapper de réponse OData pour une liste d’utilisateurs Power BI ayant accès à un jeu de données

Nom	Type	Description
odata.context	string
value	DatasetUser[]	Liste des utilisateurs ayant accès à un jeu de données

PrincipalType

Type principal

Nom	Type	Description
App	string	Type de principal de service
Group	string	Type de principal de groupe
None	string	Aucun type principal. Utilisez pour l’accès au niveau de l’organisation entière.
User	string	Type de principal d’utilisateur

ServicePrincipalProfile

Profil principal service Power BI. Ne concerne que Power BI Embedded solution multilocataire.

Nom	Type	Description
displayName	string	Nom du profil principal de service
id	string	ID de profil du principal de service