Partager via


Admin - Dashboards GetDashboardUsersAsAdmin

Retourne une liste d’utilisateurs qui ont accès au tableau de bord 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.

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/dashboards/{dashboardId}/users

Paramètres URI

Nom Dans Obligatoire Type Description
dashboardId
path True

string (uuid)

ID du tableau de bord

Réponses

Nom Type Description
200 OK

DashboardUsers

Ok

Exemples

Example

Exemple de requête

GET https://api.powerbi.com/v1.0/myorg/admin/dashboards/{dashboardId}/users

Exemple de réponse

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

Définitions

Nom Description
DashboardUser

Entrée de droit d’accès utilisateur Power BI pour un tableau de bord

DashboardUserAccessRight

Droit d’accès dont dispose l’utilisateur pour le tableau de bord (niveau d’autorisation)

DashboardUsers

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

PrincipalType

Type de principal

ServicePrincipalProfile

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

DashboardUser

Entrée de droit d’accès utilisateur Power BI pour un tableau de bord

Nom Type Description
dashboardUserAccessRight

DashboardUserAccessRight

Droit d’accès dont dispose l’utilisateur pour le tableau de bord (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.

DashboardUserAccessRight

Droit d’accès dont dispose l’utilisateur pour le tableau de bord (niveau d’autorisation)

Valeur Description
None

Aucune autorisation pour le contenu dans le tableau de bord

Read

Octroie l’accès en lecture au contenu dans le tableau de bord

ReadWrite

Octroie l’accès en lecture et écriture au contenu dans le tableau de bord

ReadReshare

Accorde l’accès en lecture et repartage au contenu dans le tableau de bord

ReadCopy

Octroie l’accès en lecture et copie au contenu dans le tableau de bord

Owner

Accorde l’accès en lecture, écriture et partage à nouveau au contenu dans le rapport

DashboardUsers

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

Nom Type Description
@odata.context

string

value

DashboardUser[]

Liste des utilisateurs ayant accès à un tableau de bord

PrincipalType

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

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