获取文件信息 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 说明

按标识符 Sha1 或 Sha256 检索文件

限制

此 API 的速率限制是每分钟 100 个调用和每小时 1500 个调用。

权限

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

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

注意

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

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

HTTP 请求

GET /api/files/{id}

请求标头

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

请求正文

Empty

响应

如果成功且存在文件 - 200 正常，且正文中的文件实体为。如果文件不存在 - 404 未找到。

示例

请求示例

下面是请求的示例。

GET https://api.security.microsoft.com/api/files/4388963aaa83afe2042a46a3c017ad50bdcdafb3

响应示例

以下是响应示例。

{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#Files/$entity",
    "sha1": "4388963aaa83afe2042a46a3c017ad50bdcdafb3",
    "sha256": "413c58c8267d2c8648d8f6384bacc2ae9c929b2b96578b6860b5087cd1bd6462",
    "globalPrevalence": 180022,
    "globalFirstObserved": "2017-09-19T03:51:27.6785431Z",
    "globalLastObserved": "2020-01-06T03:59:21.3229314Z",
    "size": 22139496,
    "fileType": "APP",
    "isPeFile": true,
    "filePublisher": "CHENGDU YIWO Tech Development Co., Ltd.",
    "fileProductName": "EaseUS MobiSaver for Android",
    "signer": "CHENGDU YIWO Tech Development Co., Ltd.",
    "issuer": "VeriSign Class 3 Code Signing 2010 CA",
    "signerHash": "6c3245d4a9bc0244d99dff27af259cbbae2e2d16",
    "isValidCertificate": false,
    "determinationType": "Pua",
    "determinationValue": "PUA:Win32/FusionCore"
}

提示

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

通过