Admin - Dashboards GetTilesAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

Gibt eine Liste der Kacheln innerhalb des angegebenen Dashboard 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 200 Anforderungen pro Stunde.

GET https://api.powerbi.com/v1.0/myorg/admin/dashboards/{dashboardId}/tiles

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
dashboardId	path	True	string uuid	Die Dashboard-ID

Antworten

Name	Typ	Beschreibung
200 OK	AdminTiles	OK

Beispiele

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/dashboards/69ffaa6c-b36d-4d01-96f5-1ed67c64d4af/tiles

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "312fbfe9-2eda-44e0-9ed0-ab5dc571bb4b",
      "title": "SalesMarketingTile",
      "embedUrl": "https://app.powerbi.com/embed?dashboardId=69ffaa6c-b36d-4d01-96f5-1ed67c64d4af&tileId=312fbfe9-2eda-44e0-9ed0-ab5dc571bb4b",
      "rowSpan": 0,
      "colSpan": 0,
      "reportId": "5b218778-e7a5-4d73-8187-f10824047715",
      "datasetId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    }
  ]
}

Definitionen

Name	Beschreibung
AdminTile	Eine von Admin APIs zurückgegebene Power BI-Kachel.
AdminTiles	Der OData-Antwortwrapper für eine Power BI-Kachelsammlung

AdminTile

Eine von Admin APIs zurückgegebene Power BI-Kachel.

Name	Typ	Beschreibung
colSpan	integer	Die Anzahl der Kachelspannenspalten
datasetId	string	Die Dataset-ID. Nur für Kacheln verfügbar, die aus einem Bericht oder mithilfe eines Datasets erstellt wurden, z. B. Q&A-Kacheln.
embedData	string	Die Einbettungsdaten für die Kachel
embedUrl	string	Die Einbettungs-URL der Kachel
id	string	Die Kachel-ID
reportId	string	Die Berichts-ID. Nur für Kacheln verfügbar, die aus einem Bericht erstellt wurden.
rowSpan	integer	Die Anzahl der Kachelspannzeilen
title	string	Der Anzeigename der Kachel

AdminTiles

Der OData-Antwortwrapper für eine Power BI-Kachelsammlung

Name	Typ	Beschreibung
odata.context	string	OData-Kontext
value	AdminTile[]	Die Kachelauflistung