[comment]: # aside: 1

[comment]: # ({0fc3ae4e-92e6c52c})
# Объект task

Следующие объекты напрямую связаны с API `task`.

### Task

Объект task имеет следующие свойства:

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|--|
|taskid|ID|ID задачи.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|
|type|integer|Тип задачи.<br><br>Возможные значения:<br>1 - диагностическая информация;<br>2 - обновление конфигурации прокси;<br>6 - выполнить сейчас.<br><br>Начиная с Zabbix 7.4.3, пользователи типов *Admin* и *User* могут создавать задачи типа "Execute now".<br><br>Обратите внимание, что `task.get` всегда возвращает "7" (сводка выполнения задачи).<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *обязательно*|
|status|integer|Статус задачи.<br><br>Возможные значения:<br>1 - новая задача;<br>2 - задача в процессе выполнения;<br>3 - задача завершена;<br>4 - срок действия задачи истек.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|
|clock|timestamp|Время создания задачи.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|
|ttl|integer|Время в секундах, по истечении которого задача становится просроченной.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|
|proxyid|ID|ID прокси, по которому собирается статистика диагностической информации.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *поддерживается*, если `type` установлено в "Diagnostic information" или "Refresh proxy configuration"|
|request|object|Объект запроса задачи в зависимости от типа задачи:<br>Объект задачи 'Execute now' [подробно описан ниже](/manual/api/reference/task/object#check-now-request-object);<br>Объект задачи 'Refresh proxy configuration' [подробно описан ниже](/manual/api/reference/task/object#refresh-proxy-configuration);<br>Объект задачи 'Diagnostic information' [подробно описан ниже](/manual/api/reference/task/object#diagnostic-information-request-object).<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *обязательно*|
|result|object|Объект результата задачи диагностической информации.<br>Может содержать NULL, если результат еще не готов.<br>Объект результата [подробно описан ниже](/manual/api/reference/task/object#statistic-result-object).<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|

[comment]: # ({/0fc3ae4e-92e6c52c})

[comment]: # ({4dff159c-cd63c2fd})
#### Объект запроса 'Execute now'

Объект запроса задачи 'Execute now' имеет следующие свойства.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|itemid|ID|ID элемента данных и правил низкоуровневого обнаружения.<br><br>Начиная с Zabbix 7.4.3, пользователи типов *Admin* и *User* могут выполнять 'Execute now' для элементов данных на узлах сети, для которых у них есть [разрешение](/manual/api/reference/usergroup/object#permission) *read-write* или разрешение *read* и для их роли включено [действие](/manual/api/reference/role/object#action) `invoke_execute_now`. То же самое относится к пользователям типа *Admin* для правил низкоуровневого обнаружения (LLD).|

[comment]: # ({/4dff159c-cd63c2fd})

[comment]: # ({f395f844-b5d3bd1c})
#### Объект запроса 'Refresh proxy configuration'

Объект запроса задачи 'Refresh proxy configuration' имеет следующие свойства.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|proxyids|array|Идентификаторы прокси.|

[comment]: # ({/f395f844-b5d3bd1c})

[comment]: # ({1249a0ab-52d75b77})
#### Объект запроса 'Diagnostic information'

Объект запроса задачи диагностической информации имеет следующие
свойства. Объект запроса статистики для всех типов свойств
[подробно описан ниже](/manual/api/reference/task/object#statistic-request-object).

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|historycache|object|Запрос статистики кэша истории. Доступно на сервере и прокси.|
|valuecache|object|Запрос статистики кэша элементов данных. Доступно на сервере.|
|preprocessing|object|Запрос статистики менеджера предварительной обработки. Доступно на сервере и прокси.|
|alerting|object|Запрос статистики менеджера оповещений. Доступно на сервере.|
|lld|object|Запрос статистики менеджера LLD. Доступно на сервере.|

[comment]: # ({/1249a0ab-52d75b77})

[comment]: # ({2eb185f8-5149852c})
##### Объект запроса статистики

Объект запроса статистики используется для определения того, какой тип информации
следует собирать о внутренних процессах сервера/прокси. Он имеет
следующие свойства.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|stats|query|Свойства объекта статистики, которые нужно вернуть.<br>Список доступных полей для каждого типа статистики диагностической информации [подробно описан ниже](object#list-of-statistic-fields-available-for-each-type-of-diagnostic-information-request).<br><br>По умолчанию: `extend` вернет все доступные поля статистики.|
|top|object|Объект для сортировки и ограничения возвращаемых значений статистики.<br>Список доступных полей для каждого типа статистики диагностической информации [подробно описан ниже](object#list-of-sorting-fields-available-for-each-type-of-diagnostic-information-request).<br><br>Пример: { “source.alerts”: 10 }|

[comment]: # ({/2eb185f8-5149852c})

[comment]: # ({50ca4dca-60e59ca2})
###### Список полей статистики, доступных для каждого типа запроса диагностической информации

Для каждого свойства запроса диагностической информации можно запросить следующие поля статистики.

|Diagnostic type|Available fields|Description|
|--|--|------|
|historycache|items|Количество кэшированных элементов данных.|
|^|values|Количество кэшированных значений.|
|^|memory|Статистика общей памяти (свободное пространство, количество используемых блоков, количество свободных блоков, максимальный размер свободного блока).|
|^|memory.data|Статистика общей памяти кэша исторических данных.|
|^|memory.index|Статистика общей памяти кэша индекса истории.|
|valuecache|items|Количество кэшированных элементов данных.|
|^|values|Количество кэшированных значений.|
|^|memory|Статистика общей памяти (свободное пространство, количество используемых блоков, количество свободных блоков, максимальный размер свободного блока).|
|^|mode|Режим кэша значений.|
|preprocessing|values|Количество значений в очереди.|
|^|preproc.values|Количество значений в очереди со шагами предварительной обработки.|
|alerting|alerts|Количество оповещений в очереди.|
|lld|rules|Количество правил в очереди.|
|^|values|Количество значений в очереди.|

[comment]: # ({/50ca4dca-60e59ca2})

[comment]: # ({a768b834-09dc3377})
###### Список полей сортировки, доступных для каждого типа запроса диагностической информации

Следующие статистические поля можно использовать для сортировки и ограничения запрашиваемой
информации.

|Diagnostic type|Available fields|[Type](/manual/api/reference_commentary#data-types)|
|--|--|------|
|historycache|values|integer|
|valuecache|values|integer|
|^|request.values|integer|
|preprocessing|values|integer|
|alerting|media.alerts|integer|
|^|source.alerts|integer|
|lld|values|integer|

[comment]: # ({/a768b834-09dc3377})

[comment]: # ({13093171-e680be6c})
##### Объект результата статистики

Объект результата статистики извлекается в поле `result` объекта задачи.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|status|integer|Статус результата задачи.<br><br>Возможные значения:<br>-1 - при выполнении задачи произошла ошибка;<br>0 - результат задачи создан.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*|
|data|string/object|Результаты в соответствии с объектом запроса статистики для конкретной задачи диагностической информации.<br>Содержит строку сообщения об ошибке, если при выполнении задачи произошла ошибка.|

[comment]: # ({/13093171-e680be6c})