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 參數

名稱	位於	必要	類型	Description
groupId	path	True	string uuid	工作區識別碼
continuationToken	query		string	取得結果集下一個區塊所需的權杖

回應

名稱	類型	Description
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

定義

名稱	Description
UnusedArtifactEntity	未使用的 Power BI 專案實體
UnusedArtifactsResponse	未使用 Power BI 專案的 OData 回應包裝函式 (，例如報表或儀表板) 實體

UnusedArtifactEntity

未使用的 Power BI 專案實體

名稱	類型	Description
artifactId	string	Power BI 專案的識別碼
artifactSizeInMB	integer	如果適用) ，則以 MB 為單位的 Power BI 專案大小 (
artifactType	string	Power BI 專案類型
createdDateTime	string	如果適用，Power BI 專案的建立時間 ()
displayName	string	Power BI 專案的顯示名稱
lastAccessedDateTime	string	如果適用) ，Power BI 專案的最後一次存取時間 (

UnusedArtifactsResponse

未使用 Power BI 專案的 OData 回應包裝函式 (，例如報表或儀表板) 實體

名稱	類型	Description
continuationToken	string	取得結果集下一個區塊的權杖
continuationUri	string	結果集中下一個區塊的 URI
unusedArtifactEntities	UnusedArtifactEntity[]	未使用的 Power BI 專案實體