Condividi tramite


Dashboards - Get Dashboard In Group

Restituisce il dashboard specificato dall'area di lavoro specificata.

Autorizzazioni

Questa chiamata API può essere chiamata da un profilo dell'entità servizio. Per altre informazioni, vedere: Profili dell'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/{dashboardId}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
dashboardId
path True

string

uuid

The dashboard ID

groupId
path True

string

uuid

ID area di lavoro

Risposte

Nome Tipo Descrizione
200 OK

Dashboard

OK

Esempio

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dashboards/69ffaa6c-b36d-4d01-96f5-1ed67c64d4af

Sample Response

{
  "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

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.

DashboardUser

Voce di accesso dell'utente di Power BI per un dashboard

DashboardUserAccessRight

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

PrincipalType

Tipo principale

ServicePrincipalProfile

Profilo entità servizio Power BI. Solo pertinente 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

Utente della sottoscrizione di posta elettronica di Power BI

Dashboard

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 dell'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

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 successiva. È possibile recuperare le informazioni sulla sottoscrizione per un report di Power BI usando get report Subscriptions as Amministrazione API call .

users

DashboardUser[]

(Valore vuoto) Dettagli dell'accesso utente del dashboard. Questa proprietà verrà rimossa dalla risposta del payload in una versione successiva. È possibile recuperare le informazioni utente in un dashboard di Power BI usando Get Dashboard Users come chiamata API Amministrazione o la chiamata API PostWorkspaceInfo con il getArtifactUsers parametro .

webUrl

string

URL Web del dashboard

DashboardUser

Voce di accesso dell'utente di Power BI per un dashboard

Nome Tipo Descrizione
dashboardUserAccessRight

DashboardUserAccessRight

Diritto di accesso che 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 principale

profile

ServicePrincipalProfile

Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy.

userType

string

Tipo dell'utente.

DashboardUserAccessRight

Diritto di accesso che 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 ricondividi 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 ricondividi al contenuto nel dashboard

ReadWrite

string

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

PrincipalType

Tipo principale

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 organizzazione intero.

User

string

Tipo di entità utente

ServicePrincipalProfile

Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy.

Nome Tipo Descrizione
displayName

string

Nome del profilo dell'entità servizio

id

string

ID 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 Power BI sottoscritto , ad esempio un report o un dashboard.

artifactId

string

ID dell'elemento Power BI sottoscritto , ad esempio un report o un dashboard.

artifactType

string

Tipo di elemento di Power BI (ad esempio , ReportDashboardo Dataset)

attachmentFormat

string

Formato del report collegato 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

Se la sottoscrizione di posta elettronica è abilitata

linkToContent

boolean

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

Data e ora di inizio della sottoscrizione di posta elettronica

subArtifactDisplayName

string

Nome della pagina dell'elemento 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 Get User Subscriptions As Amministrazione API, il valore restituito è una matrice vuota (Null). Questa proprietà verrà rimossa dalla risposta del payload in una versione successiva. È possibile recuperare le informazioni sulla sottoscrizione in un report o un dashboard di Power BI usando get report Subscriptions As Amministrazione o Get Dashboard Subscriptions As Amministrazione API call( Get Report Subscriptions As Amministrazione API call).

SubscriptionUser

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 principale

profile

ServicePrincipalProfile

Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy.

userType

string

Tipo dell'utente.