Admin - Dashboards GetDashboardsAsAdmin

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

Oprávnění

  • Uživatel musí mít oprávnění správce (například Office 365 globálního správce nebo správce služby Power BI) nebo ověřování pomocí instančního objektu.
  • Delegovaná oprávnění jsou podporovaná.

Při spuštění v rámci ověřování prinicipal služby nesmí mít aplikace v Azure Portal nastavená oprávnění pro Power BI vyžadovaná správcem.

Požadovaný obor

Tenant.Read.All nebo Tenant.ReadWrite.All

Relevantní pouze při ověřování prostřednictvím standardního přístupového tokenu delegovaného správce. Nesmí být přítomen, když se používá ověřování prostřednictvím instančního objektu.

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
GET https://api.powerbi.com/v1.0/myorg/admin/dashboards?$expand={$expand}&$filter={$filter}&$top={$top}&$skip={$skip}

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
$expand
query

string

Přijímá seznam datových typů oddělený čárkami, který se v odpovědi rozbalí. Podporuje tiles.

$filter
query

string

Filtruje výsledky na základě logické podmínky.

$skip
query

integer

int32

Přeskočí prvních n výsledků.

$top
query

integer

int32

Vrátí pouze prvních n výsledků.

Odpovědi

Name Typ Description
200 OK

AdminDashboards

OK

Příklady

Example

Sample Request

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

Sample Response

