Admin - Apps GetAppsAsAdmin

Service:: Power BI REST APIs

Version d'API:: v1.0

Retourne une liste d’applications dans l’organisation.

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

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

Avec des paramètres facultatifs:

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 minimum: 1	Nombre demandé d’applications.
$skip	query		integer minimum: 1	Nombre d’entrées à ignorer.

Réponses

Nom	Type	Description
200 OK	AdminApps	Ok

Exemples

Example

Exemple de requête

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

Exemple de réponse

Code d’état:: 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 obtenir la liste des applications installées par Power BI pour les API d’administration

AdminApp

Object

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

AdminApps