Table of Contents

3 模板

3 模板

概览

模板导出带有许多相关对象和对象关系。

模板导出包含:

被链接的主机群组
模板数据
链接到其他模板
链接到其它主机群组
直接链接监控项
直接链接触发器
直接链接图形
直接链接仪表盘
直接链接自动发现规则及其所有原型（监控项原型、触发器原型、图形原型等等）
直接链接web监控场景
值映射

导出时

导出模板的步骤如下:

前往: 配置 → 模板
标记要导出的模板的复选框
点击列表下方的Export

根据所选择的格式，模板被导出到一个默认名称的本地文件:

zabbix_export_templates.yaml - 在 YAML 中导出 (导出的默认选项)
zabbix_export_templates.xml - 在 XML 中导出
zabbix_export_templates.json - 在 JSON 中导出

导入时

导入模板的步骤如下:

前往: 配置 → 模板
点击右边的Import
选择导入文件
在导入规则中标记所需的选项
点击导入

所有强制输入字段都用红色星号标记。

导入规则：

规则	描述
更新现有的	现有元素将使用从导入文件中获取的数据进行更新。否则，它们将不会被更新。
创建新的	新元素将会被创建，通过使用导入文件的数据。否则，新元素将不会被创建。
删除错误	导入将删除导入文件中不存在的现有元素。否则，它将不会删除它们。如果将删除错误标记为模板链接，则导入文件中不存在的现有模板链接将从模板中移除，同时移除从可能未链接的模板中继承的所有实体(监控项, 触发器, 等等)。

在下一个屏幕上，您将能够查看导入的模板的内容。如果这是一个新模板，所有的元素将以绿色列出。如果更新一个现有的模板，新的模板元素会以绿色高亮显示; 删除的模板元素用红色高亮显示; 未更改的元素以灰色背景列出。

可以使用左边的菜单浏览更改列表。部分被更新突出显示了对现有模板元素所做的所有更改。章节被添加列出了新的模板元素。每个部分中的元素按元素类型分组; 向下按灰色箭头以展开或折叠元素组。

查看模板更改，然后点击导入执行模板导入。前端将显示导入成功或失败的消息。

Export format

When a template is exported, Zabbix generates a structured YAML, JSON, or XML document. This document contains elements that represent all parts of the template, such as template metadata, items, macros, triggers, dashboards, and more.

Each element serves a specific purpose and may contain nested elements.

The following sections describe each element in the export format.

The Linux by Zabbix agent template is used as an example.

An ellipsis (...) indicates content omitted for brevity. The note (see table below) is used when the element is explained in more detail in later sections.

导出元素

导出的元素在下面的表格中进行了解释。

元素		类型	描述
template_groups			(必须) 模板组的根元素
	uuid	字符串	(必须) 此模板组的唯一表示符
	name	字符串	(必须) 模板组名称
host_groups			(必须) 主机群组的根元素，该元素会作为主机属性被使用
	uuid	字符串	(必须) 此主机群组的唯一表示符
	name	字符串	(必须) 主机群组名称
templates			模板的根元素

模板

元素		类型	描述
uuid		字符串	(必须)该模板的唯一标识符。
template		字符串	(必需)唯一的模板名称。
name		字符串	可见的模板名称。
description		文本	模板描述。
vendor			模板供应商的根元素（如果导出的模板可能包含供应商数据）。
	name	字符串	(必需)模板供应商名称。
	version	字符串	(必需)模板版本。对于开箱即用模板，版本显示如下：Zabbix的主要版本号，分隔符("-")，修订号（随着每个新版本的模板增加，Zabbix的主要版本重置）。例如，6.4-0，6.4-3，7.0-0，7.0-3。
templates			关联模板的根元素。
	name	字符串	(必需)模板名称。
groups			模板组的根元素。
	name	字符串	(必需)模板组名称。
items			监控项的根元素。
discovery_rules			模板低级别自动发现规则的根元素。
httptests			模板Web场景的根元素。
tags			模板标签的根元素。
	tag	字符串	(必需)标签名称。
	value	字符串	标签值。
