简介
本文档提供关于提交病毒检测任务的相关 API 概览以及 SDK 示例代码。
API | 操作描述 |
提交病毒检测任务 |
提交病毒检测任务
功能说明
云查毒功能为异步请求方式，您可以通过本接口对云上的文件进行文件病毒（例如木马病毒、蠕虫病毒等）检测，然后通过查询病毒检测结果接口，查询病毒检测的结果。
示例代码
def ci_auditing_virus_submit():response = client.ci_auditing_virus_submit(Bucket=bucket_name, Key="test.png",Url="http://examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/virus.doc", Callback="http://www.demo.com")print(response)
参数说明
调用 ci_auditing_virus_submit 函数，具体请求参数如下：
参数名称 | 参数描述 | 类型 | 是否必填 |
Bucket | 存储桶名称 | String | 是 |
Key | 存储在 COS 存储桶中的病毒文件名称，例如在目录 test 中的文件 virus.doc，则文件名称为 test/virus.doc。
注意：Object 和 Url 只能选择其中一种。 | String | 否 |
Url | 病毒文件的链接地址，例如：
http://examplebucket-1250000000.cos.ap-shanghai.myqcloud.com/virus.doc
注意：Object 和 Url 只能选择其中一种。 | String | 否 |
Callback | 检测结果回调通知到您设置的地址，支持以 http:// 或者 https:// 开头的地址，例如： http://www.callback.com。 | String | 否 |
返回结果说明
响应体 response
响应体具体数据内容如下：
参数名称 | 参数描述 | 类型 |
JobsDetail | 病毒检测任务的详细信息。 | Container |
JobsDetail 节点内容：
参数名称 | 参数描述 | 类型 |
JobId | 本次病毒检测任务的 ID。 | String |
State | 病毒检测任务的状态，值为 Submitted（已提交检测）、Success（检测成功）、Failed（检测失败）、Auditing（检测中）其中一个。 | String |
CreationTime | 病毒检测任务的创建时间。 | String |
