Freigeben über


Admin - Dashboards GetTilesAsAdmin

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

{
  "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