macros			模板用户宏的根元素。
	macro	字符串	(必需)用户宏名称。
	type	字符串	用户宏类型。可能的值：¹ TEXT(0,默认)，SECRET_TEXT(1)，VAULT(2)。
	value	字符串	用户宏值。
	description	字符串	用户宏描述。
dashboards			模板仪表盘的根元素。
valuemaps			模板值映射的根元素。

模板监控项

监控项		类型	描述
uuid		字符串	(必填)该监控项的唯一标识符。
name		字符串	(必填)监控项名称。
type		字符串	监控项类型。可能的取值:¹ ZABBIX_PASSIVE(0,默认),TRAP(2),SIMPLE(3),INTERNAL(5),ZABBIX_ACTIVE(7),EXTERNAL(10),ODBC(11),IPMI(12), SSH(13),TELNET(14),CALCULATED(15),JMX(16),SNMP_TRAP(17),DEPENDENT(18),HTTP_AGENT(19),SNMP_AGENT(20),ITEM_TYPE_SCRIPT(21),ITEM_TYPE_BROWSER(22)。
snmp_oid		字符串	(对于SNMP_AGENT监控项必填)SNMP对象ID。
key		字符串	(必填)监控项键值。
delay		字符串	监控项的更新间隔。默认:1m。对于TRAP监控项，该值始终为0。
history		字符串	历史数据存储时间段（使用时间后缀，用户宏或LLD宏）。默认:31d。
trends		字符串	趋势数据存储时间段（使用时间后缀，用户宏或LLD宏）。默认:365d。
status		字符串	监控项状态。可能的取值:¹ ENABLED(0,默认),DISABLED(1)。
value_type		字符串	接收值类型。可能的取值:¹ FLOAT(0),CHAR(1),LOG(2),UNSIGNED(3,默认),TEXT(4),BINARY(5)。
allowed_hosts		字符串	允许发送数据的主机的逗号分隔IP地址列表。支持TRAP和HTTP_AGENT监控项。
units		字符串	接收值单位（bps,B等）。
params		text	根据监控项的类型附加的参数（对于SSH和TELNET监控项为执行脚本；对于ODBC监控项为SQL查询；对于CALCULATED监控项为公式；对于ITEM_TYPE_SCRIPT和ITEM_TYPE_BROWSER监控项为脚本）。
ipmi_sensor		字符串	IPMI传感器。支持IPMI监控项。
authtype		字符串	认证类型。支持SSH和HTTP_AGENT监控项。 SSH监控项可能的取值:¹ PASSWORD(0,默认),PUBLIC_KEY(1)。 HTTP_AGENT监控项可能的取值:¹ NONE(0,默认),BASIC(1),NTLM(2)。
username		字符串	(对于SSH和TELNET监控项必填)认证用户名。支持SIMPLE,ODBC,JMX和HTTP_AGENT监控项。对于JMX监控项，应同时指定`password`（参见下文）或两者都留空。
password		字符串	(对于SSH和TELNET监控项必填)认证密码。
publickey		字符串	(对于SSH监控项必填)公钥文件名。
privatekey		字符串	(对于SSH监控项必填)私钥文件名。
description		文本	监控项描述。
inventory_link		字符串	由该监控项填充的主机清单字段。可能的取值:¹ NONE(0),ALIAS(4),等（参见主机清单支持的字段）。
valuemap			监控项值映射的根元素。
	name	字符串	(必填)用于该监控项的值映射名称。
logtimefmt		字符串	日志条目中时间的格式。支持日志值类型的监控项。
preprocessing			监控项值预处理的根元素。
	step		模板监控项值预处理步骤的根元素。
jmx_endpoint		字符串	JMX终端点。支持JMX监控项。
master_item			(对于DEPENDENT监控项必填)依赖监控项的主监控项的根元素。
	key	字符串	(必填)依赖监控项的主监控项键。
timeout		字符串	监控项数据轮询请求超时时间。支持超时列表中的监控项类型。
url		字符串	(对于HTTP_AGENT监控项必填)URL字符串。
query_fields			查询参数的根元素。支持HTTP_AGENT监控项。
	name	字符串	(对于HTTP_AGENT监控项必填)查询参数名称。
	value	字符串	查询参数值。支持HTTP_AGENT监控项。
