37.任务 - > 对象 - 《Zabbix 5.0 使用手册》

> 对象

以下对象与 任务 API直接相关。

本节描述任务对象是Zabbix 5.0.5及以后版本才支持的。在旧的Zabbix版本中正确使用task.create，请参阅任务.创建文档。

任务对象支持的属性如下:

属性	类型	描述
taskid	字符	(只读) 任务ID。
type (必须)	整型	任务类型。可以是如下值: 1 - 诊断信息; 6 - 立即检查。
status	整型	(只读) 任务状态。可以是如下值: 1 - 任务新建; 2 - 任务进行中; 3 - 任务完成; 4 - 任务过期。
clock	时间戳	(只读) 任务创建时间。
ttl	整型	(只读) 任务过期时间（秒）。
proxy_hostid	字符	收集到的诊断信息统计的代理的ID. 不含 ‘立即检查’ 任务。
request (必须)	对象	任务请求对象: ‘立即检查’ 任务对象参照详细描述如下; ‘诊断信息’ 任务对象参照详细描述如下。
result	对象	(只读) 诊断信息任务的结果对象。若结果尚未完成会包含空。结果对象详细描述如下。

‘立即检查’ 任务请求对象有如下属性。

属性	类型	描述
itemid	字符	监控项和低级别发现规则的ID。

诊断信息任务请求对象支持的属性如下。所有属性类型的统计请求对象请参阅详细描述如下。

统计请求对象用于定义应该收集哪些类型的关于服务器/代理内部进程的信息。支持如下属性。

属性	类型	描述
stats	查询	返回的统计对象属性。诊断信息统计类型可用的字段列表参照详细描述如下。缺省: 所有可用统计字段会返回`extend`。
top	对象	统计值返回的排序和限制对象。诊断信息统计类型可用的字段列表参照详细描述如下。例如: { “source.alerts”: 10 }

各类型的诊断信息请求属性请求可用下列统计字段。

如下统计字段可用于排序和限制请求的信息。

统计结果对象由任务对象的result字段获取。

属性	类型	描述
status	整型	(只读) 任务结果的状态。可以是如下值: -1 - 任务执行时产生的错误; -0 - 任务结果已创建。
data	字符/对象	结果根据特定诊断信息任务的统计请求对象的结果。若任务执行产生错误时会包含错误信息。