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 původního ověřování služby nesmí mít aplikace v Azure Portal nastavená žádná oprávnění vyžadovaná správcem 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. Nesmí být k dispozici při použití 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	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 SPRÁVA API Rozhraní API vrátí podmnožinu z následujícího seznamu vlastností sestavy. Podmnožina závisí na volaného 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	Položka přístupového práva uživatele Power BI pro sestavu
ReportUserAccessRight	Přístupové právo, 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	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

AdminReport

Sestava Power BI vrácená rozhraními SPRÁVA API Rozhraní API vrátí podmnožinu z následujícího seznamu vlastností sestavy. Podmnožina závisí na volaného 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
isOwnedByMe	boolean	Určete, jestli sestavu vytvořil aktuální uživatel.
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 při publikování pracovního prostoru 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 bude odebrána 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í Získat odběry sestav jako Správa rozhraní API.
users	ReportUser[]	(Prázdná hodnota) Podrobnosti o přístupu uživatele k sestavě Power BI Tato vlastnost bude odebrána 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í Rozhraní API Get Report Users as Správa nebo pomocí volání rozhraní API PostWorkspaceInfo s parametrem`getArtifactUsers`.
webUrl	string	Webová adresa URL sestavy
workspaceId	string	ID (GUID) pracovního prostoru sestavy. Tato vlastnost bude vrácena pouze 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žívá se pro přístup na úrovni celé organizace.
User	string	Typ objektu zabezpečení uživatele

ReportUser

Položka přístupového 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ávo, které má uživatel k sestavě (úroveň oprávnění)
userType	string	Typ uživatele.

ReportUserAccessRight

Přístupové právo, 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 oprávnění 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 opětovnému 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

Odběr e-mailu pro položku Power BI (například sestavu nebo řídicí panel)

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`, `Dashboard`nebo `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-mailu
id	string	ID předplatného
isEnabled	boolean	Jestli je povolené předplatné e-mailu
linkToContent	boolean	Jestli v e-mailovém předplatném existuje odkaz na předplatné
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ácená hodnota prázdné pole (null). Tato vlastnost bude odebrána 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ích panelů 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.