Admin - Apps GetAppsAsAdmin

Vrátí seznam aplikací v organizaci.

Parametr dotazu $top je povinný.

Oprávnění

  • Uživatel musí mít oprávnění správce (například Office 365 globálního správce nebo správce služby Power BI) nebo ověřování pomocí instančního objektu.
  • Delegovaná oprávnění jsou podporovaná.

Při spuštění v rámci původního ověřování služby nesmí mít aplikace v Azure Portal nastavená žádná oprávnění vyžadovaná správcem pro Power BI.

Požadovaný obor

Tenant.Read.All nebo Tenant.ReadWrite.All

Relevantní pouze při ověřování prostřednictvím standardního delegovaného přístupového tokenu správce. Nesmí být k dispozici při použití ověřování prostřednictvím instančního objektu.

Omezení

Maximálně 200 požadavků za hodinu.

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}

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
$top
query True

integer

Požadovaný počet aplikací

$skip
query

integer

Číselné položky, které se mají přeskočit.

Odpovědi

Name Typ Description
200 OK

AdminApps

OK

Příklady

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

Definice

Name Description
AdminApp
AdminApps

Obálka odpovědi OData pro seznam aplikací nainstalovaných v Power BI pro rozhraní API Správa

AdminApp

Name Typ Description
description

string

Popis aplikace

id

string

ID aplikace

lastUpdate

string

Datum a čas poslední aktualizace aplikace

name

string

Název aplikace

publishedBy

string

Vydavatel aplikace

workspaceId

string

Přidružený pracovní prostor pro aplikaci

AdminApps

Obálka odpovědi OData pro seznam aplikací nainstalovaných v Power BI pro rozhraní API Správa

Name Typ Description
odata.context

string

Kontext OData

value

AdminApp[]

Seznam nainstalovaných aplikací