获取文件统计信息 API

项目
08/14/2024

适用于：

希望体验 Microsoft 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 说明

检索给定文件的统计信息。

限制

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

权限

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

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

注意

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

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

HTTP 请求

GET /api/files/{id}/stats

请求标头

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

请求 URI 参数

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

请求正文

Empty

响应

如果成功且存在文件 - 200 正常，正文中包含统计数据。如果文件不存在 - 404 未找到。

示例

请求示例

下面是请求的示例。

GET https://api.security.microsoft.com/api/files/0991a395da64e1c5fbe8732ed11e6be064081d9f/stats?lookBackHours=48

响应示例

以下是响应示例。

{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#microsoft.windowsDefenderATP.api.InOrgFileStats",
    "sha1": "0991a395da64e1c5fbe8732ed11e6be064081d9f",
    "organizationPrevalence": 14850,
    "orgFirstSeen": "2019-12-07T13:44:16Z",
    "orgLastSeen": "2020-01-06T13:39:36Z",
    "globallyPrevalence": 705012,
    "globalFirstObserved": "2015-03-19T12:20:07.3432441Z",
    "globalLastObserved": "2020-01-06T13:39:36Z",
    "topFileNames": [
        "MREC.exe"
    ]
}

提示

想要了解更多信息？在技术社区中与 Microsoft 安全社区互动： Microsoft Defender for Endpoint 技术社区。

通过