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