Admin - Dashboards GetDashboardsAsAdmin

Referenz

Service:: Power BI REST APIs

API Version:: v1.0

Gibt eine Liste von Dashboards für die organization zurück.

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

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

With optional parameters:

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 in der Antwort inline erweitert wird. Unterstützt `tiles`
$filter	query	string	Filtert die Ergebnisse basierend auf einer booleschen Bedingung.
$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	OK

Beispiele

Example

Sample Request

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

Sample Response

Status code:: 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	Eine Power BI-Dashboard, die von Admin-APIs zurückgegeben wird. Die API gibt eine Teilmenge der folgenden Liste von Dashboard Eigenschaften 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	OData-Antwortwrapper für eine Power BI-Dashboard sammlung
AdminTile	Eine von Admin APIs zurückgegebene Power BI-Kachel.
DashboardUser	Ein Power BI-Benutzerzugriffsrechteintrag für eine Dashboard
DashboardUserAccessRight	Das Zugriffsrecht, das der Benutzer für die Dashboard hat (Berechtigungsstufe)
PrincipalType	Der Prinzipaltyp
ServicePrincipalProfile	Ein Power BI-Dienst Prinzipalprofil. Nur relevant für Power BI Embedded Mehrinstanzenlösung.
Subscription	Ein E-Mail-Abonnement für ein Power BI-Element (z. B. einen Bericht oder eine Dashboard)
SubscriptionUser	Ein Power BI-E-Mail-Abonnementbenutzer

AdminDashboard

Eine Power BI-Dashboard, die von Admin-APIs zurückgegeben wird. Die API gibt eine Teilmenge der folgenden Liste von Dashboard Eigenschaften 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 die Dashboard zu einer App gehört.
displayName	string	Der Anzeigename des Dashboard
embedUrl	string	Die Einbettungs-URL der Dashboard
id	string	Die Dashboard-ID
isReadOnly	boolean	Gibt an, ob die Dashboard schreibgeschützt ist.
subscriptions	Subscription[]	(Leerer Wert) Die Abonnementdetails für ein Power BI-Element (z. B. einen Bericht oder eine Dashboard). Diese Eigenschaft wird in einem bevorstehenden Release aus der Nutzlastantwort entfernt. Sie können Abonnementinformationen für einen Power BI-Bericht abrufen, indem Sie den API-Aufruf Zum Abrufen von Berichtsabonnements als Admin verwenden.
tiles	AdminTile[]	Die Kacheln, die zum Dashboard gehören
users	DashboardUser[]	(Leerer Wert) Die Dashboard Benutzerzugriffsdetails. Diese Eigenschaft wird in einem bevorstehenden Release aus der Nutzlastantwort entfernt. Sie können Benutzerinformationen zu einem Power BI-Dashboard abrufen, indem Sie den Aufruf Dashboardbenutzer als Admin API abrufen oder den Api-Aufruf PostWorkspaceInfo mit dem `getArtifactUsers` Parameter verwenden.
webUrl	string	Die Web-URL der Dashboard
workspaceId	string	Die Arbeitsbereichs-ID (GUID) des Dashboard. Diese Eigenschaft wird nur in GetDashboardsAsAdmin zurückgegeben.