> 对象

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

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

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

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

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

属性 [	型](/zh//manual/api/reference_commentary#data_types) 描述
itemid	字符监	项和低级别发现规则的ID。

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

属性 [	型](/zh/manual/api/reference_commentary#data_types) 描述
historycache	对象历	缓存的统计请求。用于服务端和代理端。
valuecache	对象监	项缓存的统计请求。用于服务端。
preprocessing	对象预	理管理的统计请求。用于服务端和代理端。
alerting	对象告	管理的统计请求。用于服务端。
lld	对象低	别发现的统计请求。用于服务端。

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

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

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

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

诊断类型可用字	[类型](/z	/manual/api/reference_commentary#data_types)
historycache	values	整型
valuecache	values	整型
valuecache	request.values	整型
preprocessing	values	整型
alerting	media.alerts	整型
alerting	source.alerts	整型
lld	values	整型

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

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

Documentation