parameters			用户定义参数的根元素。支持ITEM_TYPE_SCRIPT和ITEM_TYPE_BROWSER监控项。
	name	字符串	(对于ITEM_TYPE_SCRIPT和ITEM_TYPE_BROWSER监控项必填)用户定义参数名称。
	value	字符串	用户定义参数值。支持ITEM_TYPE_SCRIPT和ITEM_TYPE_BROWSER监控项。
posts		字符串	HTTP(S)请求主体数据。支持HTTP_AGENT监控项。
status_codes		字符串	所需的HTTP状态码范围，用逗号分隔。仅支持HTTP_AGENT监控项。
follow_redirects		字符串	在获取数据时是否跟随重定向。仅支持HTTP_AGENT监控项。可能的取值:¹ NO(0),YES(1,默认)。
post_type		字符串	发送数据主体的类型。仅支持HTTP_AGENT监控项。可能的取值:¹ RAW(0,默认),JSON(2),XML(3)。
http_proxy		字符串	HTTP(S)代理连接字符串。仅支持HTTP_AGENT监控项。
headers			HTTP(S)请求头的根元素。仅支持HTTP_AGENT监控项。
	name	字符串	(HTTP_AGENT监控项必填)请求头名称。
	value	字符串	(HTTP_AGENT监控项必填)请求头的值。
retrieve_mode		字符串	应存储响应的哪一部分。仅支持HTTP_AGENT监控项。可能的取值:¹ BODY(0,默认),HEADERS(1),BOTH(2)。
request_method		字符串	请求方法类型。仅支持HTTP_AGENT监控项。可能的取值:¹ GET(0,默认),POST(1),PUT(2),HEAD(3)。
output_format		字符串	如何处理响应。仅支持HTTP_AGENT监控项。可能的取值:¹ RAW(0,默认),JSON(1)。
allow_traps		字符串	允许类似于陷阱监控项的方式填充值。仅支持HTTP_AGENT监控项。可能的取值:¹ NO(0,默认),YES(1)。
ssl_cert_file		字符串	公共SSLKey文件路径。仅支持HTTP_AGENT监控项。
ssl_key_file		字符串	私有SSLKey文件路径。仅支持HTTP_AGENT监控项。
ssl_key_password		字符串	SSLKey文件的密码。仅支持HTTP_AGENT监控项。
verify_peer		字符串	是否验证主机的证书是否真实有效。仅支持HTTP_AGENT监控项。可能的取值:¹ NO(0,默认),YES(1)。
verify_host		字符串	是否验证连接的主机名与主机证书中的主机名匹配。仅支持HTTP_AGENT监控项。可能的取值:¹ NO(0,默认),YES(1)。
tags			监控项标签的根元素。
	tag	字符串	(必填)标签名称。
	value	字符串	标签值。
triggers			模板监控项触发器的根元素。

请参阅：监控项对象（参考相应的具有匹配名称的属性）。

模板监控项值预处理步骤

元素		类型	描述
type		字符串	(必填) 监控项值预处理步骤类型。可能的取值:¹ MULTIPLIER (1), RTRIM (2), LTRIM (3), TRIM (4), REGEX (5), BOOL_TO_DECIMAL (6), OCTAL_TO_DECIMAL (7), HEX_TO_DECIMAL (8), SIMPLE_CHANGE (9, 计算: 接收到的值 - 上一个值), CHANGE_PER_SECOND (10, 计算: (接收到的值 - 上一个值)/(当前时间 - 上次检查时间)), XMLPATH (11), JSONPATH (12),IN_RANGE (13), MATCHES_REGEX (14), NOT_MATCHES_REGEX (15), CHECK_JSON_ERROR (16), CHECK_XML_ERROR (17), CHECK_REGEX_ERROR (18), DISCARD_UNCHANGED (19), DISCARD_UNCHANGED_HEARTBEAT (20), JAVASCRIPT (21), PROMETHEUS_PATTERN (22), PROMETHEUS_TO_JSON (23), CSV_TO_JSON (24), STR_REPLACE (25), CHECK_NOT_SUPPORTED (26), XML_TO_JSON (27), SNMP_WALK_VALUE (28), SNMP_WALK_TO_JSON (29), SNMP_GET_VALUE (30)。
parameters			(必填) 监控项值预处理步骤的参数的根元素。
	parameter	字符串	项值预处理步骤的单个参数。
