Admin - WorkspaceInfo GetModifiedWorkspaces

參考

服務:: Power BI REST APIs

API 版本:: v1.0

取得組織中的工作區識別碼清單。

如果選擇性 modifiedSince 參數設定為日期時間，則只會傳回該日期時間之後變更的工作區識別碼。 modifiedSince如果未使用參數，則會傳回組織中所有工作區的識別碼。參數指定的 modifiedSince 日期時間必須介於 30 分鐘 (範圍內，才能讓工作區變更生效，) 到目前時間前 30 天生效。

權限

使用者必須具有系統管理員許可權 (，例如 Microsoft 365 全域管理員或 Power BI 服務管理員) 或使用服務主體進行驗證。

在服務主體驗證下執行時，應用程式不得在Azure 入口網站中設定 Power BI 的任何管理員同意許可權。

必要範圍

Tenant.Read.All 或 Tenant.ReadWrite.All

只有在透過標準委派的系統管理員存取權杖進行驗證時才相關。使用透過服務主體進行驗證時，不得存在。

限制

每小時最多 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 參數

名稱	位於	類型	Description
excludeInActiveWorkspaces	query	boolean	是否要排除非作用中的工作區
excludePersonalWorkspaces	query	boolean	是否要排除個人工作區
modifiedSince	query	string date-time	上次修改日期 (必須是符合 ISO 8601 規範的 UTC 格式)

回應

名稱	類型	Description
200 OK	ModifiedWorkspace[]	[確定]

範例

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

修改後的工作區

名稱	類型	Description
id	string	工作區物件識別碼

共用方式為