Admin - Apps GetAppsAsAdmin
組織内のアプリの一覧を返します。
クエリ パラメーター$topが必要です。
Permissions
- ユーザーは、ファブリック管理者であるか、サービス プリンシパルを使用して認証されている必要があります。
- 委任されたアクセス許可がサポートされています。
サービス 特権認証で実行する場合、アプリには、Azure portal で Power BI に対して管理者の同意が必要な使用許可が設定 されていない必要があります 。
必要なスコープ
Tenant.Read.All または Tenant.ReadWrite.All
標準の委任された管理者アクセス トークンを使用して認証する場合にのみ関連します。 サービス プリンシパル経由の認証を使用する場合は、存在しない必要があります。
制限事項
1 時間あたり最大 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}
URI パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
$top
|
query | True |
integer minimum: 1 |
要求されたアプリの数。 |
|
$skip
|
query |
integer minimum: 1 |
スキップするエントリの数。 |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 200 OK |
[OK] |
例
Example
要求のサンプル
GET https://api.powerbi.com/v1.0/myorg/admin/apps?$top=10
応答のサンプル
{
"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"
}
]
}
定義
| 名前 | 説明 |
|---|---|
|
Admin |
|
|
Admin |
管理者 API 用にインストールされている Power BI アプリの一覧の OData 応答ラッパー |
AdminApp
| 名前 | 型 | 説明 |
|---|---|---|
| description |
string |
アプリの説明 |
| id |
string (uuid) |
アプリ ID |
| lastUpdate |
string (date-time) |
アプリが最後に更新された日時 |
| name |
string |
アプリ名 |
| publishedBy |
string |
アプリの発行元 |
| workspaceId |
string |
アプリに関連付けられているワークスペース |
AdminApps
管理者 API 用にインストールされている Power BI アプリの一覧の OData 応答ラッパー
| 名前 | 型 | 説明 |
|---|---|---|
| @odata.context |
string |
OData コンテキスト |
| value |
Admin |
インストールされているアプリの一覧 |