error_handler		字符串	在预处理步骤失败时使用的动作类型。可能的取值:¹ ORIGINAL_ERROR (0, 默认), DISCARD_VALUE (1), CUSTOM_VALUE (2), CUSTOM_ERROR (3).
error_handler_params		字符串	错误处理器参数。

请参阅：监控项预处理对象（参考具有相匹配名称的相关属性）。

模板监控项触发器

元素		类型	描述
uuid		字符串	(必填) 此触发器的唯一标识符。
expression		字符串	(必填) 触发器表达式。
recovery_mode		字符串	生成恢复事件的基础。可能的取值:¹ EXPRESSION (0, 默认), RECOVERY_EXPRESSION (1), NONE (2)。
recovery_expression		字符串	触发器恢复表达式。
correlation_mode		字符串	关联模式（无事件关联或按标签进行事件关联）。可能的取值:¹ DISABLED (0, 默认), TAG_VALUE (1)。
correlation_tag		字符串	用于事件关联的标签名称。
name		字符串	(必填) 触发器名称。
event_name		字符串	事件名称。
opdata		字符串	操作数据。
url_name		字符串	与触发器关联的URL名称。
url		字符串	与触发器关联的URL。
status		字符串	触发器状态。可能的取值:¹ ENABLED (0, 默认), DISABLED (1)。
priority		字符串	触发器严重等级。可能的取值:¹ NOT_CLASSIFIED (0, 默认), INFO (1), WARNING (2), AVERAGE (3), HIGH (4), DISASTER (5)。
description		text	触发器描述。
type		字符串	事件生成类型（单个问题事件或多个问题事件）。可能的取值:¹ SINGLE (0, 默认), MULTIPLE (1)。
manual_close		字符串	手动关闭问题事件。可能的取值:¹ NO (0, 默认), YES (1)。
dependencies			依赖项的根元素。
	name	字符串	(必填) 依赖触发器名称。
	expression	字符串	(必填) 依赖触发器表达式。
	recovery_expression	字符串	依赖触发器恢复表达式。
tags			触发器标签的根元素。
	tag	字符串	(必填) 标签名称。
	value	字符串	标签值。

请参阅：触发器对象（查看具有相匹配名称的相关属性）。

模板低级别自动发现规则

大多数低级别自动发现规则模板元素与模板监控项相同。下表描述了与模板监控项不同的那些元素。

元素	类型	描述
type	字符串	项类型。可能的取值: ¹ ZABBIX_PASSIVE (0, 默认), TRAP (2), SIMPLE (3), INTERNAL (5), ZABBIX_ACTIVE (7), EXTERNAL (10), ODBC (11), IPMI (12), SSH (13), TELNET (14), JMX (16), DEPENDENT (18), HTTP_AGENT (19), SNMP_AGENT (20), ITEM_TYPE_SCRIPT (21), ITEM_TYPE_BROWSER (22).
key	字符串	(必需) 低级别自动发现规则的关键字。
filter		模板低级别自动发现规则过滤器的根元素。
lifetime	字符串	未再发现的资源将被删除的时间段（使用秒、时间后缀或用户宏）。默认: 7d。
lifetime_type	字符串	删除不可用的LLD资源的场景。可能的取值: DELETE_NEVER, DELETE_IMMEDIATELY, DELETE_AFTER。
enabled_lifetime	字符串	启用的LLD资源将被禁用的时间段（使用秒、时间后缀或用户宏）。
enabled_lifetime_type	字符串	禁用不可用的LLD资源的场景。可能的取值: DISABLE_NEVER, DISABLE_IMMEDIATELY, DISABLE_AFTER。
item_prototypes		模板项原型元素的根元素，与模板项相同。
trigger_prototypes		模板触发器原型元素的根元素，与模板项触发器相同。
graph_prototypes		模板图形原型元素的根元素，与主机图形相同。
host_prototypes		模板主机原型元素的根元素，与主机相同。
master_item	字符串	(DEPENDENT规则必需) 依赖规则的主项的根元素。
lld_macro_paths		低级别自动发现规则宏路径的根元素。
lld_macro		(必需) 低级别自动发现规则宏名称。
path	字符串	(必需) 分配给相应宏的值的选择器。
preprocessing		低级别自动发现规则值预处理的根元素。
step		低级别自动发现规则值预处理步骤元素的根元素，与模板项值预处理步骤相同，但可用值较少。参见: LLD规则预处理对象。
overrides		低级别自动发现规则覆盖规则的根元素。
name	字符串	(必需) 唯一的覆盖名称。
step	字符串	(必需) 覆盖的唯一顺序号。
stop	字符串	如果匹配，则停止处理下一个覆盖。
filter		模板低级别自动发现规则覆盖规则过滤器元素的根元素，与模板低级别自动发现规则过滤器相同。
operations		模板低级别自动发现规则覆盖操作的根元素。

