Admin - Dashboards GetDashboardsAsAdmin

Služba:: Power BI REST APIs

Verze rozhraní API:: v1.0

Vrátí seznam řídicích panelů pro organizaci.

Dovolení

Uživatel musí být správcem infrastruktury nebo se musí ověřit pomocí instančního objektu.
Delegovaná oprávnění jsou podporována.

Při spuštění v rámci ověřování prinicipal služby nesmí aplikace nesmí mít na webu Azure Portal nastavené žádné žádosti o udělení souhlasu správce pro Power BI.

Požadovaný obor

Tenant.Read.All nebo Tenant.ReadWrite.All

Relevantní pouze při ověřování prostřednictvím standardního delegovaného přístupového tokenu správce. Při ověřování pomocí instančního objektu nesmí být k dispozici.

Omezení

Maximálně 50 požadavků za hodinu nebo 5 požadavků za minutu na tenanta.

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

S volitelnými parametry:

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

Parametry identifikátoru URI

Name	V	Typ	Description
$expand	query	string	Přijme čárkami oddělený seznam datových typů, který se v odpovědi rozbalí. Podporuje `tiles`.
$filter	query	string	Vrátí podmnožinu výsledků na základě Odata podmínky parametru dotazu filtru.
$skip	query	integer (int32)	Přeskočí první n výsledků.
$top	query	integer (int32)	Vrátí pouze první n výsledků.

Odpovědi

Name	Typ	Description
200 OK	AdminDashboards	OK

Příklady

Example

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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"
    }
  ]
}

Definice

Name	Description
AdminDashboard	Řídicí panel Power BI vrácený rozhraními API pro správu Rozhraní API vrátí podmnožinu následujících vlastností řídicího panelu. Podmnožina závisí na rozhraní API volaného, oprávnění volajícího a dostupnosti dat v databázi Power BI.
AdminDashboards	Obálka odpovědi OData pro kolekci řídicích panelů Power BI
AdminTile	Dlaždice Power BI vrácená rozhraními API pro správu
DashboardUser	Položka práva pro přístup uživatele Power BI k řídicímu panelu
DashboardUserAccessRight	Přístupové právo, které má uživatel pro řídicí panel (úroveň oprávnění)
PrincipalType	Typ objektu zabezpečení
ServicePrincipalProfile	Profil instančního objektu Power BI. Relevantní pouze pro víceklientské řešení Power BI Embedded.
Subscription	Odběr e-mailu pro položku Power BI (například sestavu nebo řídicí panel)
SubscriptionUser	Uživatel e-mailového předplatného Power BI

AdminDashboard

Objekt

Řídicí panel Power BI vrácený rozhraními API pro správu Rozhraní API vrátí podmnožinu následujících vlastností řídicího panelu. Podmnožina závisí na rozhraní API volaného, oprávnění volajícího a dostupnosti dat v databázi Power BI.

Name	Typ	Description
appId	string	ID aplikace, vrácené pouze v případě, že řídicí panel patří do aplikace
displayName	string	Zobrazovaný název řídicího panelu
embedUrl	string	Adresa URL pro vložení řídicího panelu
id	string (uuid)	ID řídicího panelu
isReadOnly	boolean	Jestli je řídicí panel jen pro čtení
subscriptions	Subscription[]	(Prázdná hodnota) Podrobnosti předplatného pro položku Power BI (například sestavu nebo řídicí panel) Tato vlastnost bude odebrána z odpovědi datové části v nadcházející verzi. Informace o předplatném sestavy Power BI můžete načíst pomocí Získat odběry sestav jako volání rozhraní API pro správce.
tiles	AdminTile[]	Dlaždice, které patří na řídicí panel
users	DashboardUser[]	(Prázdná hodnota) Podrobnosti o přístupu uživatele řídicího panelu. Tato vlastnost bude odebrána z odpovědi datové části v nadcházející verzi. Informace o uživatelích na řídicím panelu Power BI můžete načíst pomocí Získat uživatele řídicího panelu jako volání rozhraní API pro správu nebo volání rozhraní API PostWorkspaceInfo pomocí parametru `getArtifactUsers`.
webUrl	string	Webová adresa URL řídicího panelu
workspaceId	string (uuid)	ID (GUID) pracovního prostoru řídicího panelu. Tato vlastnost bude vrácena pouze v GetDashboardsAsAdmin.