Admin - Reports GetReportsAsAdmin

  • Reference
Service:
Power BI REST APIs
API Version:
v1.0

Vrátí seznam sestav 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/reports
With optional parameters: 
GET https://api.powerbi.com/v1.0/myorg/admin/reports?$filter={$filter}&$top={$top}&$skip={$skip}

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
$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

AdminReports

OK

Příklady

Example

Sample Request

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

Sample Response

Status code:
200 
{
  "value": [
    {
      "datasetId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "id": "5b218778-e7a5-4d73-8187-f10824047715",
      "name": "SalesMarketing",
      "webUrl": "https://app.powerbi.com//reports/5b218778-e7a5-4d73-8187-f10824047715",
      "embedUrl": "https://app.powerbi.com/reportEmbed?reportId=5b218778-e7a5-4d73-8187-f10824047715",
      "workspaceId": "278e22a3-2aee-4057-886d-c3225423bc10"
    }
  ]
}

Definice

Name Description
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.
AdminReports

Obálka odpovědi OData pro kolekci sestav Power BI Správa
PrincipalType

Typ objektu zabezpečení
ReportUser

Přístupová práva uživatele Power BI pro sestavu
ReportUserAccessRight

Přístupová práva, která má uživatel k sestavě (úroveň oprávnění)
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

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:
  • PaginatedReport
  • PowerBIReport

Typ sestavy
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.
users

ReportUser[]

(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 getArtifactUsers .
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

AdminReport[]

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

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.
reportUserAccessRight

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 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.