另请参阅: LLD规则对象（参考相关的具有匹配名称的属性）。

模板低级别自动发现规则过滤器

元素		类型	描述
evaltype		字符串	覆盖过滤条件评估方法。可能的取值:¹ AND_OR (默认值为0), AND (1), OR (2), FORMULA (3)。
formula		字符串	过滤条件的自定义计算公式。
conditions			过滤条件的根元素。
	macro	字符串	(必需) 执行检查的低级别自动发现宏的名称。
	value	字符串	与之比较的值。
	operator	字符串	条件运算符。可能的取值:¹ MATCHES_REGEX (8, 默认), NOT_MATCHES_REGEX (9)。
	formulaid	字符串	(必需) 用于从自定义表达式引用条件的任意唯一ID。只能包含大写字母。用户在修改过滤条件时必须定义ID，但在请求后会生成新的ID。

另请参阅: LLD规则过滤器对象（参考相关的具有匹配名称的属性）。

模板低级别自动发现规则覆盖操作

元素		类型	描述
operationobject		字符串	应用操作的对象。可能的取值:¹ ITEM_PROTOTYPE(0),TRIGGER_PROTOTYPE(1),GRAPH_PROTOTYPE(2),HOST_PROTOTYPE(3)。
operator		字符串	覆盖条件的运算符。可能的取值:¹ EQUAL(1),NOT_EQUAL(2),LIKE(3),NOT_LIKE(4),REGEXP(5),NOT_REGEXP(6)。
value		字符串	用于覆盖条件运算符的正则表达式或字符串。
status		字符串	覆盖操作后对象的状态。
discover		字符串	对象是否作为发现的结果添加。
delay		字符串	覆盖操作后为监控项原型设置的更新间隔。
history		字符串	覆盖操作后为监控项原型设置的历史记录存储期限。
trends		字符串	覆盖操作后为监控项原型设置的趋势存储期限。
severity		字符串	覆盖操作后设置的触发器原型严重性。
tags			覆盖操作后为对象设置标签的根元素。
	tag	字符串	（必需）标签名称。
	value	字符串	标签值。
templates			覆盖操作后与主机原型关联的模板的根元素。
	name	字符串	（必需）模板名称。
inventory_mode		字符串	覆盖操作后设置的主机原型资产模式。

另请参阅:LLD规则覆盖操作对象（参考相关的具有匹配名称的属性）。

模板网页场景

元素		类型	描述
uuid		字符串	（必需）此网页场景的唯一标识符。
name		字符串	（必需）网页场景名称。
delay		字符串	执行网页场景的频率，使用秒数、时间后缀或用户宏。默认值:1m。
attempts		整数	执行网页场景步骤的尝试次数。可能的取值:¹ 1-10（默认值:1）。
agent		字符串	客户端代理。Zabbix将模拟所选的浏览器。当网站针对不同浏览器返回不同内容时，这很有用。默认值:Zabbix。
http_proxy		字符串	执行网页场景时使用的代理，格式如:`http://[username[:password]@]proxy.example.com[:port]`。
variables			网页场景步骤中可能使用的变量的根元素。
	name	字符串	（必需）变量名称。
	value	文本	（必需）变量值。
