通过

Admin - Apps GetAppsAsAdmin

服务:
Power BI REST APIs
API 版本:
v1.0

返回组织中的应用列表。

需要查询参数$top。

权限

  • 用户必须是 Fabric 管理员或使用服务主体进行身份验证。
  • 支持委派的权限。

在服务特权身份验证下运行时，应用 不得 在 Azure 门户中为其上设置的 Power BI 提供任何管理员许可。

所需范围

Tenant.Read.All 或 Tenant.ReadWrite.All

仅在通过标准委派管理员访问令牌进行身份验证时相关。 使用服务主体进行身份验证时不得存在。

局限性

每小时最多 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

AdminApps

还行

示例

Example

示例请求

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

示例响应

状态代码:
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

Object
名称 类型 说明
description

string

应用说明
id

string (uuid)

应用 ID
lastUpdate

string (date-time)

上次更新应用的日期和时间
name

string

应用名称
publishedBy

string

应用发布者
workspaceId

string

应用的关联工作区

AdminApps

Object

适用于管理员 API 的 Power BI 已安装应用的列表的 OData 响应包装器

名称 类型 说明
@odata.context

string

OData 上下文
value

AdminApp[]

已安装应用的列表