Admin - Apps GetAppsAsAdmin

參考

Service:: Power BI REST APIs

API Version:: v1.0

傳回組織中的應用程式清單。

需要查詢參數$top。

權限

用戶必須具有系統管理員許可權 (，例如 Office 365 全域管理員或 Power BI 服務管理員) 或使用服務主體進行驗證。
支援委派的許可權。

在服務預備驗證下執行時，應用程式不得在 Azure 入口網站中設定Power BI的任何系統管理員同意必要許可權。

必要範圍

Tenant.Read.All 或 Tenant.ReadWrite.All

只有在透過標準委派的系統管理員存取令牌進行驗證時才相關。使用透過服務主體進行驗證時，不得存在。

限制

每小時最多 200 個要求。

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

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/admin/apps?$top={$top}&$skip={$skip}

URI 參數

名稱	位於	必要	類型	Description
$top	query	True	integer	所要求的應用程式數目。
$skip	query		integer	要略過的數字專案。

回應

名稱	類型	Description
200 OK	AdminApps	確定

範例

Example

Sample Request

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

Sample Response

Status code:: 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"
    }
  ]
}

定義

名稱	Description
AdminApp
AdminApps	適用於管理員 API 的 Power BI 已安裝應用程式清單的 OData 回應包裝函式

AdminApp

名稱	類型	Description
description	string	應用程式描述
id	string	應用程式識別碼
lastUpdate	string	上次更新應用程式的日期和時間
name	string	應用程式名稱
publishedBy	string	應用程式發行者
workspaceId	string	應用程式的相關聯工作區

AdminApps

適用於管理員 API 的 Power BI 已安裝應用程式清單的 OData 回應包裝函式

名稱	類型	Description
odata.context	string	OData 內容
value	AdminApp[]	已安裝的應用程式清單

共用方式為