Admin - Apps GetAppsAsAdmin

Zwraca listę aplikacji w organizacji.

Parametr zapytania $top jest wymagany.

Uprawnienia

  • Użytkownik musi mieć uprawnienia administratora (takie jak administrator globalny Office 365 lub administrator usługi Power BI) lub uwierzytelnić się przy użyciu jednostki usługi.
  • Uprawnienia delegowane są obsługiwane.

W przypadku uruchamiania w ramach uwierzytelniania podstawowego usługi aplikacja nie może mieć żadnych premii wymaganych przez administratora dla usługi Power BI ustawionych w Azure Portal.

Zakres wymagany

Tenant.Read.All lub Tenant.ReadWrite.All

Istotne tylko w przypadku uwierzytelniania za pośrednictwem standardowego delegowanego tokenu dostępu administratora. Nie może być obecny, gdy jest używane uwierzytelnianie za pośrednictwem jednostki usługi.

Ograniczenia

Maksymalna liczba żądań na godzinę wynosi 200.

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 identyfikatora URI

Nazwa W Wymagane Typ Opis
$top
query True

integer

Żądana liczba aplikacji.

$skip
query

integer

Wpisy liczbowe, które mają zostać pominięte.

Odpowiedzi

Nazwa Typ Opis
200 OK

AdminApps

OK

Przykłady

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

Definicje

Nazwa Opis
AdminApp
AdminApps

Otoka odpowiedzi OData dla listy zainstalowanych aplikacji usługi Power BI dla interfejsów API Administracja

AdminApp

Nazwa Typ Opis
description

string

Opis aplikacji

id

string

Identyfikator aplikacji

lastUpdate

string

Data i godzina ostatniej aktualizacji aplikacji

name

string

Nazwa aplikacji

publishedBy

string

Wydawca aplikacji

workspaceId

string

Skojarzony obszar roboczy dla aplikacji

AdminApps

Otoka odpowiedzi OData dla listy zainstalowanych aplikacji usługi Power BI dla interfejsów API Administracja

Nazwa Typ Opis
odata.context

string

Kontekst OData

value

AdminApp[]

Lista zainstalowanych aplikacji