[comment]: # ({adaceae4-e8fbaf7c})
# 3 模板

[comment]: # ({/adaceae4-e8fbaf7c})

[comment]: # ({8456e9da-02fec82c})
#### 概述

模板是[exported](/manual/xml_export_import)，包含许多相关的objects和object关系。

模板export包含：

-   已链接的模板组
-   已链接的主机组（如果在[host prototype](/manual/discovery/low_level_discovery/host_prototypes)配置中使用）
-   模板数据
-   与其他模板的链接
-   与模板组的链接
-   直接链接的监控项
-   直接链接的触发器
-   直接链接的图形
-   直接链接的仪表板
-   直接链接的发现规则及其所有原型
-   直接链接的Web场景
-   值映射

[comment]: # ({/8456e9da-02fec82c})

[comment]: # ({9a909adc-ca3e35f8})
#### 导出

要export模板，请执行以下操作：

1.  转到 *数据采集* → *模板*。
2.  选中要导出的模板的复选框。
3.  单击列表下方的 *导出*。

![](../../../assets/en/manual/xml_export_import/export_templates.png)

根据所选格式，模板将导出到本地file，默认名称如下：

-   `zabbix_export_templates.yaml` - 以YAMLexport格式导出（导出的默认选项）；
-   `zabbix_export_templates.xml` - 以XML格式导出；
-   `zabbix_export_templates.json` - 以JSON格式导出。

[comment]: # ({/9a909adc-ca3e35f8})

[comment]: # ({4c282ebe-78f6f939})
#### 导入

要import模板，请执行以下操作：

1. 转至 *数据采集* → *模板*。
2. 点击Top右上角的 *导入*。
3. 选择import文件。
4. 点击配置表单右下角的 *导入*。

![](../../../assets/en/manual/xml_export_import/import_templates.png){width="600"}

如果您勾选 *高级选项* 复选框，将显示所有可导入元素的详细列表 - 根据需要勾选或取消勾选每个import规则。

如果您勾选 *全部* 行中的复选框，其下方的所有元素将被勾选/取消勾选。

导入规则：

| 规则 | 描述 |
|----|-----------|
| *更新现有* | 将使用来自import文件的数据更新现有元素。否则，它们将不会被更新。 |
| *创建新项* | 将使用来自import文件的数据创建新元素。否则，它们将不会被创建。 |
| *删除缺失* | 不在import file中的现有元素将被移除。否则，它们将不会被移除。<br>如果为 *模板链接* 勾选 *删除缺失*，当前不在import file中的模板链接将被解除链接。从解除链接的模板继承的实体（监控项、触发器、图形等）不会被移除（除非也为每个实体选择了 *删除缺失* 选项）。 |

在下一个屏幕上，您可以查看正在导入的模板内容。
如果这是一个新模板，所有元素将以绿色列出。
如果更新现有模板，新增的模板元素将以绿色高亮显示；被移除的模板元素将以红色高亮显示；未更改的元素将以灰色背景列出。

![](../../../assets/en/manual/xml_export_import/import_templates_details.png){width="600"}

左侧的菜单可用于浏览更改列表。
*已更新* 部分高亮显示对现有模板元素所做的所有更改。
*已添加* 部分列出新的模板元素。
每个部分中的元素按元素类型分组；点击灰色箭头以展开或折叠元素组。

![](../../../assets/en/manual/xml_export_import/import_templates_menu.png)

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

[comment]: # ({/4c282ebe-78f6f939})

[comment]: # ({a7446e09-c04b1514})
#### 导出格式

YAML格式导出配置：


