Task

Объект Task содержит данные о задаче. Задача — это анализ файла на отдельной платформе. Task может содержать различный набор ключей: TaskBasic, TaskFinished или TaskProcessing.

TaskBasic

TaskBasic содержит общие сведения о задаче. Такой объект с базовым набором ключей используется в списке объектов Analysis.

Структура

Ключ

Тип

Описание

id

number

ID задачи.

status

string

Статус задачи.

maliciousness

number

Вредоносность, от 0 до 100.

platform_code

string

Platform.code.

start_date

string

Дата и время запуска задачи.

end_date

string

Дата и время завершения задачи.

Пример

{

   "id": 16916,

   "status": "successful",

   "maliciousness": 100,

   "platform_code": "winxpx86",

   "start_date": "2018-12-12T11:29:44.645968+00:00",

   "end_date": "2018-12-12T11:33:37.490050+00:00"

}

TaskFinished

TaskFinished содержит ключи объекта TaskBasic и результаты анализа файла на заданной платформе.

Структура

Ключ

Тип

Описание

id

number

ID задачи.

status

string

Статус задачи.

maliciousness

number

Вредоносность, от 0 до 100.

platform_code

string

Platform.code.

start_date

string

Дата и время запуска задачи.

end_date

string

Дата и время окончания задачи.

verdict

string

Общая оценка вредоносности файла, соответствующая одной из трех категорий. Большее цифровое значение соответствует большей вероятности вредоносности.

rules

object

Список сработанных правил.

detects

string

В поле behavior отображается информация о типе поведения файла. В поле files_dumps сообщается о найденных угрозах в созданных файлах и дампах памяти.

Пример

{

 "id": 16916,

 "status": "successful",

 "maliciousness": 100,

 "platform_code": "winxpx86",

 "start_date": "2018-12-12T11:29:44.645968+00:00",

 "end_date": "2018-12-12T11:33:37.490050+00:00",

 "verdict": "malware2",

 "rules": null,

 "detects": [

    "files_dumps"

  ],

 "platform_code": "win7x64"

}

TaskProcessing

TaskProcessing содержит ключи объекта TaskBasic и данные о ходе анализа.

Структура

Ключ

Тип

Описание

id

number

ID задачи.

status

string

Статус задачи.

maliciousness

number

Вредоносность, от 0 до 100.

platform_code

string

Platform.code.

start_date

string

Дата и время запуска задачи.

end_date

string

Дата и время окончания задачи.

message

string

Сообщение о прогрессе выполнения.

progress

number

Прогресс выполнения задачи, в процентах.

Пример

{

 "id": 18656,

 "status": "processing",

 "maliciousness": null,

 "platform_code": "win7x86",

 "start_date": "2019-02-07T09:39:11.517117+00:00",

 "end_date": null,

 "message": "Waiting while the file is running (60 sec)…",

 "progress": 19

}