Admin - Dashboards GetDashboardsAsAdmin

Riferimento

Service:: Power BI REST APIs

API Version:: v1.0

Restituisce un elenco di dashboard per l'organizzazione.

Autorizzazioni

L'utente deve disporre dei diritti di amministratore( ad esempio Office 365 amministratore globale o amministratore del servizio Power BI) o eseguire l'autenticazione tramite un'entità servizio.
Le autorizzazioni delegate sono supportate.

Quando viene eseguita con l'autenticazione priniciale del servizio, un'app non deve avere premissioni necessarie per il consenso amministratore per Power BI impostate nel portale di Azure.

Ambito obbligatorio

Tenant.Read.All o Tenant.ReadWrite.All

Rilevante solo quando si esegue l'autenticazione tramite un token di accesso amministratore delegato standard. Non deve essere presente quando viene usata l'autenticazione tramite un'entità servizio.

Limitazioni

Massimo 50 richieste all'ora o 5 richieste al minuto, per tenant.

GET https://api.powerbi.com/v1.0/myorg/admin/dashboards

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/admin/dashboards?$expand={$expand}&$filter={$filter}&$top={$top}&$skip={$skip}

Parametri dell'URI

Nome	In	Tipo	Descrizione
$expand	query	string	Accetta un elenco delimitato da virgole dei tipi di dati, che verrà espanso inline nella risposta. Supporta `tiles`.
$filter	query	string	Filtra i risultati, in base a una condizione booleana
$skip	query	integer int32	Ignora i primi n risultati
$top	query	integer int32	Restituisce solo i primi n risultati

Risposte

Nome	Tipo	Descrizione
200 OK	AdminDashboards	OK

Esempio

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/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",
      "isReadOnly": false,
      "workspaceId": "abfbdc89-2659-43c1-9142-93e8378eac96"
    }
  ]
}

Definizioni

Nome	Descrizione
AdminDashboard	Un dashboard di Power BI restituito dalle API di Amministrazione. 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.
AdminDashboards	Wrapper di risposta OData per una raccolta di dashboard di Power BI
AdminTile	Riquadro di Power BI restituito dalle API di Amministrazione.
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

AdminDashboard

Un dashboard di Power BI restituito dalle API di Amministrazione. 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.
tiles	AdminTile[]	Riquadri che appartengono al dashboard
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
workspaceId	string	ID area di lavoro (GUID) del dashboard. Questa proprietà verrà restituita solo in GetDashboardsAsAdmin.