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 |
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 |
---|---|
Admin |
|
Admin |
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 |
Admin |
Lista zainstalowanych aplikacji |