Sdílet prostřednictvím

Reports - Update Report Content

  • Reference
Služba:
Power BI REST APIs
Verze rozhraní API:
v1.0

Aktualizace obsah zadané sestavy z pracovního prostoru s obsahem zadané zdrojové sestavy.

V textu požadavku zadejte zdrojovou sestavu.

Požadovaný obor

Report.ReadWrite.All

POST https://api.powerbi.com/v1.0/myorg/reports/{reportId}/UpdateReportContent

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
reportId
 path True

string

uuid

ID sestavy

Text požadavku

Name Vyžadováno Typ Description
sourceReport True

SourceReport

Existující zdrojová sestava
sourceType True

sourceType

Typ zdroje aktualizace obsahu

Odpovědi

Name Typ Description
200 OK

Report

OK

Příklady

Example

Ukázkový požadavek

POST https://api.powerbi.com/v1.0/myorg/reports/5b218778-e7a5-4d73-8187-f10824047715/UpdateReportContent
Text požadavku
{
  "sourceReport": {
    "sourceReportId": "8e4d5880-81d6-4804-ab97-054665050799",
    "sourceWorkspaceId": "2f42a406-a075-4a15-bbf2-97ef958c94cb"
  },
  "sourceType": "ExistingReport"
}

Ukázková odpověď

Stavový kód:
200

Definice

Name Description
PrincipalType

Typ objektu zabezpečení
Report

Sestava Power BI. 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.
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.
SourceReport

Existující zdrojová sestava
sourceType

Typ zdroje aktualizace obsahu
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
UpdateReportContentRequest

Žádost Power BI o aktualizaci obsahu sestavy

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

Report

Sestava Power BI. 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
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.
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 parametremgetArtifactUsers.
webUrl

string

Webová adresa URL sestavy

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

SourceReport

Existující zdrojová sestava

Name Typ Description
sourceReportId

string

ID zdrojové sestavy
sourceWorkspaceId

string

ID zdrojového pracovního prostoru

sourceType

Typ zdroje aktualizace obsahu

Name Typ Description
ExistingReport

string

Použití existující sestavy jako zdroje obsahu použitého k aktualizaci cílové sestavy

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

UpdateReportContentRequest

Žádost Power BI o aktualizaci obsahu sestavy

Name Typ Description
sourceReport

SourceReport

Existující zdrojová sestava
sourceType

sourceType

Typ zdroje aktualizace obsahu