Reports - Get Reports In Group

Service:

Power BI REST APIs

API Version:

v1.0

Restituisce un elenco di report dall'area di lavoro specificata.

Poiché i report impaginati (RDL) non hanno un set di dati, il valore id del set di dati nella risposta API per i report impaginati non viene visualizzato.

Autorizzazioni

Questa chiamata API può essere chiamata da un profilo entità servizio. Per altre informazioni, vedere Profili entità servizio in Power BI Embedded.

Ambito obbligatorio

Report.ReadWrite.All o Report.Read.All

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/reports

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
groupId	path	True	string uuid	ID area di lavoro

Risposte

Nome	Tipo	Descrizione
200 OK	Reports	OK

Esempio

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/reports/5b218778-e7a5-4d73-8187-f10824047715",
      "embedUrl": "https://app.powerbi.com/reportEmbed?reportId=5b218778-e7a5-4d73-8187-f10824047715&groupId=f089354e-8366-4e18-aea3-4cb4a3a50b48"
    }
  ]
}

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.
Reports	Wrapper di risposta OData per una raccolta di report 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.
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

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
isOwnedByMe	boolean	Determinare se il report viene creato dall'utente corrente.
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

Reports

Wrapper di risposta OData per una raccolta di report di Power BI

Nome	Tipo	Descrizione
odata.context	string	Contesto OData
value	Report[]	Raccolta di 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

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.