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 |
|---|---|---|---|---|
|
dashboard
|
path | True |
string (uuid) |
ID du tableau de bord |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
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 |
|---|---|
|
Dashboard |
Entrée de droit d’accès utilisateur Power BI pour un tableau de bord |
|
Dashboard |
Droit d’accès dont dispose l’utilisateur pour le tableau de bord (niveau d’autorisation) |
|
Dashboard |
Wrapper de réponse OData pour une liste d’utilisateurs Power BI ayant accès à un tableau de bord |
|
Principal |
Type de principal |
|
Service |
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 |
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 |
Type de principal |
|
| profile |
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 |
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 |