Admin - Dashboards GetDashboardsAsAdmin

Référence

Service:: Power BI REST APIs

API Version:: v1.0

Retourne une liste de tableaux de bord pour le organization.

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 lorsque l’authentification via un principal de service est utilisée.

Limites

Maximum 50 demandes par heure ou 5 requêtes par minute, par locataire.

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

With optional parameters:

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. Prise en charge de `tiles`.
$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/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",
      "isReadOnly": false,
      "workspaceId": "abfbdc89-2659-43c1-9142-93e8378eac96"
    }
  ]
}

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. Ne concerne que Power BI Embedded solution multilocataire.
Subscription	Un abonnement de messagerie 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 d’affichage 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 (tel qu’un rapport ou un tableau de bord). Cette propriété sera supprimée de la réponse de charge utile dans une version à venir. Vous pouvez récupérer des informations d’abonnement pour un rapport Power BI à l’aide de l’option Obtenir des abonnements de rapport en tant qu’appel d’API Administration.
tiles	AdminTile[]	Vignettes qui appartiennent 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 version à venir. 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 comme Administration appel d’API, 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.