获取 IP 统计信息 API

2025-02-15

适用于：

希望体验 Defender for Endpoint？注册免费试用版。

注意

如果你是美国政府客户，请使用美国政府客户Microsoft Defender for Endpoint中列出的 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 说明

检索给定 IP 的统计信息。

限制

此 API 的速率限制是每分钟 100 个调用和每小时 1500 个调用。
Lookbackhours 的最大值为 720 小时 (30 天) 。

权限

要调用此 API，需要以下权限之一。若要了解详细信息（包括如何选择权限），请参阅使用Microsoft Defender for Endpoint API

权限类型	权限	权限显示名称
应用程序	Ip.Read.All	“读取 IP 地址配置文件”
委派（工作或学校帐户）	Ip.Read.All	“读取 IP 地址配置文件”

注意

使用用户凭据获取令牌时：

用户至少需要具有以下角色权限：“查看数据” (有关详细信息，请参阅创建和管理角色)

HTTP 请求

GET /api/ips/{ip}/stats

请求标头

名称	类型	说明
Authorization	String	持有者 {token}。必需。

请求 URI 参数

名称	类型	说明
lookBackHours	Int32	定义我们搜索回以获取统计信息的小时数。默认值为 30 天。可选。

请求正文

Empty

响应

如果成功且 IP 存在 - 200 正常，正文中包含统计数据。 IP 有效但不存在 - organizationPrevalence 0，IP 无效 - HTTP 400。

示例

请求示例

下面是请求的示例。

GET https://api.security.microsoft.com/api/ips/10.209.67.177/stats?lookBackHours=48

响应示例

以下是响应示例。

{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#microsoft.windowsDefenderATP.api.InOrgIPStats",
    "ipAddress": "10.209.67.177",
    "organizationPrevalence": 63515,
    "orgFirstSeen": "2017-07-30T13:36:06Z",
    "orgLastSeen": "2017-08-29T13:32:59Z"
}

名称	说明
组织普及率	打开到此 IP 的网络连接的设备的非重复计数。
首次看到组织	组织中此 IP 的第一个连接。
上次看到组织	组织中此 IP 的最后一个连接。

注意

此统计信息基于过去 30 天的数据。

提示

想要了解更多信息？ Engage技术社区中的Microsoft安全社区：Microsoft Defender for Endpoint技术社区。