Reports - Get Report
Restituisce il report specificato da Area di lavoro personale.
Ambito obbligatorio
Report.ReadWrite.All o Report.Read.All
GET https://api.powerbi.com/v1.0/myorg/reports/{reportId}Parametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
report
|
path | True |
string (uuid) |
The report ID |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK |
Va bene |
Esempio
Example
Esempio di richiesta
GET https://api.powerbi.com/v1.0/myorg/reports/5b218778-e7a5-4d73-8187-f10824047715Risposta di esempio
{
"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"
}Definizioni
| Nome | Descrizione |
|---|---|
|
Principal |
Tipo di entità |
| Report |
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. |
|
Report |
Voce a destra dell'accesso utente di Power BI per un report |
|
Report |
Diritto di accesso che l'utente ha per il report (livello di autorizzazione) |
|
Service |
Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded. |
| Subscription |
Sottoscrizione di posta elettronica per un elemento di Power BI (ad esempio un report o un dashboard) |
|
Subscription |
Un utente della sottoscrizione di posta elettronica di Power BI |
PrincipalType
Tipo di entità
| Valore | Descrizione |
|---|---|
| App |
Tipo di entità servizio |
| Group |
Tipo di entità gruppo |
| None |
Nessun tipo di entità. Usare per l'accesso a livello di organizzazione intero. |
| User |
Tipo di entità utente |
Report
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 (uuid) |
The report ID |
| isOwnedByMe |
boolean |
Indica se l'utente corrente può modificare o creare una copia del report. |
| name |
string |
Nome del report. I report dell'app iniziano con il prefisso [App]. |
| originalReportId |
string (uuid) |
ID report effettivo quando l'area di lavoro viene pubblicata come app. |
| reportType |
enum:
|
Tipo di report |
| subscriptions |
(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 l'Ottenere sottoscrizioni di report come chiamata API di amministrazione. |
|
| users |
(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 informazioni sull'utente in un report di Power BI usando il Ottenere utenti report come chiamata API di amministrazione o la chiamata API PostWorkspaceInfo con il parametro |
|
| webUrl |
string |
URL Web del report |
ReportUser
Voce a destra dell'accesso utente di Power BI per un report
| Nome | Tipo | Descrizione |
|---|---|---|
| displayName |
string |
Nome visualizzato dell'entità |
| emailAddress |
string |
Indirizzo e-mail dell'utente |
| graphId |
string |
Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione. |
| identifier |
string |
Identificatore dell'entità |
| principalType |
Tipo di entità |
|
| profile |
Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded. |
|
| reportUserAccessRight |
Diritto di accesso che l'utente ha per il report (livello di autorizzazione) |
|
| userType |
string |
Tipo di utente. |
ReportUserAccessRight
Diritto di accesso che l'utente ha per il report (livello di autorizzazione)
| Valore | Descrizione |
|---|---|
| None |
Nessuna autorizzazione per il contenuto nel report |
| Owner |
Concede l'accesso in lettura, scrittura e ricondivisione al contenuto nel report |
| Read |
Concede l'accesso in lettura al contenuto nel report |
| ReadCopy |
Concede l'accesso in lettura e copia al contenuto nel report |
| ReadReshare |
Concede l'accesso in lettura e ricondivisione al contenuto nel report |
| ReadWrite |
Concede l'accesso in lettura e scrittura al contenuto nel report |
ServicePrincipalProfile
Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded.
| Nome | Tipo | Descrizione |
|---|---|---|
| displayName |
string |
Nome del profilo dell'entità servizio |
| id |
string (uuid) |
ID del profilo dell'entità servizio |
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 (uuid) |
ID dell'elemento di Power BI sottoscritto( ad esempio un report o un dashboard) |
| artifactType |
string |
Tipo di elemento di Power BI , ad esempio un |
| attachmentFormat |
string |
Formato del report allegato nella sottoscrizione di posta elettronica |
| endDate |
string (date-time) |
Data e ora di fine della sottoscrizione di posta elettronica |
| frequency |
string |
Frequenza della sottoscrizione di posta elettronica |
| id |
string (uuid) |
ID sottoscrizione |
| isEnabled |
boolean |
Indica se la sottoscrizione tramite posta elettronica è abilitata |
| linkToContent |
boolean |
Indica se esiste un collegamento di sottoscrizione nella sottoscrizione di posta elettronica |
| previewImage |
boolean |
Indica se esiste uno screenshot del report nella sottoscrizione di posta elettronica |
| startDate |
string (date-time) |
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 |
Dettagli di ogni sottoscrittore di posta elettronica. Quando si usa il Ottenere sottoscrizioni utente come amministratore chiamata API, il valore restituito è una matrice vuota (null). Questa proprietà verrà rimossa dalla risposta del payload in una versione futura. È possibile recuperare informazioni sulla sottoscrizione in un report o un dashboard di Power BI usando il Ottenere sottoscrizioni di report come amministratore o Ottenere sottoscrizioni dashboard come chiamate API di amministrazione. |
SubscriptionUser
Un utente della sottoscrizione di posta elettronica di Power BI
| Nome | Tipo | Descrizione |
|---|---|---|
| displayName |
string |
Nome visualizzato dell'entità |
| emailAddress |
string |
Indirizzo e-mail dell'utente |
| graphId |
string |
Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione. |
| identifier |
string |
Identificatore dell'entità |
| principalType |
Tipo di entità |
|
| profile |
Profilo dell'entità servizio di Power BI. Pertinente solo per soluzione multi-tenancy di Power BI Embedded. |
|
| userType |
string |
Tipo di utente. |