Dashboards - Get Dashboards In Group

Riferimento

Service:: Power BI REST APIs

API Version:: v1.0

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

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

Dashboard.ReadWrite.All o Dashboard.Read.All

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

Parametri dell'URI

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

Risposte

Nome	Tipo	Descrizione
200 OK	Dashboards	OK

Esempio

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dashboards

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "69ffaa6c-b36d-4d01-96f5-1ed67c64d4af",
      "displayName": "SalesMarketing",
      "embedUrl": "https://app.powerbi.com/dashboardEmbed?dashboardId=69ffaa6c-b36d-4d01-96f5-1ed67c64d4af&groupId=f089354e-8366-4e18-aea3-4cb4a3a50b48",
      "isReadOnly": false
    }
  ]
}

Definizioni

Nome	Descrizione
Dashboard	Un dashboard di Power BI. L'API restituisce un subset dell'elenco seguente di proprietà del dashboard. Il subset dipende dall'API denominata, dalle autorizzazioni del chiamante e dalla disponibilità dei dati nel database di Power BI.
Dashboards	Wrapper di risposta OData per una raccolta di dashboard di Power BI
DashboardUser	Voce di diritto di accesso utente di Power BI per un dashboard
DashboardUserAccessRight	Diritto di accesso a cui l'utente ha per il dashboard (livello di autorizzazione)
PrincipalType	Tipo di entità
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

Dashboard

Un dashboard di Power BI. L'API restituisce un subset dell'elenco seguente di proprietà del dashboard. 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 dashboard appartiene a un'app
displayName	string	Nome visualizzato del dashboard
embedUrl	string	URL di incorporamento del dashboard
id	string	The dashboard ID
isReadOnly	boolean	Indica se il dashboard è di sola lettura
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	DashboardUser[]	(Valore vuoto) Dettagli di accesso utente del dashboard. Questa proprietà verrà rimossa dalla risposta del payload in una versione futura. È possibile recuperare le informazioni utente in un dashboard di Power BI usando Get Dashboard Users (Ottieni utenti dashboard) come chiamata API Amministrazione o l'API PostWorkspaceInfo con il `getArtifactUsers` parametro .
webUrl	string	URL Web del dashboard

Dashboards

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

Nome	Tipo	Descrizione
odata.context	string	Contesto OData
value	Dashboard[]	Raccolta di dashboard

DashboardUser

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

Nome	Tipo	Descrizione
dashboardUserAccessRight	DashboardUserAccessRight	Diritto di accesso a cui l'utente ha per il dashboard (livello di autorizzazione)
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.

DashboardUserAccessRight

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

Nome	Tipo	Descrizione
None	string	Nessuna autorizzazione per il contenuto nel dashboard
Owner	string	Concede l'accesso in lettura, scrittura e ricondivisione al contenuto nel report
Read	string	Concede l'accesso in lettura al contenuto nel dashboard
ReadCopy	string	Concede l'accesso in lettura e copia al contenuto nel dashboard
ReadReshare	string	Concede l'accesso in lettura e ricondivisione al contenuto nel dashboard
ReadWrite	string	Concede l'accesso in lettura e scrittura al contenuto nel dashboard

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

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`, `Dashboard`o `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.