Admin - Reports GetReportsInGroupAsAdmin
Vrátí seznam sestav 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}/reports
GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/reports?$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/reports
Sample Response
{
"value": [
{
"datasetId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"id": "5b218778-e7a5-4d73-8187-f10824047715",
"name": "SalesMarketing",
"webUrl": "https://app.powerbi.com/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/reports/5b218778-e7a5-4d73-8187-f10824047715",
"embedUrl": "https://app.powerbi.com/reportEmbed?reportId=5b218778-e7a5-4d73-8187-f10824047715&groupId=f089354e-8366-4e18-aea3-4cb4a3a50b48"
}
]
}
Definice
Name | Description |
---|---|
Admin |
Sestava Power BI vrácená rozhraními API Správa. Rozhraní API vrátí podmnožinu následujícího seznamu vlastností sestavy. 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 sestav Power BI Správa |
Principal |
Typ objektu zabezpečení |
Report |
Přístupová práva uživatele Power BI pro sestavu |
Report |
Přístupová práva, která má uživatel k sestavě (úroveň oprávnění) |
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 |
AdminReport
Sestava Power BI vrácená rozhraními API Správa. Rozhraní API vrátí podmnožinu následujícího seznamu vlastností sestavy. 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 sestava patří aplikaci |
createdBy |
string |
Vlastník sestavy. K dispozici pouze pro sestavy vytvořené po červnu 2019. |
createdDateTime |
string |
Datum a čas vytvoření sestavy |
datasetId |
string |
ID datové sady sestavy |
description |
string |
Popis sestavy |
embedUrl |
string |
Adresa URL pro vložení sestavy |
id |
string |
ID sestavy |
modifiedBy |
string |
Poslední uživatel, který sestavu upravil |
modifiedDateTime |
string |
Datum a čas poslední změny sestavy |
name |
string |
Název sestavy |
originalReportId |
string |
Skutečné ID sestavy, když je pracovní prostor publikovaný jako aplikace. |
reportType |
enum:
|
Typ sestavy |
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. |
|
users |
(Prázdná hodnota) Podrobnosti o přístupu uživatele pro sestavu Power BI. Tato vlastnost se odebere z odpovědi datové části v nadcházející verzi. Informace o uživatelích v sestavě Power BI můžete načíst pomocí volání Získat uživatele sestavy jako Správa rozhraní API nebo volání rozhraní API PostWorkspaceInfo s parametrem |
|
webUrl |
string |
Webová adresa URL sestavy |
workspaceId |
string |
ID (GUID) pracovního prostoru sestavy. Tato vlastnost se vrátí jenom v GetReportsAsAdmin. |
AdminReports
Obálka odpovědi OData pro kolekci sestav Power BI Správa
Name | Typ | Description |
---|---|---|
odata.context |
string |
Kontext OData |
value |
Kolekce sestav |
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 |
ReportUser
Přístupová práva uživatele Power BI pro sestavu
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. |
|
reportUserAccessRight |
Přístupová práva, která má uživatel k sestavě (úroveň oprávnění) |
|
userType |
string |
Typ uživatele. |
ReportUserAccessRight
Přístupová práva, která má uživatel k sestavě (úroveň oprávnění)
Name | Typ | Description |
---|---|---|
None |
string |
Žádná oprávnění k obsahu v sestavě |
Owner |
string |
Uděluje přístup ke čtení, zápisu a sdílení obsahu v sestavě. |
Read |
string |
Uděluje přístup ke čtení obsahu v sestavě. |
ReadCopy |
string |
Uděluje přístup ke čtení a kopírování obsahu v sestavě. |
ReadReshare |
string |
Uděluje přístup ke čtení a sdílení obsahu v sestavě. |
ReadWrite |
string |
Uděluje přístup ke čtení a zápisu k obsahu v sestavě. |
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. |