Admin - Apps GetAppsAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Retourne une liste d’applications dans le organization.

Le paramètre de requête $top est requis.

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/apps?$top={$top}

With optional parameters:

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
$top	query	True	integer	Nombre d’applications demandé.
$skip	query		integer	Nombre d’entrées à ignorer.

Réponses

Nom	Type	Description
200 OK	AdminApps	Ok

Exemples

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/apps?$top=10

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
      "description": "The finance app",
      "name": "Finance",
      "publishedBy": "Bill",
      "lastUpdate": "2019-01-13T09:46:53.094+02:00"
    },
    {
      "id": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "description": "The marketing app",
      "name": "Marketing",
      "publishedBy": "Ben",
      "lastUpdate": "2018-11-13T09:46:53.094+02:00"
    }
  ]
}

Définitions

Nom	Description
AdminApp
AdminApps	Wrapper de réponse OData pour une liste d’applications Power BI installées pour Administration API

AdminApp

Nom	Type	Description
description	string	Description de l’application
id	string	ID de l’application
lastUpdate	string	Date et heure de la dernière mise à jour de l’application
name	string	Nom de l’application
publishedBy	string	Éditeur de l’application
workspaceId	string	Espace de travail associé pour l’application

AdminApps

Wrapper de réponse OData pour une liste d’applications Power BI installées pour Administration API

Nom	Type	Description
odata.context	string	Contexte OData
value	AdminApp[]	Liste des applications installées