任务对象

以下objects与taskAPI直接相关.

任务object具有以下属性:

属性	数据类型	描述
taskid	ID	任务ID. 属性行为: - 只读
type	integer	任务类型. 可选值: 1 - 诊断信息; 2 - 刷新proxy配置; 6 - 立即执行. 从Zabbix 7.0.19开始，Admin和User类型用户可以create'立即执行'任务. 注意`task.get`总是返回"7"(任务执行摘要). 属性行为: - 必填
status	integer	任务状态. 可选值: 1 - 新任务; 2 - 任务进行中; 3 - 任务已完成; 4 - 任务已过期. 属性行为: - 只读
clock	timestamp	任务创建时间. 属性行为: - 只读
ttl	integer	任务过期时间(秒). 属性行为: - 只读
proxyid	ID	收集诊断信息统计的proxyID. 属性行为: - 支持当`type`设置为"诊断信息"或"刷新proxy配置"时
request	object	根据任务类型的任务请求object: '立即执行'任务的object是立即检查请求-object; '刷新proxy配置'任务的object是described in detail below; '诊断信息'任务的object是诊断信息请求-object. 属性行为: - 必填
result	object	诊断信息任务的结果object. 结果未就绪时可能为NULL. 结果object是统计结果-object. 属性行为: - 只读

'立即执行'任务请求object具有以下属性。

属性	数据类型	描述
itemid	ID	监控项和低级发现规则的ID。从Zabbix 7.0.19开始，管理员和用户类型用户可以对具有读写permission权限，或读取权限且其角色启用了`invoke_execute_now`动作的主机执行'立即执行'监控项操作。此规则同样适用于管理员类型用户对低级发现(LLD)规则的操作。

“刷新 proxy 配置”任务请求 object 具有以下属性。

属性	数据类型	描述
proxyids	array	Proxy ID。

诊断信息任务请求 object 具有以下属性。所有类型属性的统计请求 object 的说明请参见统计请求-object。

属性	数据类型	描述
historycache	object	history cache 统计请求。适用于服务器和 proxy。
valuecache	object	监控项缓存统计请求。适用于服务器。
preprocessing	object	预处理管理器统计请求。适用于服务器和 proxy。
alerting	object	告警管理器统计请求。适用于服务器。
lld	object	LLD 管理器统计请求。适用于服务器。

统计请求 object 用于定义应收集哪些有关 server/proxy 内部进程的信息。它具有以下属性。

属性	数据类型	描述
stats	query	要返回的统计 object 属性。每种诊断信息统计类型的可用字段列表见每种诊断信息请求类型可用的统计字段列表。默认值：`extend` 将返回所有可用的统计字段。
top	object	用于对返回的统计值进行排序和限制的 object。每种诊断信息统计类型的可用字段列表见每种诊断信息请求类型可用的排序字段列表。示例：{ “source.alerts”: 10 }

以下统计字段可以按每种诊断信息请求属性进行请求。

诊断类型	可用字段	描述
historycache	监控项	缓存的监控项数量。
	values	缓存值的数量。
	memory	共享 memory 统计信息（空闲空间、已使用块数量、空闲块数量、最大空闲块大小）。
	memory.data	历史数据缓存共享 memory 统计信息。
	memory.index	历史 index cache 缓存共享 memory 统计信息。
valuecache	监控项	缓存的监控项数量。
	values	缓存值的数量。
	memory	共享 memory 统计信息（空闲空间、已使用块数量、空闲块数量、最大空闲块大小）。
	mode	value cache 模式。
preprocessing	values	排队中的值数量。
preprocessing	preproc.values	带预处理步骤的排队值数量。
alerting	alerts	排队中的告警数量。
lld	rules	排队中的规则数量。
lld	values	排队中的值数量。

以下统计字段可用于对请求的信息进行排序和限制。

统计结果 object 会在任务 object 的 result 字段中检索到。

属性	数据类型	描述
status	integer	任务结果的状态。可能的值： - 1 - 执行任务期间发生错误； 0 - 任务结果已创建。属性行为： - 只读
data	string/object	根据特定诊断信息任务的统计请求 object 得到的结果。如果执行任务期间发生错误，则包含错误信息 string。

Documentation