Admin - Apps GetAppsAsAdmin

Referenz

Service:: Power BI REST APIs

API Version:: v1.0

Gibt eine Liste der Apps im organization zurück.

Der Abfrageparameter $top ist erforderlich.

Berechtigungen

Der Benutzer muss über Administratorrechte (z. B. Office 365 globalen Administrator oder Power BI-Dienstadministrator) verfügen oder sich mithilfe eines Dienstprinzipals authentifizieren.
Delegierte Berechtigungen werden unterstützt.

Bei der Ausführung unter dienstprinizipaler Authentifizierung dürfen für eine App keine erforderlichen Administratoreinwilligungsvoreinstellungen für Power BI im Azure-Portal festgelegt sein.

Erforderlicher Bereich

Tenant.Read.All oder Tenant.ReadWrite.All

Nur bei der Authentifizierung über ein standardmäßiges delegiertes Administratorzugriffstoken relevant. Darf nicht vorhanden sein, wenn die Authentifizierung über einen Dienstprinzipal verwendet wird.

Einschränkungen

Maximal 200 Anforderungen pro Stunde.

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}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
$top	query	True	integer	Die angeforderte Anzahl von Apps.
$skip	query		integer	Die zu überspringenden Zahleneinträge.

Antworten

Name	Typ	Beschreibung
200 OK	AdminApps	OK

Beispiele

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"
    }
  ]
}

Definitionen

Name	Beschreibung
AdminApp
AdminApps	Der OData-Antwortwrapper für eine Liste der installierten Power BI-Apps für Admin-APIs

AdminApp

Name	Typ	Beschreibung
description	string	Die App-Beschreibung
id	string	Die App-ID
lastUpdate	string	Datum und Uhrzeit der letzten Aktualisierung der App
name	string	Der App-Name
publishedBy	string	Der App-Herausgeber
workspaceId	string	Zugeordneter Arbeitsbereich für die App

AdminApps

Der OData-Antwortwrapper für eine Liste der installierten Power BI-Apps für Admin-APIs

Name	Typ	Beschreibung
odata.context	string	OData-Kontext
value	AdminApp[]	Die Liste der installierten Apps

Freigeben über