调用DescribeScanTaskProgress接口查询病毒扫描任务进度。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeScanTaskProgress

需要执行的操作。

取值:DescribeScanTaskProgress

TaskId Long 282832

指定要查询的病毒扫描任务ID。

说明 您可以调用StartVirusScanTask接口获取该参数。

调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见公共参数

调用API的请求格式,请参见本文示例中的请求示例。

返回数据

名称 类型 示例值 描述
RequestId String EA15BA8A-D631-4375-8D40-CB7C769B0279

阿里云为该请求生成的唯一标识符。

ScanTaskProgress String Success

病毒扫描任务的进度。取值:

  • init:扫描任务初始化中。
  • Processing:扫描任务进行中。
  • Success:扫描任务已完成。
  • Failed:扫描任务执行失败。
TargetInfo String [{"type":"uuid","name":"host001","target":"503201a7-14c6-4280-801b-1169ed42****"}]

病毒扫描任务扫描的资产信息。该参数使用JSON数组转化的字符串格式表示。包含以下字段:

  • type:执行病毒扫描的资产类型。取值:
    • groupId:服务器分组。
    • uuid:服务器。
  • name:服务器分组名称或服务器的名称。
  • target:执行病毒扫描的资产。以下是该字段的取值说明:
    • type的值为groupId时,该字段为服务器分组ID。
    • type的值为uuid时,该字段为服务器的UUID。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeScanTaskProgress
&TaskId=282832
&<公共请求参数>

正常返回示例

XML格式

<DescribeScanTaskProgressResponse>
      <TargetInfo>[{"type":"uuid","name":"host001","target":"503201a7-14c6-4280-801b-1169ed42****"}]</TargetInfo>
      <RequestId>EA15BA8A-D631-4375-8D40-CB7C769B0279</RequestId>
      <ScanTaskProgress>Success</ScanTaskProgress>
</DescribeScanTaskProgressResponse>

JSON格式

{
	"TargetInfo": "[{\"type\":\"uuid\",\"name\":\"host001\",\"target\":\"503201a7-14c6-4280-801b-1169ed42****\"}]",
	"RequestId": "EA15BA8A-D631-4375-8D40-CB7C769B0279",
	"ScanTaskProgress": "Success"
}

错误码

访问错误中心查看更多错误码。