Admin - WorkspaceInfo GetModifiedWorkspaces

服務:: Power BI REST APIs

API 版本:: v1.0

取得組織中的工作區標識符清單。

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

權限

用戶必須是網狀架構系統管理員，或使用服務主體進行驗證。

在服務主體驗證下執行時，應用程式不得在 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

範例要求

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

已修改的工作區

名稱	類型	Description
id	string (uuid)	工作區物件標識碼

共用方式為