依會話取得掃描歷程記錄

發行項
03/03/2025

適用於：

想要體驗適用於端點的 Microsoft Defender 嗎？注册免費試用版。

想要體驗 Microsoft Defender 弱點管理嗎？深入瞭解如何註冊 Microsoft Defender 弱點管理公開預覽試用版。

重要事項

本文中的部分資訊與發行前版本產品有關，在產品正式發行前可能會大幅度修改。 Microsoft 對此處提供的資訊，不提供任何明確或隱含的瑕疵擔保。

注意事項

如果您是美國政府客戶，請使用美國政府客戶適用於端點的 Microsoft Defender 中所列的 URI。

提示

為了獲得更好的效能，您可以使用更接近您地理位置的伺服器：

us.api.security.microsoft.com
eu.api.security.microsoft.com
uk.api.security.microsoft.com
au.api.security.microsoft.com
swa.api.security.microsoft.com
ina.api.security.microsoft.com

API 描述

依會話擷取掃描記錄的清單。

限制

此 API 的速率限制為每分鐘 100 次呼叫，每小時 1,500 次呼叫。

權限

呼叫此 API 需要下列其中一個許可權。若要深入瞭解，包括如何選擇許可權，請參閱使用適用於端點的 Microsoft Defender API。

許可權類型	權限	許可權顯示名稱
應用程式	Machine.Read.All	讀取所有掃描資訊。
委派 (公司或學校帳戶)	Machine.Read.All	讀取所有掃描資訊。

注意事項

使用使用者認證取得權杖時：

若要檢視資料，使用者至少必須具有下列角色權限：或 TvmViewDataViewData 如需詳細資訊，請參閱建立和管理角色。

HTTP 要求

POST /api/DeviceAuthenticatedScanDefinitions/GetScanHistoryBySessionId

要求標頭

名稱	類型	描述
授權	字串	持有人 {token}。必要。
Content-Type	字串	application/json。必要。

要求內文

在要求本文中，提供具有下列參數的 JSON 物件：

參數	Type	描述
SessionIds	字串	會話標識碼。必要。

回應

如果成功，這個方法會傳回 200 - OK 回應碼，其中包含會話的掃描歷程記錄清單。

範例要求

以下是要求的範例。

POST https://api.securitycenter.microsoft.com/api/DeviceAuthenticatedScanDefinitions/GetScanHistoryBySessionId

{
    "SessionIds": ["01decc497f4b4ec49a5fc4e12597f8c8"]
}

回應範例

{
 "@odata.context": "https://api.securitycenter.microsoft.com/api/DeviceAuthenticatedScanDefinitions/GetScanHistoryBySessionId",
    "value": [
    {
     "orgId": "asdf781a0c-792d-46d3-bbea-a93dbc0bfcaa",
     "ScanDefinitionIds": "4ad8d463-6b3a-4894-b42a-a2de9ea0a8ae",
     "SessionIds": "01decc497f4b4ec49a5fc4e12597f8c8",
     "NumberOfSuccessfullyScannedTargets": 3,
     "NumberOfTargets": 3,
     "ScanStatus": "Success",
     "LastScanned": "2022-12-19T15:14:24.5561791Z",
     "ListScannedTargets": {
         "Ip": "127.0.0.1",
         "Hostname": "DESKTOP-Test",
         "ScannedDeviceDescription": "Network device",
         "ErrorMessage": "",
         "ScanStatus": "Success",
         "ScanDuration": "00:08:30",
        },
        {
         "Ip": "127.0.0.2",
         "Hostname": "DESKTOP-Test2",
         "ScannedDeviceDescription": "Network device 2",
         "ErrorMessage": "",
         "ScanStatus": "Success",
         "ScanDuration": "00:08:00",
        },
{
         "Ip": "127.0.0.3",
         "Hostname": "DESKTOP-Test3",
         "ScannedDeviceDescription": "Network device 3",
         "ErrorMessage": "",
         "ScanStatus": "Success",
         "ScanDuration": "00:08:50",
        },
    }
  ]
}

提示

想要深入了解? Engage 技術社群中的Microsoft安全性社群：適用於端點的 Microsoft Defender 技術社群。

共用方式為