```yaml
zabbix_export:
  version: '7.0'
  template_groups:
    - uuid: a571c0d144b14fd4a87a9d9b2aa9fcd6
      name: Templates/Applications
  host_groups:
    - uuid: a571c0d144b14fd4a87a9d9b2aa9fcd6
      name: Applications
  templates:
    - uuid: 56079badd056419383cc26e6a4fcc7e0
      template: VMware
      name: VMware
      description: |
        You can discuss this template or leave feedback on our forum https://www.zabbix.com/forum/zabbix-suggestions-and-feedback/

        Template tooling version used: 0.41
      groups:
        - name: Templates/Applications
      items:
        - uuid: 5ce209f4d94f460488a74a92a52d92b1
          name: 'VMware: Event log'
          type: SIMPLE
          key: 'vmware.eventlog[{$VMWARE.URL},skip]'
          history: 7d
          trends: '0'
          value_type: LOG
          username: '{$VMWARE.USERNAME}'
          password: '{$VMWARE.PASSWORD}'
          description: 'Collect VMware event log.'
          tags:
            - tag: component
              value: log
        - uuid: ee2edadb8ce943ef81d25dbbba8667a4
          name: 'VMware: Full name'
          type: SIMPLE
          key: 'vmware.fullname[{$VMWARE.URL}]'
          delay: 1h
          history: 7d
          trends: '0'
          value_type: CHAR
          username: '{$VMWARE.USERNAME}'
          password: '{$VMWARE.PASSWORD}'
          description: 'VMware service full name.'
          preprocessing:
            - type: DISCARD_UNCHANGED_HEARTBEAT
              parameters:
                - 1d
          tags:
            - tag: component
              value: system
        - uuid: a0ec9145f2234fbea79a28c57ebdb44d
          name: 'VMware: Version'
          type: SIMPLE
          key: 'vmware.version[{$VMWARE.URL}]'
          delay: 1h
          history: 7d
          trends: '0'
          value_type: CHAR
          username: '{$VMWARE.USERNAME}'
          password: '{$VMWARE.PASSWORD}'
          description: 'VMware service version.'
          preprocessing:
            - type: DISCARD_UNCHANGED_HEARTBEAT
              parameters:
                - 1d
          tags:
            - tag: component
              value: system
      discovery_rules:
        - uuid: 16ffc933cce74cf28a6edf306aa99782
          name: 'Discover VMware clusters'
          type: SIMPLE
          key: 'vmware.cluster.discovery[{$VMWARE.URL}]'
          delay: 1h
          username: '{$VMWARE.USERNAME}'
          password: '{$VMWARE.PASSWORD}'
          description: 'Discovery of clusters'
          item_prototypes:
            - uuid: 46111f91dd564a459dbc1d396e2e6c76
              name: 'VMware: Status of "{#CLUSTER.NAME}" cluster'
              type: SIMPLE
              key: 'vmware.cluster.status[{$VMWARE.URL},{#CLUSTER.NAME}]'
              history: 7d
              username: '{$VMWARE.USERNAME}'
              password: '{$VMWARE.PASSWORD}'
              description: 'VMware cluster status.'
              valuemap:
                name: 'VMware status'
              tags:
                - tag: cluster
                  value: '{#CLUSTER.NAME}'
                - tag: component
                  value: cluster
        - uuid: 8fb6a45cbe074b0cb6df53758e2c6623
          name: 'Discover VMware datastores'
          type: SIMPLE
          key: 'vmware.datastore.discovery[{$VMWARE.URL}]'
          delay: 1h
          username: '{$VMWARE.USERNAME}'
          password: '{$VMWARE.PASSWORD}'
          item_prototypes:
            - uuid: 4b61838ba4c34e709b25081ae5b059b5
              name: 'VMware: Average read latency of the datastore {#DATASTORE}'
              type: SIMPLE
              key: 'vmware.datastore.read[{$VMWARE.URL},{#DATASTORE},latency]'
              history: 7d
              username: '{$VMWARE.USERNAME}'
              password: '{$VMWARE.PASSWORD}'
              description: 'Amount of time for a read operation from the datastore (milliseconds).'
              tags:
                - tag: component
                  value: datastore
                - tag: datastore
                  value: '{#DATASTORE}'
            - uuid: 5355c401dc244bc588ccd18767577c93
              name: 'VMware: Free space on datastore {#DATASTORE} (percentage)'
              type: SIMPLE
              key: 'vmware.datastore.size[{$VMWARE.URL},{#DATASTORE},pfree]'
              delay: 5m
              history: 7d
              value_type: FLOAT
              units: '%'
              username: '{$VMWARE.USERNAME}'
              password: '{$VMWARE.PASSWORD}'
              description: 'VMware datastore space in percentage from total.'
              tags:
                - tag: component
                  value: datastore
                - tag: datastore
                  value: '{#DATASTORE}'
            - uuid: 84f13c4fde2d4a17baaf0c8c1eb4f2c0
              name: 'VMware: Total size of datastore {#DATASTORE}'
              type: SIMPLE
              key: 'vmware.datastore.size[{$VMWARE.URL},{#DATASTORE}]'
              delay: 5m
              history: 7d
              units: B
              username: '{$VMWARE.USERNAME}'
              password: '{$VMWARE.PASSWORD}'
              description: 'VMware datastore space in bytes.'
              tags:
                - tag: component
                  value: datastore
                - tag: datastore
                  value: '{#DATASTORE}'
            - uuid: 540cd0fbc56c4b8ea19f2ff5839ce00d
              name: 'VMware: Average write latency of the datastore {#DATASTORE}'
              type: SIMPLE
              key: 'vmware.datastore.write[{$VMWARE.URL},{#DATASTORE},latency]'
              history: 7d
              username: '{$VMWARE.USERNAME}'
              password: '{$VMWARE.PASSWORD}'
              description: 'Amount of time for a write operation to the datastore (milliseconds).'
              tags:
                - tag: component
                  value: datastore
                - tag: datastore
                  value: '{#DATASTORE}'
        - uuid: a5bc075e89f248e7b411d8f960897a08
          name: 'Discover VMware hypervisors'
          type: SIMPLE
          key: 'vmware.hv.discovery[{$VMWARE.URL}]'
          delay: 1h
          username: '{$VMWARE.USERNAME}'
          password: '{$VMWARE.PASSWORD}'
          description: 'Discovery of hypervisors.'
          host_prototypes:
            - uuid: 051a1469d4d045cbbf818fcc843a352e
              host: '{#HV.UUID}'
              name: '{#HV.NAME}'
              group_links:
                - group:
                    name: Applications
              group_prototypes:
                - name: '{#CLUSTER.NAME}'
                - name: '{#DATACENTER.NAME}'
              templates:
                - name: 'VMware Hypervisor'
              macros:
                - macro: '{$VMWARE.HV.UUID}'
                  value: '{#HV.UUID}'
                  description: 'UUID of hypervisor.'
              custom_interfaces: 'YES'
              interfaces:
                - ip: '{#HV.IP}'
        - uuid: 9fd559f4e88c4677a1b874634dd686f5
          name: 'Discover VMware VMs'
          type: SIMPLE
          key: 'vmware.vm.discovery[{$VMWARE.URL}]'
          delay: 1h
          username: '{$VMWARE.USERNAME}'
          password: '{$VMWARE.PASSWORD}'
          description: 'Discovery of guest virtual machines.'
          host_prototypes:
            - uuid: 23b9ae9d6f33414880db1cb107115810
              host: '{#VM.UUID}'
              name: '{#VM.NAME}'
              group_links:
                - group:
                    name: Applications
              group_prototypes:
                - name: '{#CLUSTER.NAME} (vm)'
                - name: '{#DATACENTER.NAME}/{#VM.FOLDER} (vm)'
                - name: '{#HV.NAME}'
              templates:
                - name: 'VMware Guest'
              macros:
                - macro: '{$VMWARE.VM.UUID}'
                  value: '{#VM.UUID}'
                  description: 'UUID of guest virtual machine.'
              custom_interfaces: 'YES'
              interfaces:
                - ip: '{#VM.IP}'
      tags:
        - tag: class
          value: software
        - tag: target
          value: vmware
      macros:
        - macro: '{$VMWARE.PASSWORD}'
          description: 'VMware service {$USERNAME} user password'
        - macro: '{$VMWARE.URL}'
          description: 'VMware service (vCenter or ESX hypervisor) SDK URL (https://servername/sdk)'
        - macro: '{$VMWARE.USERNAME}'
          description: 'VMware service user name'
      valuemaps:
        - uuid: 3c59c22905054d42ac4ee8b72fe5f270
          name: 'VMware status'
          mappings:
            - value: '0'
              newvalue: gray
            - value: '1'
              newvalue: green
            - value: '2'
              newvalue: yellow
            - value: '3'
              newvalue: red
```

