通过

将文件上传到实时响应库

  • 项目

适用于：

重要

本文中的某些信息与预发行的产品有关，该产品在商业发布之前可能有重大修改。 Microsoft 对此处所提供的信息不作任何明示或默示的保证。

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

API 说明

将文件上传到实时响应库。

限制

  1. 最大文件大小限制为 20MB。

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

权限

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

权限类型 权限 权限显示名称
应用程序 Library.Manage 管理实时响应库
委派（工作或学校帐户） Library.Manage 管理实时响应库

HTTP 请求

上传

POST https://api.security.microsoft.com/api/libraryfiles

请求标头

名称 类型 说明
Authorization String 持有者<令牌>。 必填。
Content-Type string multipart/form-data。 必填。

请求正文

在请求正文中，提供具有以下参数的表单数据对象：

参数 类型 说明
文件 文件内容 要上传到实时响应库的文件。必填
说明 String 文件说明。
ParametersDescription String (运行脚本所需的可选) 参数。 默认值为空字符串。
OverrideIfExists 布尔值 (可选) 是否重写文件（如果已存在）。 默认值为空字符串。

响应

  • 如果成功，此方法在响应正文中返回 200 - 正常响应代码和上传的实时响应库实体。

  • 如果未成功：此方法返回 400 - 错误的请求。 错误的请求通常表示正文不正确。

示例

请求

下面是使用 curl 的请求示例。

curl -X POST https://api.security.microsoft.com/api/libraryfiles -H
"Authorization: Bearer \$token" -F "file=\@mdatp1.png" -F
"ParametersDescription=test"
-F "HasParameters=true" -F "OverrideIfExists=true" -F "Description=test
description"

提示

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