Admin - Groups GetUnusedArtifactsAsAdmin

Service:

Power BI REST APIs

API Version:

v1.0

返回未在 30 天内用于指定工作区的数据集、报表和仪表板的列表。 这是预览 API 调用。

权限

• 用户必须具有管理员权限 (，例如Office 365全局管理员或 Power BI 服务管理员) 或使用服务主体进行身份验证。
• 支持委派的权限。

所需范围

Tenant.Read.All 或 Tenant.ReadWrite.All

限制

每小时最多 200 个请求。

GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/unused

With optional parameters:

GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/unused?continuationToken={continuationToken}

URI 参数

名称	在	必需	类型	说明
groupId	path	True	string uuid	工作区 ID
continuationToken	query		string	获取结果集的下一个区块所需的令牌

响应

名称	类型	说明
200 OK	UnusedArtifactsResponse	确定

示例

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/unused

Sample Response

Status code:

200

定义

名称	说明
UnusedArtifactEntity	未使用的 Power BI 项实体
UnusedArtifactsResponse	未使用的 Power BI 项的 OData 响应包装器 (，例如报表或仪表板) 实体

UnusedArtifactEntity

未使用的 Power BI 项实体

名称	类型	说明
artifactId	string	Power BI 项的 ID
artifactSizeInMB	integer	如果适用) ，则 Power BI 项的大小（以兆字节为单位） (
artifactType	string	Power BI 项类型
createdDateTime	string	如果适用) ，Power BI 项的创建时间 (
displayName	string	Power BI 项的显示名称
lastAccessedDateTime	string	Power BI 项的最后一次访问时间 (（如果适用）)

UnusedArtifactsResponse

未使用的 Power BI 项的 OData 响应包装器 (，例如报表或仪表板) 实体

名称	类型	说明
continuationToken	string	用于获取结果集的下一个区块的令牌
continuationUri	string	结果集中下一个区块的 URI
unusedArtifactEntities	UnusedArtifactEntity[]	未使用的 Power BI 项实体