取得IP相關警示 API

  • 發行項

適用於：

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

注意事項

如果您是美國政府客戶，請使用美國政府客戶 適用於端點的 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

API 描述

擷取與指定IP位址相關的警示集合。

限制

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

權限

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

許可權類型 權限 許可權顯示名稱
應用程式 Alert.Read.All Read all alerts
應用程式 Alert.ReadWrite.All Read and write all alerts
委派 (公司或學校帳戶) Alert.Read Read alerts
委派 (公司或學校帳戶) Alert.ReadWrite Read and write alerts

注意事項

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

適用於端點的Defender方案1和方案2支援裝置群組建立。

HTTP 要求

GET /api/ips/{ip}/alerts

要求標頭

名稱 類型 描述
授權 字串 持有人 {token}。 必要。

要求內文

Empty

回應

如果成功且IP存在 - 200 確定，內文中 包含警示 實體清單。 如果IP位址未知但有效，則會傳回空集合。 如果IP位址無效，則會傳回 HTTP 400。

範例

請求

以下是要求的範例。

GET https://api.securitycenter.microsoft.com/api/ips/10.209.67.177/alerts

提示

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