Admin - Apps GetAppsAsAdmin

Riferimento

Service:: Power BI REST APIs

API Version:: v1.0

Restituisce un elenco di app nell'organizzazione.

È necessario il parametro di query $top.

Autorizzazioni

L'utente deve avere diritti di amministratore, ad esempio Office 365 amministratore globale o amministratore del servizio Power BI, oppure eseguire l'autenticazione usando un'entità servizio.
Le autorizzazioni delegate sono supportate.

Quando è in esecuzione nell'autenticazione prinicipal del servizio, un'app non deve disporre di premissioni necessarie per il consenso amministratore per Power BI impostata nel portale di Azure.

Ambito obbligatorio

Tenant.Read.All o Tenant.ReadWrite.All

Pertinente 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 200 richieste all'ora.

GET https://api.powerbi.com/v1.0/myorg/admin/apps?$top={$top}

With optional parameters:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
$top	query	True	integer	Numero richiesto di app.
$skip	query		integer	Voci di numero da ignorare.

Risposte

Nome	Tipo	Descrizione
200 OK	AdminApps	OK

Esempio

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/apps?$top=10

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
      "description": "The finance app",
      "name": "Finance",
      "publishedBy": "Bill",
      "lastUpdate": "2019-01-13T09:46:53.094+02:00"
    },
    {
      "id": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "description": "The marketing app",
      "name": "Marketing",
      "publishedBy": "Ben",
      "lastUpdate": "2018-11-13T09:46:53.094+02:00"
    }
  ]
}

Definizioni

Nome	Descrizione
AdminApp
AdminApps	Wrapper di risposta OData per un elenco di app installate da Power BI per le API di Amministrazione

AdminApp

Nome	Tipo	Descrizione
description	string	Descrizione dell'app
id	string	ID dell'app
lastUpdate	string	Data e ora dell'ultimo aggiornamento dell'app
name	string	Nome dell'app
publishedBy	string	Server di pubblicazione dell'app
workspaceId	string	Area di lavoro associata per l'app

AdminApps

Wrapper di risposta OData per un elenco di app installate da Power BI per le API di Amministrazione

Nome	Tipo	Descrizione
odata.context	string	Contesto OData
value	AdminApp[]	Elenco di app installate

Share via