Partager via

Admin - Datasets GetDatasetUsersAsAdmin

Service:
Power BI REST APIs
Version d'API:
v1.0

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

Permissions

  • L’utilisateur doit être un administrateur Fabric 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 les autorisations jeux de données.

Lors de l’exécution sous l’authentification prinicipal du service, une application ne doit pas avoir de prémissions requises par l’administrateur pour Power BI définie sur celle-ci dans le portail Azure.

Étendue requise

Tenant.Read.All ou Tenant.ReadWrite.All

Applicable uniquement lors de l’authentification via un jeton d’accès administrateur délégué standard. Ne doit pas être présent lorsque l’authentification via un principal de service est utilisée.

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

Exemple de requête

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

Exemple de réponse

Code d’état:
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 que l’utilisateur a 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 de principal
ServicePrincipalProfile

Profil de principal du service Power BI. Uniquement pertinent pour la solution multilocataire Power BI Embedded.

DatasetUser

Object

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 que l’utilisateur a pour le jeu de données (niveau d’autorisation)
displayName

string

Nom complet 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 de principal
profile

ServicePrincipalProfile

Profil de principal du service Power BI. Uniquement pertinent pour la solution multilocataire Power BI Embedded.
userType

string

Type de l’utilisateur.

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

DatasetUsers

Object

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

Énumération

Type de principal

Valeur Description
None

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

Type de principal de l’utilisateur
Group

Type de principal de groupe
App

Type de principal de service

ServicePrincipalProfile

Object

Profil de principal du service Power BI. Uniquement pertinent pour la solution multilocataire Power BI Embedded.

Nom Type Description
displayName

string

Nom du profil du principal de service
id

string (uuid)

ID de profil du principal de service