Admin - Apps GetAppsAsAdmin

Usługa:: Power BI REST APIs

Wersja interfejsu API:: v1.0

Zwraca listę aplikacji w organizacji.

Parametr zapytania $top jest wymagany.

Uprawnienia

Użytkownik musi być administratorem sieci szkieletowej lub uwierzytelniać się przy użyciu jednostki usługi.
Uprawnienia delegowane są obsługiwane.

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

Wymagany zakres

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}

Z parametrami opcjonalnymi:

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 minimum: 1	Żądana liczba aplikacji.
$skip	query		integer minimum: 1	Pominięto wpisy liczbowe.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	AdminApps	OK

Przykłady

Example

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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"
    }
  ]
}

Definicje

Nazwa	Opis
AdminApp
AdminApps	Otoka odpowiedzi OData dla listy zainstalowanych aplikacji usługi Power BI dla interfejsów API administratorów

AdminApp

Objekt

Nazwa	Typ	Opis
description	string	Opis aplikacji
id	string (uuid)	Identyfikator aplikacji
lastUpdate	string (date-time)	Data i godzina ostatniej aktualizacji aplikacji
name	string	Nazwa aplikacji
publishedBy	string	Wydawca aplikacji
workspaceId	string	Skojarzony obszar roboczy dla aplikacji

AdminApps