Reports - Update Report Content

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

Aggiornamenti il contenuto del report specificato dall'area di lavoro personale con il contenuto di un report di origine specificato.

Specificare il report di origine nel corpo della richiesta.

Ambito obbligatorio

Report.ReadWrite.All

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
reportId
 path True

string

uuid

The report ID

Corpo della richiesta

Nome Necessario Tipo Descrizione
sourceReport True

SourceReport

Un report di origine esistente
sourceType True

sourceType

Tipo di origine dell'aggiornamento del contenuto

Risposte

Nome Tipo Descrizione
200 OK

Report

OK

Esempio

Example

Sample Request

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

Sample Response

Status code:
200

Definizioni

Nome Descrizione
PrincipalType

Tipo di entità
Report

Un report di Power BI. L'API restituisce un subset dell'elenco seguente di proprietà del report. Il subset dipende dall'API denominata, dalle autorizzazioni del chiamante e dalla disponibilità dei dati nel database di Power BI.
ReportUser

Voce di diritto di accesso utente di Power BI per un report
ReportUserAccessRight

Diritto di accesso a cui l'utente ha per il report (livello di autorizzazione)
ServicePrincipalProfile

Profilo principale servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy.
SourceReport

Un report di origine esistente
sourceType

Tipo di origine dell'aggiornamento del contenuto
Subscription

Sottoscrizione di posta elettronica per un elemento di Power BI (ad esempio un report o un dashboard)
SubscriptionUser

Un utente della sottoscrizione di posta elettronica di Power BI
UpdateReportContentRequest

Richiesta di Power BI per aggiornare il contenuto di un report

PrincipalType

Tipo di entità

Nome Tipo Descrizione
App

string

Tipo di entità servizio
Group

string

Tipo di entità gruppo
None

string

Nessun tipo di entità. Usare per l'accesso a livello di intera organizzazione.
User

string

Tipo di entità utente

Report

Un report di Power BI. L'API restituisce un subset dell'elenco seguente di proprietà del report. Il subset dipende dall'API denominata, dalle autorizzazioni del chiamante e dalla disponibilità dei dati nel database di Power BI.

Nome Tipo Descrizione
appId

string

ID app, restituito solo se il report appartiene a un'app
datasetId

string

ID del set di dati del report
description

string

Descrizione del report
embedUrl

string

URL di incorporamento del report
id

string

The report ID
name

string

Nome del report
originalReportId

string

ID del report effettivo quando l'area di lavoro viene pubblicata come app.
reportType enum:
  • PaginatedReport
  • PowerBIReport

Tipo di report
subscriptions

Subscription[]

(Valore vuoto) Dettagli della sottoscrizione per un elemento di Power BI, ad esempio un report o un dashboard. Questa proprietà verrà rimossa dalla risposta del payload in una versione futura. È possibile recuperare le informazioni sulla sottoscrizione per un report di Power BI usando Get Report Subscriptions (Ottieni sottoscrizioni report) come Amministrazione chiamata API.
users

ReportUser[]

(Valore vuoto) Dettagli di accesso utente per un report di Power BI. Questa proprietà verrà rimossa dalla risposta del payload in una versione futura. È possibile recuperare le informazioni utente in un report di Power BI usando Get Report Users (Ottieni utenti report) come chiamata API Amministrazione o l'API PostWorkspaceInfo con il getArtifactUsers parametro .
webUrl

string

URL Web del report

ReportUser

Voce di diritto di accesso utente di Power BI per un report

Nome Tipo Descrizione
displayName

string

Nome visualizzato dell'entità
emailAddress

string

Indirizzo di posta elettronica dell'utente
graphId

string

Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione.
identifier

string

Identificatore dell'entità
principalType

PrincipalType

Tipo di entità
profile

ServicePrincipalProfile

Profilo principale servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy.
reportUserAccessRight

ReportUserAccessRight

