Admin - Dashboards GetDashboardsAsAdmin

Dienst:: Power BI REST APIs

API-Version:: v1.0

Gibt eine Liste der Dashboards für die Organisation zurück.

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 50 Anforderungen pro Stunde oder 5 Anforderungen pro Minute, pro Mandant.

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

Mit optionalen Parametern:

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

URI-Parameter

Name	In	Typ	Beschreibung
$expand	query	string	Akzeptiert eine durch Trennzeichen getrennte Liste von Datentypen, die inline in der Antwort erweitert wird. Unterstützt `tiles`.
$filter	query	string	Gibt eine Teilmenge einer Ergebnisse basierend auf der Odata-Filterabfrageparameterbedingung zurück.
$skip	query	integer (int32)	Überspringt die ersten n Ergebnisse.
$top	query	integer (int32)	Gibt nur die ersten n Ergebnisse zurück.

Antworten

Name	Typ	Beschreibung
200 OK	AdminDashboards	OKAY

Beispiele

Example

Beispielanforderung

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

Beispiel für eine Antwort

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

Definitionen

Name	Beschreibung
AdminDashboard	Ein Power BI-Dashboard, das von Administrator-APIs zurückgegeben wird. Die API gibt eine Teilmenge der folgenden Liste der Dashboardeigenschaften zurück. Die Teilmenge hängt von der aufgerufenen API, den Aufruferberechtigungen und der Verfügbarkeit von Daten in der Power BI-Datenbank ab.
AdminDashboards	Der OData-Antwortwrapper für eine Power BI-Dashboardsammlung
AdminTile	Eine Power BI-Kachel, die von Administrator-APIs zurückgegeben wird.
DashboardUser	Ein Power BI-Benutzerzugriff für ein Dashboard
DashboardUserAccessRight	Das Zugriffsrecht, das der Benutzer für das Dashboard hat (Berechtigungsstufe)
PrincipalType	Der Prinzipaltyp
ServicePrincipalProfile	Ein Power BI-Dienstprinzipalprofil. Nur für Power BI Embedded Mandantenlösung relevant.
Subscription	Ein E-Mail-Abonnement für ein Power BI-Element (z. B. einen Bericht oder ein Dashboard)
SubscriptionUser	Ein Power BI-E-Mail-Abonnementbenutzer

AdminDashboard

Objekt

Ein Power BI-Dashboard, das von Administrator-APIs zurückgegeben wird. Die API gibt eine Teilmenge der folgenden Liste der Dashboardeigenschaften zurück. Die Teilmenge hängt von der aufgerufenen API, den Aufruferberechtigungen und der Verfügbarkeit von Daten in der Power BI-Datenbank ab.

Name	Typ	Beschreibung
appId	string	Die App-ID, die nur zurückgegeben wird, wenn das Dashboard zu einer App gehört
displayName	string	Der Anzeigename des Dashboards
embedUrl	string	Die Einbettungs-URL des Dashboards
id	string (uuid)	Die Dashboard-ID
isReadOnly	boolean	Gibt an, ob das Dashboard schreibgeschützt ist.
subscriptions	Subscription[]	(Leerer Wert) Die Abonnementdetails für ein Power BI-Element (z. B. einen Bericht oder ein Dashboard). Diese Eigenschaft wird aus der Nutzlastantwort in einer bevorstehenden Version entfernt. Sie können Abonnementinformationen für einen Power BI-Bericht abrufen, indem Sie den Administrator-API-Aufruf zum Abrufen von Berichtsabonnements verwenden.
tiles	AdminTile[]	Die Kacheln, die zum Dashboard gehören
users	DashboardUser[]	(Leerer Wert) Details des Dashboardbenutzerzugriffs. Diese Eigenschaft wird aus der Nutzlastantwort in einer bevorstehenden Version entfernt. Sie können Benutzerinformationen auf einem Power BI-Dashboard abrufen, indem Sie den Api-Aufruf "Dashboardbenutzer abrufen" oder den PostWorkspaceInfo-API-Aufruf mit dem `getArtifactUsers` Parameter verwenden.
webUrl	string	Die Web-URL des Dashboards
workspaceId	string (uuid)	Die Arbeitsbereichs-ID (GUID) des Dashboards. Diese Eigenschaft wird nur in GetDashboardsAsAdmin zurückgegeben.