Admin - WorkspaceInfo GetModifiedWorkspaces

サービス:: Power BI REST APIs

API バージョン:: v1.0

組織内のワークスペース ID の一覧を取得します。

省略可能な modifiedSince パラメーターが日時に設定されている場合は、その日時より後に変更されたワークスペースの ID のみが返されます。 modifiedSince パラメーターを使用しない場合は、組織内のすべてのワークスペースの ID が返されます。 modifiedSince パラメーターで指定する日時は、現在の時刻の 30 日前まで (ワークスペースの変更を有効にするために) 30 分の範囲である必要があります。

Permissions

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

サービスプリンシパル認証で実行する場合、アプリには、Azure portal で Power BI に対して管理者の同意が必要なアクセス許可が設定 されていない必要があります 。

必要なスコープ

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

標準の委任された管理者アクセストークンを使用して認証する場合にのみ関連します。サービスプリンシパル経由の認証を使用する場合は、存在しない必要があります。

制限事項

1 時間あたり最大 30 個の要求。

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified

省略可能なパラメーターを含む:

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified?modifiedSince={modifiedSince}&excludePersonalWorkspaces={excludePersonalWorkspaces}&excludeInActiveWorkspaces={excludeInActiveWorkspaces}

URI パラメーター

名前	/	型	説明
excludeInActiveWorkspaces	query	boolean	非アクティブなワークスペースを除外するかどうか
excludePersonalWorkspaces	query	boolean	個人用ワークスペースを除外するかどうか
modifiedSince	query	string (date-time)	最終更新日 (ISO 8601 準拠 UTC 形式である必要があります)

応答

名前	型	説明
200 OK	ModifiedWorkspace[]	[OK]

例

Example

要求のサンプル

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/modified?modifiedSince=2020-10-02T05:51:30.0000000Z&excludePersonalWorkspaces=True&excludeInActiveWorkspaces=True

応答のサンプル

状態コード:: 200

[
  {
    "id": "3740504d-1f93-42f9-8e9d-c8ba9b787a3b"
  },
  {
    "id": "19cb346c-9839-4e19-81e6-76364d0b836f"
  }
]

定義

ModifiedWorkspace

Object

変更されたワークスペース

名前	型	説明
id	string (uuid)	ワークスペースオブジェクト ID