Admin - Dashboards GetDashboardsAsAdmin

Service:: Power BI REST APIs

Version d'API:: v1.0

Retourne une liste de tableaux de bord pour l’organisation.

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 50 requêtes par heure ou 5 requêtes par minute, par locataire.

GET https://api.powerbi.com/v1.0/myorg/admin/dashboards

Avec des paramètres facultatifs:

GET https://api.powerbi.com/v1.0/myorg/admin/dashboards?$expand={$expand}&$filter={$filter}&$top={$top}&$skip={$skip}

Paramètres URI

Nom	Dans	Type	Description
$expand	query	string	Accepte une liste séparée par des virgules de types de données, qui sera développée inline dans la réponse. Prend en charge `tiles`.
$filter	query	string	Retourne un sous-ensemble de résultats en fonction de la condition de paramètre de requête de filtre Odata .
$skip	query	integer (int32)	Ignore les premiers n résultats
$top	query	integer (int32)	Retourne uniquement les premiers n résultats

Réponses

Nom	Type	Description
200 OK	AdminDashboards	Ok

Exemples

Example

Exemple de requête

GET https://api.powerbi.com/v1.0/myorg/admin/dashboards

Exemple de réponse

Code d’état:: 200

{
  "value": [
    {
      "id": "69ffaa6c-b36d-4d01-96f5-1ed67c64d4af",
      "displayName": "SalesMarketing",
      "embedUrl": "https://app.powerbi.com/dashboardEmbed?dashboardId=69ffaa6c-b36d-4d01-96f5-1ed67c64d4af",
      "isReadOnly": false,
      "workspaceId": "abfbdc89-2659-43c1-9142-93e8378eac96"
    }
  ]
}

Définitions

Nom	Description
AdminDashboard	Tableau de bord Power BI retourné par les API d’administration. L’API retourne un sous-ensemble de la liste suivante des propriétés du tableau de bord. Le sous-ensemble dépend de l’API appelée, des autorisations d’appelant et de la disponibilité des données dans la base de données Power BI.
AdminDashboards	Wrapper de réponse OData pour une collection de tableaux de bord Power BI
AdminTile	Vignette Power BI retournée par les API d’administration.
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)
PrincipalType	Type de principal
ServicePrincipalProfile	Profil de principal du service Power BI. Uniquement pertinent pour la solution multilocataire Power BI Embedded.
Subscription	Un abonnement par e-mail pour un élément Power BI (tel qu’un rapport ou un tableau de bord)
SubscriptionUser	Un utilisateur d’abonnement de messagerie Power BI

AdminDashboard

Object

Tableau de bord Power BI retourné par les API d’administration. L’API retourne un sous-ensemble de la liste suivante des propriétés du tableau de bord. Le sous-ensemble dépend de l’API appelée, des autorisations d’appelant et de la disponibilité des données dans la base de données Power BI.

Nom	Type	Description
appId	string	ID d’application, retourné uniquement si le tableau de bord appartient à une application
displayName	string	Nom complet du tableau de bord
embedUrl	string	URL incorporée du tableau de bord
id	string (uuid)	ID du tableau de bord
isReadOnly	boolean	Indique si le tableau de bord est en lecture seule
subscriptions	Subscription[]	(Valeur vide) Détails de l’abonnement pour un élément Power BI (tel qu’un rapport ou un tableau de bord). Cette propriété sera supprimée de la réponse de charge utile dans une prochaine version. Vous pouvez récupérer des informations d’abonnement pour un rapport Power BI à l’aide de l’appel d’API d’administration obtenir des abonnements de rapport .
tiles	AdminTile[]	Vignettes appartenant au tableau de bord
users	DashboardUser[]	(Valeur vide) Détails de l’accès de l’utilisateur au tableau de bord. Cette propriété sera supprimée de la réponse de charge utile dans une prochaine version. Vous pouvez récupérer des informations utilisateur sur un tableau de bord Power BI à l’aide de l’appel d’API Get Dashboard Users as Admin API call, ou de l’appel de l’API PostWorkspaceInfo avec le `getArtifactUsers` paramètre.
webUrl	string	URL web du tableau de bord
workspaceId	string (uuid)	ID d’espace de travail (GUID) du tableau de bord. Cette propriété est retournée uniquement dans GetDashboardsAsAdmin.