GetFileDetection - 查询文件检测结果--高级网络威胁检测系统-火山引擎

文档中心

立即注册

导航

GetFileDetection - 查询文件检测结果

最近更新时间：2024.10.22 15:26:07首次发布时间：2024.10.21 16:29:15

查询文件检测结果，包括文件 MD5 值、大小、文件类型、检测状态和病毒种类等信息。

使用说明

查询检测结果需要获取 QueryKey，您可以调用CreateFileDetection - 创建文件送检任务获取。

请求说明

请求方式：POST
请求地址：https://open.volcengineapi.com/?Action=GetFileDetection&Version=2024-07-30

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

参数	类型	是否必填	示例值	描述
Action	String	是	GetFileDetection	要执行的操作，取值：GetFileDetection。
Version	String	是	2024-07-30	API的版本，取值：2024-07-30。
QueryKey	String	是	d41d8cd98*************8ecf8427e	查询文件检测结果的标识，可以调用CreateFileDetection - 创建文件送检任务获取。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
FileMd5	String	d41d8cd98*************8ecf8427e	文件的 MD5 值。
FileSecType	Integer	2	文件检出的类型，取值列表： 0: 未知文件 1: 普通文件 2: 病毒文件
FileSize	Long	5001856	文件大小，单位：字节。
Finish	Integer	1	文件检测的状态，取值列表： -2: 文件未检测 -1: 检测失败 1: 检测中 2: 检测完成
VirusDesc	String	Trojan	病毒种类描述。

请求示例

POST /?Action=GetFileDetection&Version=2024-07-30 HTTP/1.1
Host: open.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20241022T062335Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20241022/cn-beijing/nta/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "QueryKey": "d41d8cd98*************8ecf8427e"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "2024102211260****068125174010BAC",
    "Action": "GetFileDetection",
    "Version": "2024-07-30",
    "Service": "nta",
    "Region": "cn-beijing"
  },
  "Result": {
    "FileMd5": "d41d8cd98*************8ecf8427e",
    "FileSecType": 2,
    "FileSize": 5001856,
    "Finish": 1,
    "VirusDesc": "Trojan"
  }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	InvalidParameter	The specified parameter %s is invalid.	参数不合法。
400	MissingParameter	The required parameter %s is missing.	请求缺少接口必填参数。
403	AccessDenied	You are not authorized to perform this action.	没有相应的接口执行权限。
500	InternalError	The request has failed due to an unknown error.	请求失败，内部错误，一般是接口崩溃或者出现未知错误。
503	ServiceUnavailable	The request has failed due to a temporary failure of the server.	请求失败，一般在服务短暂不可用时发生。