Admin - WorkspaceInfo GetModifiedWorkspaces

リファレンス

サービス:: Power BI REST APIs

API バージョン:: v1.0

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

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

アクセス許可

ユーザーは管理者権限 (Microsoft 365 グローバル管理者や Power BI サービス管理者など) を持っているか、サービスプリンシパルを使用して認証する必要があります。

サービスプリンシパル認証で実行する場合、アプリには、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

Sample request

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

Sample response

Status code:: 200

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

定義

ModifiedWorkspace

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

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

次の方法で共有