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 参数

名称	在	必需	类型	说明
$top	query	True	integer	请求的应用数。
$skip	query		integer	要跳过的数字条目。

响应

名称	类型	说明
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"
    }
  ]
}

定义

名称	说明
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[]	已安装应用的列表