數據對應歷程記錄 (預覽)

發行項
11/13/2024

重要事項

此功能目前處於預覽。 Microsoft Azure 預覽版的補充使用規定包含適用於 Beta、預覽版或尚未正式發行之 Azure 功能的其他法律條款。

當使用者更新 Microsoft Purview 中的資產時，數據對應歷程記錄會變更，並在 Microsoft Purview 入口網站中提供資訊。有關新增或編輯資產的人員、已進行哪些編輯，以及編輯發生的時間等資訊，稍後會儲存供參考。此資訊可協助數據稽核員和企業擁有者維護其Microsoft Purview 帳戶中的合規性和安全性。它也可讓數據管理者和系統管理員對其數據資產中的問題和策劃進行偵錯。

數據對應歷程記錄可供免費和企業版 Microsoft Purview 中的使用者使用。

目前，您可以檢視資產的歷程記錄：

在 Microsoft Purview 入口網站的稽核解決方案中
在個別解決方案內
使用 REST API

必要條件

您必須先在組織中開啟稽核記錄，才能使用數據對應歷程記錄。如果不是，您必須開啟它，才能存取您的數據對應歷程記錄。

哪些資產具有歷程記錄

目前，這些類型的資產具有可用的數據對應歷程記錄：

分類*
數據資產*
詞彙*
商務資產*
網域
集合
角色指派
資料來源
掃描
掃描規則集
憑據
原則

* 解決方案內體驗目前僅適用於分類、數據資產、商務資產和詞彙。

如何使用數據對應歷程記錄

數據對應歷程記錄可讓您查看 Microsoft Purview 中數據對應資產變更的作業歷程記錄。

您可以檢視選取作業的歷程記錄，包括：

創造
更新
指派

如需數據對應歷程記錄中可用作業的完整清單，請參閱稽核記錄活動檔。

重要事項

數據對應歷程記錄專案會在稽核中保留 180 天，並在解決方案內體驗中提供 30 天。若要檢視較長的稽核歷程記錄，您可以使用 Microsoft Purview 稽核 (Premium) 。

稽核解決方案體驗

若要檢視稽核解決方案內的活動，請遵循下列指示：

流覽至 Purview 內的稽核解決方案Microsoft
選 取 [搜尋 ] 以搜尋稽核記錄
選取活動的時間範圍。
使用 活動 - 易記名稱、 活動 - 作業名稱或 記錄類型，縮小搜尋範圍。

提示

如需可用活動的清單，請參閱稽核記錄活動頁面
選 取 [搜尋 ] 並等候作業狀態變更為 [ 完成]。
從清單中選取您的搜尋，然後捲動或篩選歷程記錄數據表，以尋找您要尋找的作業。

解決方案內歷程記錄體驗

注意事項

解決方案內體驗目前僅適用於分類、數據資產、商務資產和詞彙。

若要檢視活動，請遵循下列指示：

在 Microsoft Purview 資料目錄中搜尋數據資產、詞彙或分類。
選取 [ 歷程記錄] 索引 標籤。
卷動或篩選歷程記錄數據表，以尋找您要尋找的作業。

使用 REST API 查詢稽核記錄

您也可以使用 Microsoft Purview REST API 來存取您的數據對應歷程記錄。

若要使用 REST API 進行驗證，請遵循 [ 驗證 API] 頁面上的指示。
使用驗證權杖來 POST 至此要求 URL： https://api.purview-service.microsoft.com/datamap/api/audit/query?api-version=2023-10-01-preview

以下是一些可用來開始使用的 API 呼叫範例：

擷取某個時間範圍內的資產歷程記錄
擷取特定作業的歷程記錄
依編輯資產的用戶篩選
依關鍵詞篩選
分頁範例

擷取某個時間範圍內的資產歷程記錄

取得資產在特定時間範圍內的所有稽核歷程記錄。

{
  "category": "Asset",
  "guid": "f432d351-5442-4724-945b-516d5d501fc9",
  "startTime": "2024-01-01T00:00:00.000Z",
  "endTime": "2024-01-06T00:00:00.000Z",
  "sortBy": "CreationTime",
  "sortOrder": "Descending"
}

擷取特定作業的歷程記錄

取得特定作業類型的歷程記錄。例如，當分類套用至資產時。

提示

如需可用作業的清單，請參閱稽核記錄活動頁面。

{
  "category": "Asset",
  "guid": "f432d351-5442-4724-945b-516d5d501fc9",
  "operationType": "ClassificationAdded",
  "sortBy": "CreationTime",
  "sortOrder": "Descending"
}

依編輯資產的用戶篩選

{
  "category": "Asset",
  "guid": "f432d351-5442-4724-945b-516d5d501fc9",
  "userId": "contoso@microsoft.com",
  "sortBy": "CreationTime",
  "sortOrder": "Descending"
}

依關鍵詞篩選

依關鍵詞篩選，例如已變更的屬性名稱、屬性值等。

{
  "category": "Asset",
  "guid": "f432d351-5442-4724-945b-516d5d501fc9",
  "keywords": "userDescription",
  "sortBy": "CreationTime",
  "sortOrder": "Descending"
}

分頁範例

在第一個查詢之後，如果響應主體中的「lastPage」屬性為 false，則使用可以在回應本文中使用 “continuationToken” 來擷取下一頁。

{
  "continuationToken": "TY7BbsIwEAV%2fKDZr4oQ0KAcEVKo4klNvK…",
  "category": "Asset",
  "guid": "f432d351-5442-4724-945b-516d5d501fc9",
  "sortBy": "CreationTime",
  "sortOrder": "Descending",
  "pageSize": 10
}

限制

目前，作業專案需要幾分鐘的時間才會出現在 [資產 歷程記錄 ] 索引卷標中。
目前，若要查看 [ 歷程記錄] 索引標籤中的新專案，您必須手動重新整理索引卷標。

共用方式為