All Products
Search
Document Center

Security Center:DescribeLatestScanTask

Last Updated:Apr 28, 2023

Queries the progress of the last virus scan task.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
The current API does not require request parameters

Response parameters

ParameterTypeDescriptionExample
object
TargetInfostring

The information about the asset on which the virus scan task runs. 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 the virus scan task runs. Valid values:

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

  • target: the asset on which the virus scan task runs The value of this field varies based on the value of the type field.

    • If the value of type is groupId, the value of this field is the ID of the server group.
    • If the value of type is uuid, the value of this field is the UUID of the server.
[{"type":"uuid","name":"Host001","target":"503201a7-14c6-4280-801b-1169ed42****"}]
RequestIdstring

The ID of the request.

7E0618A9-D5EF-4220-9471-C42XXXXXXXX
LastCheckTimelong

The timestamp when the last check was performed. Unit: milliseconds.

1671610264000
RiskNuminteger

The number of virus detection risks on the server.

1
Uuidsarray

The ID of the asset.

string

The ID of the asset.

d77f7802-4f0a-4221-ab02-4d999e****

Examples

Sample success responses

JSONformat

{
  "TargetInfo": "[{\"type\":\"uuid\",\"name\":\"Host001\",\"target\":\"503201a7-14c6-4280-801b-1169ed42****\"}]",
  "RequestId": "7E0618A9-D5EF-4220-9471-C42XXXXXXXX",
  "LastCheckTime": 1671610264000,
  "RiskNum": 1,
  "Uuids": [
    "d77f7802-4f0a-4221-ab02-4d999e****"
  ]
}

Error codes

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

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