Admin - Dashboards GetDashboardsInGroupAsAdmin

Référence

Service:: Power BI REST APIs

API Version:: v1.0

Retourne une liste de tableaux de bord de l’espace de travail spécifié.

Autorisations

L’utilisateur doit disposer de droits d’administrateur (par exemple, 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 du 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 lorsque l’authentification via un principal de service est utilisée.

Limites

Maximum 200 demandes par heure.

GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/dashboards

With optional parameters:

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
groupId	path	True	string uuid	L’ID de l’espace de travail
$filter	query		string	Filtre les résultats, en fonction d’une condition booléenne
$skip	query		integer int32	Ignore les n premiers résultats
$top	query		integer int32	Retourne uniquement les n premiers résultats

Réponses

Nom	Type	Description
200 OK	AdminDashboards	Ok

Exemples

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dashboards

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "69ffaa6c-b36d-4d01-96f5-1ed67c64d4af",
      "displayName": "SalesMarketing",
      "embedUrl": "https://app.powerbi.com/dashboardEmbed?dashboardId=69ffaa6c-b36d-4d01-96f5-1ed67c64d4af&groupId=f089354e-8366-4e18-aea3-4cb4a3a50b48",
      "isReadOnly": false
    }
  ]
}

Définitions

Nom	Description
AdminDashboard	Tableau de bord Power BI retourné par Administration API. L’API retourne un sous-ensemble de la liste suivante de propriétés de tableau de bord. Le sous-ensemble dépend de l’API appelée, des autorisations de l’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 Administration API.
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 principal
ServicePrincipalProfile	Profil principal service Power BI. Concerne uniquement Power BI Embedded solution mutualisée.
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

Tableau de bord Power BI retourné par Administration API. L’API retourne un sous-ensemble de la liste suivante de propriétés de tableau de bord. Le sous-ensemble dépend de l’API appelée, des autorisations de l’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	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 (par exemple, 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 les informations d’abonnement d’un rapport Power BI à l’aide de l’appel d’API Get Report Subscriptions as Administration.
tiles	AdminTile[]	Vignettes qui appartiennent au tableau de bord
users	DashboardUser[]	(Valeur vide) Détails de l’accès 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 Obtenir des utilisateurs du tableau de bord en tant qu’appel d’API Administration, ou de l’appel d’API PostWorkspaceInfo avec le `getArtifactUsers` paramètre .
webUrl	string	URL web du tableau de bord
workspaceId	string	ID d’espace de travail (GUID) du tableau de bord. Cette propriété sera retournée uniquement dans GetDashboardsAsAdmin.