Admin - Groups GetUnusedArtifactsAsAdmin

指定したワークスペースで 30 日以内に使用されていないデータセット、レポート、およびダッシュボードの一覧を返します。 これはプレビュー API 呼び出しです。

権限

  • ユーザーは、ファブリック管理者であるか、サービス プリンシパルを使用して認証されている必要があります。
  • 委任されたアクセス許可がサポートされています。

必要なスコープ

Tenant.Read.All または Tenant.ReadWrite.All

制限

1 時間あたり最大 200 要求。

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

URI パラメーター

Name / 必須 型 説明
groupId
path True

string (uuid)

ワークスペース ID

continuationToken
query

string

結果セットの次のチャンクを取得するために必要なトークン

応答

Name 型 説明
200 OK

UnusedArtifactsResponse

わかりました

例

Example

要求のサンプル

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

応答のサンプル

定義

Name 説明
UnusedArtifactEntity

未使用の Power BI 項目エンティティ

UnusedArtifactsResponse

使用されていない Power BI アイテム (レポートやダッシュボードなど) エンティティの OData 応答ラッパー

UnusedArtifactEntity

未使用の Power BI 項目エンティティ

Name 型 説明
artifactId

string

Power BI 項目の ID

artifactSizeInMB

integer

Power BI 項目のサイズ (MB 単位) (該当する場合)

artifactType

string

Power BI 項目の種類

createdDateTime

string (date-time)

Power BI 項目の作成時刻 (該当する場合)

displayName

string

Power BI 項目の表示名

lastAccessedDateTime

string (date-time)

Power BI 項目の最終アクセス時刻 (該当する場合)

UnusedArtifactsResponse

使用されていない Power BI アイテム (レポートやダッシュボードなど) エンティティの OData 応答ラッパー

Name 型 説明
continuationToken

string

結果セットの次のチャンクを取得するトークン

continuationUri

string

結果セット内の次のチャンクの URI

unusedArtifactEntities

UnusedArtifactEntity[]

未使用の Power BI 項目エンティティ