headers			执行请求时发送的HTTP头的根元素。头部应使用与HTTP协议中出现的相同语法。
	name	字符串	（必需）头部名称。
	value	文本	（必需）头部值。
status		字符串	网页场景的状态。可能的取值:¹ ENABLED(0,默认),DISABLED(1)。
authentication		字符串	认证方法。可能的取值:¹ NONE(0,默认),BASIC(1),NTLM(2)。
http_user		字符串	用于BASIC（HTTP）或NTLM认证的用户名。
http_password		字符串	用于BASIC（HTTP）或NTLM认证的密码。
verify_peer		字符串	验证Web服务器的SSL证书。可能的取值:¹ NO(0,默认),YES(1)。
verify_host		字符串	验证Web服务器证书的CommonName字段或SubjectAlternateName字段是否匹配。可能的取值:¹ NO(0,默认),YES(1)。
ssl_cert_file		字符串	用于客户端认证的SSL证书文件名（必须为PEM格式）。
ssl_key_file		字符串	用于客户端认证的SSL私钥文件名（必须为PEM格式）。
ssl_key_password		字符串	SSL私钥文件密码。
steps			模板网页场景步骤的根元素（必需）。
tags			网页场景标签的根元素。
	tag	字符串	（必需）标签名称。
	value	字符串	标签值。

另请参阅:网页场景对象（参考相关的具有匹配名称的属性）。

模板网页场景步骤

元素		类型	描述
name		字符串	（必需）网页场景步骤名称。
url		字符串	（必需）监控的URL。
query_fields			查询参数的根元素（执行请求时添加到URL的HTTP字段数组）。
	name	字符串	（必需）查询参数名称。
	value	字符串	查询参数值。
posts			HTTPPOST变量的根元素（原始POST数据字符串或HTTP字段（表单字段数据）数组）。
	name	字符串	（必需）POST字段名称。
	value	字符串	（必需）POST字段值。
variables			此步骤后应用的步骤级别变量（宏）的根元素。如果变量值以'regex:'前缀开头，则根据后面跟随的正则表达式模式从此步骤返回的数据中提取其值。
	name	字符串	（必需）变量名称。
	value	文本	（必需）变量值。
headers			执行请求时发送的HTTP头的根元素。
	name	字符串	（必需）头部名称。
	value	文本	（必需）头部值。
follow_redirects		字符串	跟随HTTP重定向。可能的取值:¹ NO(0),YES(1,默认)。
retrieve_mode		字符串	HTTP响应检索模式。可能的取值:¹ BODY(0,默认),HEADERS(1),BOTH(2)。
timeout		字符串	步骤执行的超时时间（使用秒数、时间后缀或用户宏）。默认值:15s。
required		字符串	响应中必须存在的文本（如果为空则忽略）。
status_codes		字符串	接受的HTTP状态码的逗号分隔列表（例如，`200-201,210-299`；如果为空则忽略）。

另请参阅:网页场景步骤对象（参考相关的具有匹配名称的属性）。

Template macro configuration

zabbix_export:
         (...)
         templates:
           - uuid: f8f7908280354f2abeed07dc788c3747
             (...)
             macros:
               - macro: '{$AGENT.TIMEOUT}'
                 (...)
                 config:
                   type: TEXT
                   priority: '1'
                   label: 'Seconds since the last Zabbix agent seen'
                   description: 'Timeout after which agent is considered unavailable.'
               - macro: '{$CPU.UTIL.CRIT}'
                 (...)
                 config:
                   type: TEXT
                   priority: '2'
                   section_name: Thresholds
                   label: 'Threshold of CPU utilization expressed'
                   description: 'Critical threshold of CPU utilization expressed in %. In the range from 0 to 100 inclusive.'
                   regex: '^-?([0-9]+|(([0-9]+)\.([0-9]+)))$'
               (...)
               - macro: '{$IFCONTROL}'
                 (...)
                 config:
                   type: CHECKBOX
                   priority: '19'
                   label: 'Interfaces control'
                   description: 'Fire a trigger when the interface operational status changes to "Link down".'
                   options:
                     - checked: '1'
                       unchecked: '0'
               (...)