Diritto di accesso a cui l'utente ha per il report (livello di autorizzazione)
userType

string

Tipo di utente.

ReportUserAccessRight

Diritto di accesso a cui l'utente ha per il report (livello di autorizzazione)

Nome Tipo Descrizione
None

string

Nessuna autorizzazione per il contenuto nel report
Owner

string

Concede l'accesso in lettura, scrittura e ricondivisione al contenuto nel report
Read

string

Concede l'accesso in lettura al contenuto nel report
ReadCopy

string

Concede l'accesso in lettura e copia al contenuto nel report
ReadReshare

string

Concede l'accesso in lettura e ricondivisione al contenuto nel report
ReadWrite

string

Concede l'accesso in lettura e scrittura al contenuto nel report

ServicePrincipalProfile

Profilo principale servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy.

Nome Tipo Descrizione
displayName

string

Nome del profilo dell'entità servizio
id

string

ID del profilo dell'entità servizio

SourceReport

Un report di origine esistente

Nome Tipo Descrizione
sourceReportId

string

ID report di origine
sourceWorkspaceId

string

ID dell'area di lavoro di origine

sourceType

Tipo di origine dell'aggiornamento del contenuto

Nome Tipo Descrizione
ExistingReport

string

Usare un report esistente come origine del contenuto usato per aggiornare un report di destinazione

Subscription

Sottoscrizione di posta elettronica per un elemento di Power BI (ad esempio un report o un dashboard)

Nome Tipo Descrizione
artifactDisplayName

string

Nome dell'elemento di Power BI sottoscritto , ad esempio un report o un dashboard.
artifactId

string

ID dell'elemento di Power BI sottoscritto (ad esempio un report o un dashboard)
artifactType

string

Tipo di elemento di Power BI ( ad esempio Report, Dashboardo Dataset)
attachmentFormat

string

Formato del report allegato nella sottoscrizione di posta elettronica
endDate

string

Data e ora di fine della sottoscrizione di posta elettronica
frequency

string

Frequenza della sottoscrizione di posta elettronica
id

string

ID sottoscrizione
isEnabled

boolean

Indica se la sottoscrizione di posta elettronica è abilitata
linkToContent

boolean

Indica se esiste un collegamento di sottoscrizione nella sottoscrizione di posta elettronica
previewImage

boolean

Indica se nella sottoscrizione di posta elettronica è presente uno screenshot del report
startDate

string

Data e ora di inizio della sottoscrizione di posta elettronica
subArtifactDisplayName

string

Nome della pagina dell'elemento di Power BI sottoscritto, se si tratta di un report.
title

string

Nome dell'app
users

SubscriptionUser[]

Dettagli di ogni sottoscrittore di posta elettronica. Quando si usa la chiamata api Get User Subscriptions As Amministrazione, il valore restituito è una matrice vuota (null). Questa proprietà verrà rimossa dalla risposta del payload in una versione futura. È possibile recuperare le informazioni sulla sottoscrizione in un report o un dashboard di Power BI usando get report subscriptions As Amministrazione (Ottieni sottoscrizioni report) o Get Dashboard Subscriptions As Amministrazione API calls (Ottieni sottoscrizioni report come Amministrazione chiamate API).

SubscriptionUser

Un utente della sottoscrizione di posta elettronica di Power BI

Nome Tipo Descrizione
displayName

string

Nome visualizzato dell'entità
emailAddress

string

Indirizzo di posta elettronica dell'utente
graphId

string

Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione.
identifier

string

Identificatore dell'entità
principalType

PrincipalType

Tipo di entità
profile

ServicePrincipalProfile

Profilo principale servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy.
userType

string

Tipo di utente.

UpdateReportContentRequest

Richiesta di Power BI per aggiornare il contenuto di un report

Nome Tipo Descrizione
sourceReport

SourceReport

Un report di origine esistente
sourceType

sourceType

Tipo di origine dell'aggiornamento del contenuto