All Products
Search
Document Center

Security Center:StartVirusScanTask

Last Updated:May 22, 2025

Performs a virus scan task on a server or multiple servers.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
TargetInfostringYes

The asset on which you want to perform a virus scan task. You can select servers or server groups to scan for viruses. The value is a string that consists of JSON arrays. Each element in a JSON array is a JSON struct that contains the following fields:

  • type: the type of the asset on which you want to perform a virus scan task. Valid values:

    • groupId: server group.
    • uuid: server.
  • name: the name of the server or server group.

  • target: the asset on which you want to perform a virus scan task. Valid values:

    • If you set type to groupId, you must set this field to the ID of the server group. You can call the DescribeAllGroups operation to query the IDs of server groups.
    • If you set type to uuid, you must set this field to the UUID of the server. You can call the DescribeCloudCenterInstances operation to query the UUIDs of servers.
[{"type":"uuid","name":"Host001","target":"503201a7-14c6-4280-801b-1169ed42****"}]

Response parameters

ParameterTypeDescriptionExample
object
ScanTaskIdlong

The ID of the virus scan task.

282832
RequestIdstring

The ID of the request, which is used to locate and troubleshoot issues.

DAE17926-4ABE-4DBD-9600-DDCB9B200F35

Examples

Sample success responses

JSONformat

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

Error codes

HTTP status codeError codeError messageDescription
400IllegalParamIllegal param-
403NoPermissioncaller has no permissionYou are not authorized to do this operation.
500ServerErrorServerError-

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2022-08-01The Error code has changedView Change Details
2022-08-01The Error code has changedView Change Details