调用StartVirusScanTask接口在一台或多台服务器上执行病毒扫描任务。

调试

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

请求参数

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

需要执行的操作。

取值:StartVirusScanTask

TargetInfo String [{"type":"uuid","name":"Host001","target":"503201a7-14c6-4280-801b-1169ed42****"}]

指定执行病毒扫描的资产。支持选择服务器分组或服务器执行扫描病毒,该参数使用JSON数组转化的字符串格式表示。包含以下字段:

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

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

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

返回数据

名称 类型 示例值 描述
RequestId String DAE17926-4ABE-4DBD-9600-DDCB9B200F35

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

ScanTaskId Long 282832

病毒扫描任务的ID。

示例

请求示例

http(s)://[Endpoint]/?Action=StartVirusScanTask
&TargetInfo=[{"type":"uuid","name":"Host001","target":"503201a7-14c6-4280-801b-1169ed42****"}]
&<公共请求参数>

正常返回示例

XML格式

<StartVirusScanTaskResponse>
      <RequestId>DAE17926-4ABE-4DBD-9600-DDCB9B200F35</RequestId>
      <ScanTaskId>282832</ScanTaskId>
</StartVirusScanTaskResponse>

JSON格式

{
	"RequestId": "DAE17926-4ABE-4DBD-9600-DDCB9B200F35",
	"ScanTaskId": 282832
}

错误码

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