Admin - Apps GetAppsAsAdmin

リファレンス

Service:: Power BI REST APIs

API Version:: v1.0

organization内のアプリの一覧を返します。

クエリパラメーター $topが必要です。

アクセス許可

ユーザーは管理者権限 (Office 365グローバル管理者や Power BI サービス管理者など) を持っているか、サービスプリンシパルを使用して認証する必要があります。
委任されたアクセス許可がサポートされています。

サービスの prinicipal 認証で実行する場合、アプリは、Azure portalで Power BI に対して管理者の同意が必要な使用許可を設定する必要はありません。

必要なスコープ

Tenant.Read.All または Tenant.ReadWrite.All

標準の委任された管理者アクセストークンを使用して認証する場合にのみ関連します。サービスプリンシパルによる認証を使用する場合は、存在しない必要があります。

制限事項

1 時間あたり最大 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 パラメーター

名前	/	必須	型	説明
$top	query	True	integer	要求されたアプリの数。
$skip	query		integer	スキップするエントリ数。

応答

名前	型	説明
200 OK	AdminApps	OK

例

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

定義

名前	説明
AdminApp
AdminApps	管理 API 用にインストールされている Power BI アプリの一覧の OData 応答ラッパー

AdminApp

名前	型	説明
description	string	アプリの説明
id	string	アプリ ID
lastUpdate	string	アプリが最後に更新された日時
name	string	アプリの名前
publishedBy	string	アプリの発行元
workspaceId	string	アプリに関連付けられているワークスペース

AdminApps

管理 API 用にインストールされている Power BI アプリの一覧の OData 応答ラッパー

名前	型	説明
odata.context	string	OData コンテキスト
value	AdminApp[]	インストールされているアプリの一覧

Share via