Admin - Dashboards GetDashboardsInGroupAsAdmin
Vrátí seznam řídicích panelů ze zadaného pracovního prostoru.
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ě 200 požadavků za hodinu.
GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/dashboards
GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/dashboards?$filter={$filter}&$top={$top}&$skip={$skip}
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
group
|
path | True |
string uuid |
ID pracovního prostoru |
$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 |
OK |
Příklady
Example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dashboards
Sample Response
{
"value": [
{
"id": "69ffaa6c-b36d-4d01-96f5-1ed67c64d4af",
"displayName": "SalesMarketing",
"embedUrl": "https://app.powerbi.com/dashboardEmbed?dashboardId=69ffaa6c-b36d-4d01-96f5-1ed67c64d4af&groupId=f089354e-8366-4e18-aea3-4cb4a3a50b48",
"isReadOnly": false
}
]
}
Definice
Name | Description |
---|---|
Admin |
Ří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. |
Admin |
Obálka odpovědi OData pro kolekci řídicích panelů Power BI |
Admin |
Dlaždice Power BI vrácená rozhraními API Správa. |
Dashboard |
Přístupová práva uživatele Power BI k řídicímu panelu |
Dashboard |
Přístupová práva, která má uživatel k řídicímu panelu (úroveň oprávnění) |
Principal |
Typ objektu zabezpečení |
Service |
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) |
Subscription |
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 |
(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 |
Dlaždice, které patří do řídicího panelu |
|
users |
(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 |
|
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 |
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 |
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 |
Typ objektu zabezpečení |
|
profile |
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 |
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 |
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 |
Typ objektu zabezpečení |
|
profile |
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. |