[comment]: # ({/a7446e09-c04b1514})

[comment]: # ({d8918da6-2c61d3f8})
## 导出的元素

导出的元素在下面的表格中进行说明。

| 元素 | <   | 类型 | 描述 |
|-----|-----|------|--------------------------|
| template_groups | <   |      | （必需）模板组的根元素。 |
| < | uuid | string | （必需）此模板组的唯一标识符。 |
| ^ | name | string | （必需）模板组名称。 |
| host_groups | <   |      | （必需）用于主机原型的主机组的根元素。 |
| < | uuid | string | （必需）此主机组的唯一标识符。 |
| ^ | name | string | （必需）主机组名称。 |
| templates | <   |      | [模板](#templates)的根元素。 |

[comment]: # ({/d8918da6-2c61d3f8})

[comment]: # ({a0f1ac47-bdfd38fc})
### 模板

|Element|<|Type|Description|
|-|---|---|-----------------------|
|uuid|<|string|(required) 此模板的唯一标识符。|
|template|<|string|(required) 唯一模板名称。|
|name|<|string|可见的模板名称。|
|description|<|text|模板描述。|
|vendor|<| |模板供应商的根元素（当导出的模板包含供应商数据时存在）。|
|<|name|string|(required) 模板供应商名称。|
|^|version|string|(required) 模板版本。<br>对于[开箱即用模板](/manual/config/templates_out_of_the_box)，版本显示如下：Zabbix 的主版本号、分隔符（"-"）、修订号（每发布一个新版本的模板时递增，并在每个 Zabbix 主版本中重置）。例如，6.4-0、6.4-3、7.0-0、7.0-3。|
|templates|<| |关联模板的根元素。|
| |name|string|(required) 模板名称。|
|groups|<| |模板组的根元素。|
| |name|string|(required) 模板组名称。|
|items|<| |[模板监控项](#template-items)的根元素。|
|discovery_rules|<| |[模板低级别发现规则](#template-low-level-discovery-rules)的根元素。|
|httptests|<| |[模板 Web 场景](#template-web-scenarios)的根元素。|
|tags|<| |模板标签的根元素。|
|<|tag|string|(required) 标签名称。|
|^|value|string|标签值。|
|macros|<| |模板用户宏的根元素。|
|<|macro|string|(required) 用户宏名称。|
|^|type|string|用户宏类型。<br>可能的值：^[1](#footnotes)^ TEXT (0, default), SECRET\_TEXT (1), VAULT (2)。<br>另请参见：[用户宏对象](/manual/api/reference/usermacro/object)（`type`）。|
|^|value|string|用户宏值。|
|^|description|string|用户宏描述。|
|dashboards|<| |[模板仪表板](#template-dashboards)的根元素。|
|valuemaps|<| |[模板值映射](#template-value-maps)的根元素。|

[comment]: # ({/a0f1ac47-bdfd38fc})

[comment]: # ({8700d81a-18631c1b})
#### 模板监控项

|Element|<|Type|Description|
|-|---|---|-----------------------|
|uuid|<|string|(required) 此监控项的唯一标识符。|
|name|<|string|(required) 监控项名称。|
|type|<|string|监控项类型。<br>Possible values:^[1](#footnotes)^ ZABBIX\_PASSIVE (0, default), 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|<|string|(required for SNMP\_AGENT items) SNMP 对象标识符。|
|key|<|string|(required) 监控项键值。|
|delay|<|string|监控项的更新间隔。<br>Default: 1m. 对于 TRAP 监控项，该值始终为 0。|
|history|<|string|历史数据的保存时长（使用 [time suffix](/manual/appendix/suffixes#time-suffixes)、[user macro](/manual/config/macros/user_macros) 或 [LLD macro](/manual/config/macros/lld_macros)）。<br>Default: 31d.|
|trends|<|string|趋势数据的保存时长（使用 [time suffix](/manual/appendix/suffixes#time-suffixes)、[user macro](/manual/config/macros/user_macros) 或 [LLD macro](/manual/config/macros/lld_macros)）。<br>Default: 365d.|
|status|<|string|监控项状态。<br>Possible values:^[1](#footnotes)^ ENABLED (0, default), DISABLED (1).|
|value\_type|<|string|接收值类型。<br>Possible values:^[1](#footnotes)^ FLOAT (0), CHAR (1), LOG (2), UNSIGNED (3, default), TEXT (4), BINARY (5).|
|allowed\_hosts|<|string|允许向该监控项发送数据的主机 IP 地址列表，以逗号分隔。<br>Supported for TRAP and HTTP\_AGENT items.|
|units|<|string|接收值单位（bps、B 等）。|
|params|<|text|根据监控项类型而定的附加参数（SSH 和 TELNET 监控项为执行的脚本；ODBC 监控项为 SQL 查询；CALCULATED 监控项为公式；ITEM\_TYPE\_SCRIPT 和 ITEM\_TYPE\_BROWSER 监控项为脚本）。|
|ipmi\_sensor|<|string|IPMI 传感器。<br>Supported for IPMI items.|
|authtype|<|string|认证类型。<br>Supported for SSH and HTTP\_AGENT items.<br>Possible values for SSH items:^[1](#footnotes)^ PASSWORD (0, default), PUBLIC\_KEY (1).<br>Possible values for HTTP\_AGENT items:^[1](#footnotes)^ NONE (0, default), BASIC (1), NTLM (2), Kerberos (3), or Digest (4).|
|username|<|string|(required for SSH and TELNET items) 认证用户名。<br>Supported for SIMPLE, ODBC, JMX and HTTP\_AGENT items.<br>When used for JMX items, `password` (see below) should also be specified or both elements should be left blank.|
|password|<|string|(required for SSH and TELNET items) 认证密码。<br>Supported for SIMPLE, ODBC, JMX and HTTP\_AGENT items.<br>When used for JMX items, `username` (see above) should also be specified or both elements should be left blank.|
|publickey|<|string|(required for SSH items) 公钥文件名。|
|privatekey|<|string|(required for SSH items) 私钥文件名。|
|description|<|text|监控项描述。|
|inventory\_link|<|string|由该监控项填充的主机清单字段。<br>Possible values:^[1](#footnotes)^ NONE (0), ALIAS (4), etc. (see [Host inventory](/manual/api/reference/host/object#host-inventory) for supported fields).|
|valuemap|<| |监控项值映射的根元素。|
| |name|string|(required) 用于该监控项的值映射名称。|
|logtimefmt|<|string|日志条目中的时间格式。<br>Supported for items of LOG value type.|
|preprocessing|<| |监控项值预处理的根元素。|
| |step| |[模板监控项值预处理步骤](#template-item-value-preprocessing-steps) 的根元素。|
|jmx\_endpoint|<|string|JMX 端点。<br>Supported for JMX items.|
|master_item|<| |(required for DEPENDENT items) 依赖监控项主监控项的根元素。|
| |key|string|(required) 依赖监控项的主监控项键值。|
|timeout|<|string|监控项数据轮询请求超时时间。<br>Supported for [Timeouts](/manual/web_interface/frontend_sections/administration/general#timeouts) list of item types.|
|url|<|string|(required for HTTP\_AGENT items) URL 字符串。|
|query_fields|<| |查询参数的根元素。<br>Supported for HTTP\_AGENT items.|
|<|name|string|(required for HTTP\_AGENT items) 查询参数名称。|
|^|value|string|查询参数值。<br>Supported for HTTP\_AGENT items.|
|parameters|<| |用户自定义参数的根元素。<br>Supported for ITEM\_TYPE\_SCRIPT and ITEM\_TYPE\_BROWSER items.|
|<|name|string|(required for ITEM\_TYPE\_SCRIPT and ITEM\_TYPE\_BROWSER items) 用户自定义参数名称。|
|^|value|string|用户自定义参数值。<br>Supported for ITEM\_TYPE\_SCRIPT and ITEM\_TYPE\_BROWSER items.|
|posts|<|string|HTTP(S) 请求正文数据。<br>Supported for HTTP\_AGENT items.|
|status\_codes|<|string|所需 HTTP 状态码范围，以逗号分隔。<br>Supported for HTTP\_AGENT items.|
|follow\_redirects|<|string|轮询数据时跟随响应重定向。<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).|
|post\_type|<|string|POST 数据正文类型。<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ RAW (0, default), JSON (2), XML (3).|
|http\_proxy|<|string|HTTP(S) proxy 连接字符串。<br>Supported for HTTP\_AGENT items.|
|headers|<| |HTTP(S) 请求头的根元素。<br>Supported for HTTP\_AGENT items.|
|<|name|string|(required for HTTP\_AGENT items) 请求头名称。|
|^|value|string|(required for HTTP\_AGENT items) 请求头值。|
|retrieve\_mode|<|string|应保存响应的哪一部分。<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ BODY (0, default), HEADERS (1), BOTH (2).|
|request\_method|<|string|请求方法类型。<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ GET (0, default), POST (1), PUT (2), HEAD (3).|
|output\_format|<|string|如何处理响应。<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ RAW (0, default), JSON (1).|
|allow\_traps|<|string|允许像 trapper 监控项一样填充值。<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).|
|ssl\_cert\_file|<|string|公用 SSL 密钥文件路径。<br>Supported for HTTP\_AGENT items.|
|ssl\_key\_file|<|string|私有 SSL 密钥文件路径。<br>Supported for HTTP\_AGENT items.|
|ssl\_key\_password|<|string|SSL 密钥文件密码。<br>Supported for HTTP\_AGENT items.|
|verify\_peer|<|string|是否验证主机证书是否可信。<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).|
|verify\_host|<|string|是否验证连接所用主机名与主机证书中的名称一致。<br>Supported for HTTP\_AGENT items.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).|
|tags|<| |监控项标签的根元素。|
|<|tag|string|(required) 标签名称。|
|^|value|string|标签值。|
|triggers|<|<|[模板监控项触发器](#template-item-triggers) 的根元素。|

::: noteclassic
另请参见：[监控项对象](/manual/api/reference/item/object)（请参考名称匹配的相关属性）。
:::

[comment]: # ({/8700d81a-18631c1b})

[comment]: # ({b0814e0a-497cb193})
##### 模板 监控项 值预处理步骤

| 元素 | <   | 类型 | 描述 |
|-|---|---|-----------------------|
| type | <   | string | （必填）监控项值预处理步骤的类型。<br>可能的值：^[1](#footnotes)^ 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 | <   |      | （必填）监控项值预处理步骤参数的根元素。 |
|         | 参数 | string | 监控项值预处理步骤的单个参数。 |
| error\_handler | <   | string | 预处理步骤失败时使用的动作类型。<br>可能的值：^[1](#footnotes)^ ORIGINAL\_ERROR（0，默认）、DISCARD\_VALUE（1）、CUSTOM\_VALUE（2）、CUSTOM\_ERROR（3）。 |
| error\_handler\_params | <   | string | 错误处理程序参数。 |
::: noteclassic
另请参见：[预处理](/manual/api/reference/item/object#预处理)（请参考名称匹配的相关属性）。
:::

[comment]: # ({/b0814e0a-497cb193})

[comment]: # ({fbceca7a-8aada697})
##### 模板 监控项 触发器

| 元素 | <   | 类型 | 描述 |
|-|---|---|-----------------------|
| uuid | <   | string | （必填）此触发器的唯一标识符。 |
| expression | <   | string | （必填）触发器表达式。 |
| recovery\_mode | <   | string | 生成OK事件的基础。<br>可能的值：^[1](#footnotes)^ EXPRESSION（0，默认），RECOVERY\_EXPRESSION（1），NONE（2）。 |
| recovery\_expression | <   | string | 触发器恢复表达式。 |
| correlation\_mode | <   | string | 关联模式（无事件关联或按标签进行事件关联）。<br>可能的值：^[1](#footnotes)^ DISABLED（0，默认），TAG\_VALUE（1）。 |
| correlation\_tag | <   | string | 用于事件关联的标签名称。 |
| name | <   | string | （必填）触发器名称。 |
| event\_name | <   | string | 事件名称。 |
| opdata | <   | string | 操作数据。 |
| url\_name | <   | string | 与触发器关联的URL标签。 |
| url | <   | string | 与触发器关联的URL。 |
| status | <   | string | 触发器状态。<br>可能的值：^[1](#footnotes)^ ENABLED（0，默认），DISABLED（1）。 |
| priority | <   | string | 触发器严重性。<br>可能的值：^[1](#footnotes)^ NOT\_CLASSIFIED（0，默认），INFO（1），WARNING（2），AVERAGE（3），HIGH（4），DISASTER（5）。 |
| description | <   | text | 触发器描述。 |
| type | <   | string | 事件生成类型（单个问题事件或多个问题事件）。<br>可能的值：^[1](#footnotes)^ SINGLE（0，默认），MULTIPLE（1）。 |
| manual\_close | <   | string | 手动关闭问题事件。<br>可能的值：^[1](#footnotes)^ NO（0，默认），YES（1）。 |
| dependencies | <   |      | 依赖关系的根元素。 |
| < | name | string | （必填）依赖触发器名称。 |
| ^ | expression | string | （必填）依赖触发器表达式。 |
| ^ | recovery\_expression | string | 依赖触发器恢复表达式。 |
| tags | <   |      | 触发器标签的根元素。 |
| < | tag | string | （必填）标签名称。 |
| ^ | value | string | 标签值。 |
::: noteclassic
另请参见：[Trigger object](/manual/api/reference/trigger/object)（参考具有匹配名称的相关属性）。
:::

[comment]: # ({/fbceca7a-8aada697})

[comment]: # ({13cb0aa5-2fdd304e})
#### 模板低级别自动发现规则

::: noteimportant
大多数模板低级别自动发现规则元素与[模板 监控项](#template-监控项)中的相同。  
下表描述了与模板 监控项 不同的元素。  
:::

| 元素 | <   | 类型 | 描述 |
|-|---|---|-----------------------|
| type | <   | string | 监控项 类型。<br>可能值：^[1](#footnotes)^ 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），监控项\_TYPE\_SCRIPT（21），监控项\_TYPE\_BROWSER（22）。 |
| key | <   | string | （必填）低级别自动发现规则的键值。 |
| filter | <   |      | [模板低级别自动发现规则过滤器](#template-low-level-discovery-rule-filters)的根元素。 |
| lifetime | <   | string | 一段时间（以秒、[时间后缀](/manual/appendix/suffixes#时间后缀) 或 [user macro](/manual/config/macros/user_macros) 为单位），之后不再发现的资源将被删除。<br>默认值：7d。 |
| lifetime_type | <   | string | 删除丢失的LLD资源的场景。<br>可能值：DELETE\_NEVER、DELETE\_IMMEDIATELY、DELETE\_AFTER。 |
| enabled_lifetime | <   | string | 一段时间（以秒、[时间后缀](/manual/appendix/suffixes#时间后缀) 或 [user macro](/manual/config/macros/user_macros) 为单位），之后不再发现的资源将被禁用。 |
| enabled_lifetime_type | <   | string | 禁用丢失的LLD资源的场景。<br>可能值：DISABLE\_NEVER、DISABLE\_IMMEDIATELY、DISABLE\_AFTER。 |
| item\_prototypes | <   |      | 模板 监控项 原型元素的根元素，与[模板 监控项](#template-监控项)中的相同。 |
| trigger\_prototypes | <   |      | 模板触发器原型元素的根元素，与[模板 监控项 触发器](#template-监控项-triggers)中的相同。 |
| graph\_prototypes | <   |      | 模板图表原型元素的根元素，与[主机图形](/manual/xml_export_import/hosts#主机图形)中的相同。 |
| host\_prototypes | <   |      | 模板 主机 原型元素的根元素，与[主机](/manual/xml_export_import/hosts#主机)中的相同。 |
| master_item | <   | string | （对于DEPENDENT规则是必填）依赖规则主监控项的根元素。 |
| lld\_macro\_paths | <   |      | 低级别自动发现规则宏路径的根元素。 |
| < | lld\_macro | string | （必填）低级别自动发现规则宏名称。 |
| ^ | path | string | （必填）值的选择器，将分配给相应的宏。 |
| preprocessing | <   |      | 低级别自动发现规则值预处理的根元素。 |
|         | step |      | 低级别自动发现规则值预处理步骤元素的根元素，与[模板 监控项 值预处理步骤](#template-监控项-preprocessing-steps)中的相同，但可能值较少。另请参阅：[lld-规则预处理](/manual/api/reference/discoveryrule/object#lld-规则预处理)。 |
| overrides | <   |      | 低级别自动发现规则覆盖规则的根元素。 |
| < | name | string | （必填）唯一的覆盖名称。 |
| ^ | step | string | （必填）覆盖的唯一顺序号。 |
| ^ | stop | string | 如果匹配，则停止处理后续覆盖。 |
| ^ | filter |      | 模板低级别自动发现规则覆盖规则过滤器元素的根元素，与[模板低级别自动发现规则过滤器](#template-low-level-discovery-rule-filters)中的相同。 |
| ^ | operations |      | [模板低级别自动发现规则覆盖操作](#template-low-level-discovery-rule-override-operations)的根元素。 |
::: noteclassic
另请参阅：[LLD rule object](/manual/api/reference/discoveryrule/object)（参考具有匹配名称的相关属性）。  
:::

[comment]: # ({/13cb0aa5-2fdd304e})

[comment]: # ({198effa4-1147e24b})
##### Template low-level discovery rule filters  
模板低级别自动发现规则过滤器

| 元素 | <   | 类型 | 说明 |
|-----|-----|-----|-------------------------|
| evaltype | <   | string | 覆盖过滤条件评估方法。<br>可能的值：^[1](#footnotes)^ AND\_OR（0，默认），AND（1），OR（2），FORMULA（3）。 |
| formula | <   | string | 过滤条件的自定义计算公式。 |
| conditions | <   |      | 过滤条件的根元素。 |
| < | 宏 | string | （必填）要执行检查的低级别发现宏的名称。 |
| ^ | 值 | string | 要比较的值。 |
| ^ | 操作符 | string | 条件操作符。<br>可能的值：^[1](#footnotes)^ MATCHES\_REGEX（8，默认），NOT\_MATCHES\_REGEX（9）。 |
| ^ | 公式ID | string | （必填）用于从自定义表达式中引用条件的任意唯一ID。只能包含大写字母。在修改过滤条件时，该ID必须由用户定义，但在之后请求条件时将重新生成。 |
::: noteclassic
另请参阅：[lld-规则过滤器](/manual/api/reference/discoveryrule/object#lld-规则过滤器)（请参考名称匹配的相关属性）。
:::

[comment]: # ({/198effa4-1147e24b})

[comment]: # ({7eed19ff-18c53e3c})
##### 模板低级别自动发现规则覆盖操作

| 元素 | <   | 类型 | 描述 |
|---|---|---|-----------------------|
| operationobject | <   | string | 应用操作的object。<br>可能的值：^[1](#footnotes)^ ITEM_PROTOTYPE（0），TRIGGER_PROTOTYPE（1），GRAPH_PROTOTYPE（2），HOST_PROTOTYPE（3）。 |
| operator | <   | string | 覆盖条件运算符。<br>可能的值：^[1](#footnotes)^ EQUAL（1），NOT_EQUAL（2），LIKE（3），NOT_LIKE（4），REGEXP（5），NOT_REGEXP（6）。 |
| value | <   | string | 覆盖条件运算符的正则表达式或string。 |
| status | <   | string | 覆盖操作期间object的状态。 |
| discover | <   | string | 是否由于发现规则而添加了object。 |
| delay | <   | string | 覆盖操作期间为监控项原型设置的更新间隔。 |
| history | <   | string | 覆盖操作期间为监控项原型设置的历史存储周期。 |
| trends | <   | string | 覆盖操作期间为监控项原型设置的趋势存储周期。 |
| severity | <   | string | 覆盖操作期间为触发器原型设置的严重性。 |
| tags | <   |      | 覆盖操作期间为object设置的标签的根元素。 |
| < | tag | string | （必填）标签名称。 |
| ^ | value | string | 标签值。 |
| templates | <   |      | 覆盖操作期间链接到主机原型的模板的根元素。 |
|         | name | string | （必填）模板名称。 |
| inventory_mode | <   | string | 覆盖操作期间为主机原型设置的资产清单模式。 |
::: noteclassic
另请参阅：[lld-规则覆盖操作](/manual/api/reference/discoveryrule/object#lld-规则覆盖操作)（请参考具有匹配名称的相关属性）。
:::

[comment]: # ({/7eed19ff-18c53e3c})

[comment]: # ({ad2d6df7-fd8f09c1})
#### 模板 web 场景

|Element|<|Type|Description|
|-|---|---|-----------------------|
|uuid|<|string|(required) 此 web 场景的唯一标识符。|
|name|<|string|(required) web 场景名称。|
|delay|<|string|执行 web 场景的频率（使用秒、[时间后缀](/manual/appendix/suffixes#time-suffixes)或[用户宏](/manual/config/macros/user_macros)）。<br>默认值：1m。|
|attempts|<|integer|执行 web 场景步骤的尝试次数。<br>可选值：^[1](#footnotes)^ 1-10（默认值：1）。|
|agent|<|string|客户端 agent。Zabbix 将伪装成所选浏览器。<br>当网站针对不同浏览器返回不同内容时，这很有用。<br>默认值：Zabbix。|
|http\_proxy|<|string|web 场景使用的 proxy，格式为：`http://[username[:password]@]proxy.example.com[:port]`|
|variables|<| |web 场景变量的根元素，这些变量可在场景步骤中使用。|
|<|name|string|(required) 变量名称。|
|^|value|text|(required) 变量值。|
|headers|<| |发送请求时要使用的 HTTP 标头根元素。<br>标头应使用与 HTTP 协议中相同的语法列出。|
|<|name|string|(required) 标头名称。|
|^|value|text|(required) 标头值。|
|status|<|string|web 场景状态。<br>可选值：^[1](#footnotes)^ ENABLED (0, default), DISABLED (1).|
|authentication|<|string|认证方式。<br>可选值：^[1](#footnotes)^ NONE (0, default), BASIC (1), NTLM (2), Kerberos (3), or Digest (4).|
|http\_user|<|string|用于 BASIC (HTTP)、NTLM、Kerberos 或 Digest 认证的用户名。|
|http\_password|<|string|用于 BASIC (HTTP)、NTLM、Kerberos 或 Digest 认证的密码。|
|verify\_peer|<|string|验证 web 服务器的 SSL 证书。<br>可选值：^[1](#footnotes)^ NO (0, default), YES (1).|
|verify\_host|<|string|验证 web 服务器证书的 *Common Name* 字段或 *Subject Alternate Name* 字段是否匹配。<br>可选值：^[1](#footnotes)^ NO (0, default), YES (1).|
|ssl\_cert\_file|<|string|用于客户端认证的 SSL 证书文件名（必须为 PEM 格式）。|
|ssl\_key\_file|<|string|用于客户端认证的 SSL 私钥文件名（必须为 PEM 格式）。|
|ssl\_key\_password|<|string|SSL 私钥文件密码。|
|steps|<| |[模板 web 场景步骤](#template-web-scenario-steps)的根元素。（必填）|
|tags|<| |web 场景标签的根元素。|
|<|tag|string|(required) 标签名称。|
|^|value|string|标签值。|

::: noteclassic
另请参见：[Web 场景对象](/manual/api/reference/httptest/object)（请参阅名称相匹配的相关属性）。
:::

[comment]: # ({/ad2d6df7-fd8f09c1})

[comment]: # ({5f667fc1-0dcf2b63})
##### Web场景步骤模板

| 元素 | <   | 类型 | 描述 |
|-|---|---|-----------------------|
| name | <   | string | (必填) Web场景步骤名称。 |
| url | <   | string | (必填) 监控URL地址。 |
| query\_fields | <   |      | query参数的根元素（执行请求时添加到URL中的HTTP字段array）。 |
| < | name | string | (必填) query参数名称。 |
| ^ | value | string | query参数值。 |
| posts | <   |      | HTTP POST变量的根元素（string原始POST数据或HTTP字段array表单字段数据）。 |
| < | name | string | (必填) POST字段名称。 |
| ^ | value | string | (必填) POST字段值。 |
| variables | <   |      | 应在该步骤后应用的步骤级变量（宏）的根元素。<br>若变量值带有'regex:'前缀，则根据该前缀后的正则表达式模式从本步骤返回数据中提取值 |
| < | name | string | (必填) 变量名称。 |
| ^ | value | text | (必填) 变量值。 |
| headers | <   |      | 执行请求时发送的HTTP头部根元素。 |
| < | name | string | (必填) 头部名称。 |
| ^ | value | text | (必填) 头部值。 |
| follow\_redirects | <   | string | 跟随HTTP重定向。<br>可选值:^[1](#footnotes)^ NO (0)、YES (1, 默认)。 |
| retrieve\_mode | <   | string | HTTP响应检索模式。<br>可选值:^[1](#footnotes)^ BODY (0, 默认)、HEADERS (1)、BOTH (2)。 |
| timeout | <   | string | 步骤执行超时时间（可使用秒、[时间后缀](/manual/appendix/suffixes#时间后缀)或[user macro](/manual/config/macros/user_macros)）。<br>默认: 15秒。 |
| required | <   | string | 响应中必须包含的文本（为空时忽略）。 |
| status\_codes | <   | string | 可接受的HTTP状态码逗号分隔列表（如`200-201,210-299`；为空时忽略）。 |
::: noteclassic
另请参阅: [场景步骤](/manual/api/reference/httptest/object#场景步骤) (参考具有匹配名称的相关属性)。
:::

[comment]: # ({/5f667fc1-0dcf2b63})

[comment]: # ({d872388a-51ede6fc})
#### 模板仪表板

| 元素 | <   | 类型 | 描述 |
|-|---|---|-----------------------|
| uuid | <   | string | （必填）此仪表板的唯一标识符。 |
| name | <   | string | （必填）模板仪表板名称。 |
| display period | <   | integer | 仪表板页面的显示周期。 |
| auto\_start | <   | string | 幻灯片自动开始。<br>可能的值：^[1](#footnotes)^ 否（0），是（1，默认）。 |
| pages | <   |      | 模板仪表板页面的根元素。 |
| < | name | string | 页面名称。  |
| ^ | display period | integer | 页面显示周期。 |
| ^ | sortorder | integer | 页面排序顺序。 |
| widgets | <   |      | [模板仪表板小部件](#template-dashboard-widgets)的根元素。 |
::: noteclassic
另请参阅：[Template dashboard object](/manual/api/reference/templatedashboard/object)（参考名称匹配的相关属性）。
:::

[comment]: # ({/d872388a-51ede6fc})

[comment]: # ({30097c1f-c1a97fff})
##### 模板仪表板小部件

| 元素 | <   | 类型 | 描述 |
|-|---|---|-----------------------|
| type | <   | string | （必填）小部件get类型。 |
| name | <   | string | 小部件get名称。 |
| x | <   | integer | 从模板仪表板左侧开始的水平位置。<br>可能的值：^[1](#footnotes)^ 0-71。 |
| y | <   | integer | 从模板仪表板Top开始的垂直位置。<br>可能的值：^[1](#footnotes)^ 0-63。 |
| width | <   | integer | 小部件get宽度。<br>可能的值：^[1](#footnotes)^ 1-72。 |
| height | <   | integer | 小部件get高度。<br>可能的值：^[1](#footnotes)^ 1-64。 |
| hide\_header | <   | string | 隐藏小部件get标题。<br>可能的值：^[1](#footnotes)^ 否（0，默认），是（1）。 |
| fields | <   |      | 模板仪表板小部件get字段的根元素。 |
| < | type | string | （必填）小部件get字段类型。<br>可能的值：^[1](#footnotes)^ integer（0），string（1），监控项（4），监控项\_PROTOTYPE（5），GRAPH（6），GRAPH\_PROTOTYPE（7），MAP（8），SERVICE（9），SLA（10），USER（11），ACTION（12），MEDIA_TYPE（13）。 |
| ^ | name | string | （必填）小部件get字段名称。 |
| ^ | value | mixed | （必填）小部件get字段值，取决于字段类型。 |
::: noteclassic
另请参见：[Template dashboard widget object](/manual/api/reference/templatedashboard/object#template-dashboard-widget)（参考具有匹配名称的相关属性）。
:::

[comment]: # ({/30097c1f-c1a97fff})

[comment]: # ({6863a601-8e4db88d})
#### 模板值映射

| 元素 | <   | 类型 | 描述 |
|-|---|---|-----------------------|
| uuid | <   | string | （必填）此值映射的唯一标识符。 |
| name | <   | string | （必填）值映射名称。 |
| mapping | <   |      | 映射的根元素。 |
| < | type | string | 映射匹配类型。<br>可能的值：^[1](#footnotes)^ EQUAL（0，默认）、GREATER_OR_EQUAL（2）、LESS_OR_EQUAL（3）、IN_RANGE（4）、REGEXP（5）、DEFAULT（6）。 |
| ^ | value | string | 原始值。 |
| ^ | newvalue | string | （必填）原始值映射到的值。 |
::: noteclassic
另请参阅：[Value map object](/manual/api/reference/valuemap/object)（参考具有匹配名称的相关属性）。
:::

[comment]: # ({/6863a601-8e4db88d})

[comment]: # ({8a9ebde1-869bd76e})
## 脚注

^ 1 ^ API integer 括号中的值，例如 ENABLED (0)，仅为参考。
如需更多信息，请参见表格条目中的链接 API object 页面或每个章节末尾的链接。

[comment]: # ({/8a9ebde1-869bd76e})