{
  "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 Správa. Rozhraní API vrátí podmnožinu následujícího seznamu vlastností řídicího panelu. Podmnožina závisí na rozhraní API, oprávněních 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 Správa.

DashboardUser

Přístupová práva uživatele Power BI k řídicímu panelu

DashboardUserAccessRight

Přístupová práva, která má uživatel k řídicímu panelu (úroveň oprávnění)

PrincipalType

Typ objektu zabezpečení

ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.

Subscription

E-mailový odběr položky Power BI (například sestavy nebo řídicího panelu)

SubscriptionUser

Uživatel e-mailového předplatného Power BI

AdminDashboard

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

Name Typ Description
appId

string

ID aplikace, které se vrátí jenom v případě, že řídicí panel patří do aplikace

displayName

string

Zobrazovaný název řídicího panelu

embedUrl

string

Adresa URL řídicího panelu pro vložení

id

string

ID řídicího panelu

isReadOnly

boolean

Určuje, jestli je řídicí panel jen pro čtení

subscriptions

Subscription[]

(Prázdná hodnota) Podrobnosti o předplatném pro položku Power BI (například sestavu nebo řídicí panel). Tato vlastnost se odebere z odpovědi datové části v nadcházející verzi. Informace o předplatném pro sestavu Power BI můžete načíst pomocí volání Rozhraní API Získat odběry sestav jako Správa.

tiles

AdminTile[]

Dlaždice, které patří do řídicího panelu

users

DashboardUser[]

(Prázdná hodnota) Podrobnosti o přístupu uživatele řídicího panelu Tato vlastnost se odebere 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í volání Získat uživatele řídicího panelu jako Správa rozhraní API nebo volání rozhraní API PostWorkspaceInfo s parametrem getArtifactUsers .

webUrl

string

Webová adresa URL řídicího panelu

workspaceId

string

ID (GUID) pracovního prostoru řídicího panelu. Tato vlastnost se vrátí jenom v GetDashboardsAsAdmin.

AdminDashboards

Obálka odpovědi OData pro kolekci řídicích panelů Power BI

Name Typ Description
odata.context

string

Kontext OData

value

AdminDashboard[]

Kolekce řídicích panelů

AdminTile

Dlaždice Power BI vrácená rozhraními API Správa.

Name Typ Description
colSpan

integer

Počet sloupců rozpětí dlaždic

datasetId

string

ID datové sady. K dispozici pouze pro dlaždice vytvořené ze sestavy nebo pomocí datové sady, jako jsou dlaždice Q&A.

embedData

string

Data pro vložení dlaždice

embedUrl

string

Adresa URL pro vložení dlaždice

id

string

ID dlaždice

reportId

string

ID sestavy. K dispozici pouze pro dlaždice vytvořené ze sestavy.

rowSpan

integer

Počet řádků rozpětí dlaždic

title

string

Zobrazovaný název dlaždice

DashboardUser

Přístupová práva uživatele Power BI k řídicímu panelu

Name Typ Description
dashboardUserAccessRight

DashboardUserAccessRight

Přístupová práva, která má uživatel k řídicímu panelu (úroveň oprávnění)

displayName

string

Zobrazovaný název objektu zabezpečení

emailAddress

string

E-mailová adresa uživatele

graphId

string

Identifikátor objektu zabezpečení v Microsoft Graphu. K dispozici pouze pro rozhraní API pro správu.

identifier

string

Identifikátor objektu zabezpečení

principalType

PrincipalType

Typ objektu zabezpečení

profile

ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.

userType

string

Typ uživatele.

DashboardUserAccessRight

Přístupová práva, která má uživatel k řídicímu panelu (úroveň oprávnění)

Name Typ Description
None

string

Žádná oprávnění k obsahu na řídicím panelu

Owner

string

Uděluje přístup ke čtení, zápisu a sdílení obsahu v sestavě.

Read

string

Uděluje oprávnění ke čtení obsahu na řídicím panelu.

ReadCopy

string

Uděluje přístup ke čtení a kopírování obsahu na řídicím panelu.

ReadReshare

string

Uděluje přístup ke čtení a sdílení obsahu na řídicím panelu.

ReadWrite

string

Udělí oprávnění ke čtení a zápisu k obsahu na řídicím panelu.

PrincipalType

Typ objektu zabezpečení

Name Typ Description
App

string

Typ instančního objektu

Group

string

Typ objektu zabezpečení skupiny

None

string

Žádný typ objektu zabezpečení. Použijte pro přístup na úrovni celé organizace.

User

string

Typ objektu zabezpečení uživatele

ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.

Name Typ Description
displayName

string

Název profilu instančního objektu

id

string

ID profilu instančního objektu

Subscription

E-mailový odběr položky Power BI (například sestavy nebo řídicího panelu)

Name Typ Description
artifactDisplayName

string

Název odebírané položky Power BI (například sestavy nebo řídicího panelu)

artifactId

string

ID odebírané položky Power BI (například sestavy nebo řídicího panelu)

artifactType

string

Typ položky Power BI (například Report, Dashboardnebo Dataset)

attachmentFormat

string

Formát sestavy připojené k odběru e-mailu

endDate

string

Koncové datum a čas odběru e-mailu

frequency

string

Frekvence odběru e-mailů

id

string

ID předplatného

isEnabled

boolean

Jestli je povolený odběr e-mailu

linkToContent

boolean

Jestli v e-mailovém odběru existuje odkaz na odběr

previewImage

boolean

Jestli v odběru e-mailu existuje snímek obrazovky se sestavou

startDate

string

Počáteční datum a čas odběru e-mailu

subArtifactDisplayName

string

Název stránky odebírané položky Power BI, pokud se jedná o sestavu.

title

string

Název aplikace

users

SubscriptionUser[]

Podrobnosti o každém odběrateli e-mailu. Při použití volání rozhraní API Get User Subscriptions As Správa je vrácenou hodnotou prázdné pole (null). Tato vlastnost se odebere z odpovědi datové části v nadcházející verzi. Informace o předplatném sestavy nebo řídicího panelu Power BI můžete načíst pomocí volání rozhraní API Získat odběry sestav jako Správa nebo Získat odběry řídicího panelu jako Správa.

SubscriptionUser

Uživatel e-mailového předplatného Power BI

Name Typ Description
displayName

string

Zobrazovaný název objektu zabezpečení

emailAddress

string

E-mailová adresa uživatele

graphId

string

Identifikátor objektu zabezpečení v Microsoft Graphu. K dispozici pouze pro rozhraní API pro správu.

identifier

string

Identifikátor objektu zabezpečení

principalType

PrincipalType

Typ objektu zabezpečení

profile

ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.

userType

string

Typ uživatele.