Admin - Apps GetAppsAsAdmin

Dienst:: Power BI REST APIs

API-Version:: v1.0

Gibt eine Liste von Apps in der Organisation zurück.

Der Abfrageparameter $top ist erforderlich.

Erlaubnisse

Der Benutzer muss ein Fabric-Administrator sein oder sich mit einem Dienstprinzipal authentifizieren.
Delegierte Berechtigungen werden unterstützt.

Bei der Ausführung unter der dienst prinicipalen Authentifizierung darf eine App keine erforderlichen Administratorzustimmungen für Power BI im Azure-Portal haben.

Erforderlicher Bereich

Tenant.Read.All oder Tenant.ReadWrite.All

Relevant nur bei der Authentifizierung über ein standardmäßiges delegiertes Administratorzugriffstoken. 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}

Mit optionalen Parametern:

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 minimum: 1	Die angeforderte Anzahl von Apps.
$skip	query		integer minimum: 1	Die Nummereinträge, die übersprungen werden sollen.

Antworten

Name	Typ	Beschreibung
200 OK	AdminApps	OKAY

Beispiele

Example

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:: 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 Administrator-APIs

AdminApp

Objekt

Name	Typ	Beschreibung
description	string	Die App-Beschreibung
id	string (uuid)	Die App-ID
lastUpdate	string (date-time)	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