Condividi tramite


Admin - Apps GetAppsAsAdmin

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}
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

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