将文件上传到实时响应库
适用于：
重要
本文中的某些信息与预发行的产品有关，该产品在商业发布之前可能有重大修改。 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
- ina.api.security.microsoft.com
API 说明
将文件上传到实时响应库。
限制
最大文件大小限制为 20MB。
此 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"
相关主题
提示
想要了解更多信息？ 在技术社区中与 Microsoft 安全社区互动： Microsoft Defender for Endpoint 技术社区。