Partager via


Admin - Dashboards GetDashboardUsersAsAdmin

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

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/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

Sample Request

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

Sample Response

{
  "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 principal

ServicePrincipalProfile

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

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 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.

DashboardUserAccessRight

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

Nom Type Description
None

string

Aucune autorisation sur le contenu dans le tableau de bord

Owner

string

Octroie l’accès en lecture, écriture et repartage au contenu du rapport

Read

string

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

ReadCopy

string

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

ReadReshare

string

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

ReadWrite

string

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

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 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