Element		Type	Description
type		string	(required) Type of macro input field. Possible values:¹ NOCONF (0), TEXT (1), LIST (2), CHECKBOX (3).
priority		string	Macro position in the macro list.
section_name		string	Label of the collapsible section where the macro is grouped.
label		string	(required for TEXT, LIST, CHECKBOX macros) Macro label.
description		text	Macro help text. Supports Markdown formatting.
required		string	Marks the macro as mandatory. Possible values:¹ NO (0), YES (1). Supported for TEXT and LIST macros.
regex		string	Regular expression to validate user input in a textbox field. Supported for TEXT macros.
options			Root element for LIST items or CHECKBOX values.
	value	string	(required for LIST macros) LIST item value.
	text	string	(required for LIST macros) LIST item text.
	checked	string	(required for CHECKBOX macros) Value representing a checked state. Possible values:¹ 0 (false), 1 (true). Supported for CHECKBOX macros.
	unchecked	string	(required for CHECKBOX macros) Value representing an unchecked state. Possible values:¹ 0 (false), 1 (true). Supported for CHECKBOX macros.

See also: Macro configuration object (refer to the relevant property with a matching name).

模板仪表盘

元素		类型	描述
uuid		字符串	（必需）此仪表盘的唯一标识符。
name		字符串	（必需）模板仪表盘名称。
displayperiod		整数	仪表盘页面的显示周期。
auto_start		字符串	幻灯片自动开始。可能的取值:¹ NO(0),YES(1,默认)。
pages			模板仪表盘页面的根元素。
	name	字符串	页面名称。
	displayperiod	整数	页面的显示周期。
	sortorder	整数	页面的排序顺序。
widgets			模板仪表盘组件的根元素。

另请参阅:模板仪表盘对象（参考相关的具有匹配名称的属性）。

模板仪表盘组件

元素	类型	描述
type	字符串	（必需）组件类型。
name	字符串	组件名称。
x	整数	从模板仪表板左侧开始的水平位置。可能的取值:¹ 0-71。
y	整数	从模板仪表板顶部开始的垂直位置。可能的取值:¹ 0-63。
width	整数	组件宽度。可能的取值:¹ 1-72。
height	整数	组件高度。可能的取值:¹ 1-64。
hide_header	字符串	隐藏组件标题。可能的取值:¹ NO(0,默认),YES(1)。
fields		模板仪表板组件字段的根元素。
	type	字符串	（必需）组件字段类型。可能的取值:¹ INTEGER(0),STRING(1),ITEM(4),ITEM_PROTOTYPE(5),GRAPH(6),GRAPH_PROTOTYPE(7),MAP(8),SERVICE(9),SLA(10),USER(11),ACTION(12),MEDIA_TYPE(13)。
	name	字符串	（必需）组件字段名称。
	value	mixed	（必需）组件字段值，根据字段类型不同而异。

另请参阅:模板仪表盘组件对象（参考相关的具有匹配名称的属性）。

模板值映射

元素		类型	描述
uuid		字符串	（必需）此值映射的唯一标识符。
name		字符串	（必需）值映射的名称。
mapping			映射的根元素。
	type	字符串	映射匹配类型。可能的取值:¹ EQUAL(0,默认), GREATER_OR_EQUAL(2), LESS_OR_EQUAL(3),IN_RANGE(4),REGEXP(5),DEFAULT(6)。
	value	字符串	原始值。
	newvalue	字符串	（必需）原始值映射到的新值。

另请参阅:值映射对象（参考相关的具有匹配名称的属性）。

附注

¹ API中的整数值用方括号标注，例如，ENABLED (0)，仅供参考。有关更多信息，请查看表格条目中的链接API对象页面或每个部分末尾的相关页面。

Documentation