[comment]: # ({ae6d2ebd-ae6d2ebd})
# 3 主机

[comment]: # ({/ae6d2ebd-ae6d2ebd})

[comment]: # ({907c3faa-907c3faa})
#### 概述

主机 是 [exported](/manual/xml_export_import) 具有多种关联
objects 和 object 关系的对象.

主机 export 包含:

-   关联的 主机 组
-   主机 数据
-   模板链接
-   主机组 链接
-   主机 接口
-   直接关联的 监控项
-   直接关联的触发器
-   直接关联的图形
-   直接关联的发现规则及其所有原型
-   直接关联的Web场景
-   主机宏
-   主机 资产数据
-   值映射

[comment]: # ({/907c3faa-907c3faa})

[comment]: # ({55d6da26-55d6da26})
#### 导出

要export 主机，请执行以下操作：

-   前往：*配置* → *主机*
-   勾选 主机 的复选框以 export
- 在列表下方点击*Export*

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

根据所选格式，主机会被导出到本地file
使用默认名称:

-   *zabbix_export_hosts.yaml* - YAML格式的export（默认选项用于
    export
-   *zabbix\_export\_hosts.xml* - XML格式 export
-   *zabbix\_export\_hosts.json* - JSON格式 export

[comment]: # ({/55d6da26-55d6da26})

[comment]: # ({86289327-158cdcbf})
#### 导入

要import主机，请执行以下操作：

-   前往：*Configuration* → *主机*
-   点击右侧的*Import*
-   选择importfile
-   在import规则中标记所需选项
-   点击*Import*

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

前端将显示import的成功或失败消息。

导入规则：

| 规则 | 描述 |
|----|-----------|
| *更新现有* | 现有元素将使用importfile中的数据更新。否则将不会更新。 |
| *创建新* | import将使用importfile中的数据添加新元素。否则不会添加。 |
| *删除缺失* | import将移除importfile中不存在的现有元素。否则不会移除。<br>如果为模板链接标记了*删除缺失*，则importfile中不存在的现有模板链接将被取消链接。自Zabbix 6.0.13起，从取消链接的模板继承的实体（监控项、触发器、图形等）不会被移除（除非还为每个实体选择了*删除缺失*选项）。 |

[comment]: # ({/86289327-158cdcbf})

[comment]: # ({7c0a4deb-93059e09})
#### 导出格式

YAML导出格式:

```{.yaml}
zabbix_export:
  version: '6.0'
  date: '2023-05-03T11:24:04Z'
  groups:
    - uuid: dc579cd7a1a34222933f24f52a68bcd8
      name: 'Linux servers'
  hosts:
    - host: Example_host
      name: Example_host
      templates:
        - name: 'Zabbix server health'
      groups:
        - name: 'Linux servers'
      items:
        - name: Test_item1
          type: ZABBIX_ACTIVE
          key: kernel.maxproc
      inventory_mode: DISABLED
```

[comment]: # ({/7c0a4deb-93059e09})

[comment]: # ({2c61d3f8-2c61d3f8})
#### 元素标签

元素标签值在下表中进行说明。

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

[comment]: # ({17b1e373-eedfe2b9})
##### 主机标签

| 元素 | 元素属性 | 必填 | 类型 | 范围^**[1](#footnotes)**^ | 描述 |
|--|--|-|--|----|--------|
| groups |                  | x        |      |                        | 主机组的根元素。 |
|         | name | x        | `string` |                        | 主机组名称。 |
| hosts |                  | \-       |      |                        | 主机的根元素。 |
|         | host | x        | `string` |                        | 唯一主机名。 |
|         | name | \-       | `string` |                        | 可见主机名。 |
|         | description | \-       | `text` |                        | 主机描述。 |
|         | status | \-       | `string` | 0 - ENABLED (default)<br>1 - DISABLED       | 主机状态。 |
|         | ipmi\_authtype | \-       | `string` | -1 - DEFAULT (default)<br>0 - NONE<br>1 - MD2<br>2 - MD5<br>4 - STRAIGHT<br>5 - OEM<br>6 - RMCP\_PLUS       | IPMI会话认证类型。 |
|         | ipmi\_privilege | \-       | `string` | 1 - CALLBACK<br>2 - USER (default)<br>3 - OPERATOR<br>4 - ADMIN<br>5 - OEM       | IPMI会话权限级别。 |
|         | ipmi\_username | \-       | `string` |                        | IPMI检查的用户名。 |
|         | ipmi\_password | \-       | `string` |                        | IPMI检查的密码。 |
| proxy |                  | \-       |      |                        | Proxy。 |
|         | name | x        | `string` |                        | 监控主机的proxy名称（如有）。 |
| templates |                  | \-       |      |                        | 关联模板的根元素。 |
|         | name | x        | `string` |                        | 模板名称。 |
| interfaces |                  | \-       |      |                        | 主机接口的根元素。 |
|         | default | \-       | `string` | 0 - NO<br>1 - YES (default)       | 是否为主主机接口。<br>一个一个主机上每种类型只能有一个主接口。 |
|         | type | \-       | `string` | 1 - ZABBIX (default)<br>2 - SNMP<br>3 - IPMI<br>4 - JMX       | 接口类型。 |
|         | useip | \-       | `string` | 0 - NO<br>1 - YES (default)       | 是否使用IP连接主机（否则使用DNS）。 |
|         | ip | \-       | `string` |                        | IP地址，可以是IPv4或IPv6。<br><br>通过IP连接时必填。 |
|         | dns | \-       | `string` |                        | DNS名称。<br><br>通过DNS连接时必填。 |
|         | port | \-       | `string` |                        | 端口号。支持用户宏。 |
|         | interface\_ref | x        | `string` | Format: `if<N>`       | 接口引用名称，用于监控项。 |
| details |                  | \-       |      |                        | 接口详情的根元素。 |
|         | version | \-       | `string` | 1 - SNMPV1<br>2 - SNMP\_V2C (default)<br>3 - SNMP\_V3       | 使用此SNMPversion。 |
|         | community | \-       | `string` |                        | SNMP团体名。<br><br>SNMPv1和SNMPv2监控项必填。 |
|         | contextname | \-       | `string` |                        | SNMPv3上下文名称。<br><br>仅用于SNMPv3监控项。 |
|         | securityname | \-       | `string` |                        | SNMPv3安全名称。<br><br>仅用于SNMPv3监控项。 |
|         | securitylevel | \-       | `string` | 0 - NOAUTHNOPRIV (default)<br>1 - AUTHNOPRIV<br>2 - AUTHPRIV       | SNMPv3安全级别。<br><br>仅用于SNMPv3监控项。 |
|         | authprotocol | \-       | `string` | 0 - MD5 (default)<br>1 - SHA1<br>2 - SHA224<br>3 - SHA256<br>4 - SHA384<br>5 - SHA512       | SNMPv3认证协议。<br><br>仅用于SNMPv3监控项。 |
|         | authpassphrase | \-       | `string` |                        | SNMPv3认证密码。<br><br>仅用于SNMPv3监控项。 |
|         | privprotocol | \-       | `string` | 0 - DES (default)<br>1 - AES128<br>2 - AES192<br>3 - AES256<br>4 - AES192C<br>5 - AES256C       | SNMPv3隐私协议。<br><br>仅用于SNMPv3监控项。 |
|         | privpassphrase | \-       | `string` |                        | SNMPv3隐私密码。<br><br>仅用于SNMPv3监控项。 |
|         | bulk | \-       | `string` | 0 - NO<br>1 - YES (default)       | 对SNMP使用批量请求。 |
| items |                  | \-       |      |                        | 监控项的根元素。 |
|         | *For item element tag values, see host [主机-监控项标签](/manual/xml_export_import/hosts#主机-监控项标签) tags.* |          |      |                        |             |
| tags |                  | \-       |      |                        | 主机标签的根元素。 |
|         | tag | x        | `string` |                        | 标签名称。   |
|         | value | \-       | `string` |                        | 标签值。  |
| macros |                  | \-       |      |                        | 宏的根元素。 |
|         | macro | x        |      |                        | 用户宏名称。 |
|         | type | \-       | `string` | 0 - TEXT (default)<br>1 - SECRET\_TEXT<br>2 - VAULT       | 宏的类型。 |
|         | value | \-       | `string` |                        | 用户宏值。 |
|         | description | \-       | `string` |                        | 用户宏描述。 |
| inventory |                  | \-       |      |                        | 主机资产清单的根元素。 |
|         | <inventory\_property> | \-       |      |                        | 单个资产清单属性。<br><br>所有可用资产清单属性列在相应标签下，例如<type>、<name>、<os>（见上例）。 |
| inventory\_mode |                  | \-       | `string` | -1 - DISABLED<br>0 - MANUAL (default)<br>1 - AUTOMATIC       | 资产清单模式。 |
| valuemaps |                  | \-       |      |                        | 主机值映射的根元素。 |
|         | name | x        | `string` |                        | 值映射名称。 |
|         | mapping | \-       |      |                        | 映射的根元素。 |
|         | value | x        | `string` |                        | 映射的值。 |
|         | newvalue | x        | `string` |                        | 映射的新值。 |

[comment]: # ({/17b1e373-eedfe2b9})

[comment]: # ({a9f99f47-8a2e4e2f})
##### 主机 监控项标签

| 元素 | 元素属性 | 必需 | 类型 | 范围^**[1](#footnotes)**^ | 描述 |
|--|--|-|--|----|--------|
| items |                  | \-       |      |                        | 监控项的根元素。 |
|         | name | x        | `string` |                        | 监控项名称。 |
|         | type | \-       | `string` | 0 - ZABBIX\_PASSIVE (default)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNAL<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNAL<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>15 - CALCULATED<br>16 - JMX<br>17 - SNMP\_TRAP<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT<br>21 - ITEM\_TYPE\_SCRIPT       | 监控项类型。 |
|         | snmp\_oid | \-       | `string` |                        | SNMP object ID。<br><br>SNMP 监控项必需。 |
|         | key | x        | `string` |                        | 监控项键值。 |
|         | delay | \-       | `string` | Default: 1m       | 监控项的更新间隔。<br><br>注意：对于trapper 监控项，`delay`将始终为'0'。<br><br>接受秒数或带后缀的时间单位（30s, 1m, 2h, 1d）。<br>可选地可以指定一个或多个[custom intervals](/manual/config/items/item/custom_intervals)作为灵活间隔或调度。<br>多个间隔用分号分隔。<br>可以使用用户宏。单个宏必须填满整个字段。不支持字段中的多个宏或宏与文本混合。<br>灵活间隔可以写成两个宏，用斜杠分隔（例如`{$FLEX_INTERVAL}/{$FLEX_PERIOD}`）。 |
|         | history | \-       | `string` | Default: 90d       | 历史数据应存储的时间段。使用时间后缀、用户宏或LLD宏的时间段。 |
|         | trends | \-       | `string` | Default: 365d       | 趋势数据应存储的时间段。使用时间后缀、用户宏或LLD宏的时间段。 |
|         | status | \-       | `string` | 0 - ENABLED (default)<br>1 - DISABLED       | 监控项状态。 |
|         | value\_type | \-       | `string` | 0 - FLOAT<br>1 - CHAR<br>2 - LOG<br>3 - UNSIGNED (default)<br>4 - TEXT       | 接收值类型。 |
|         | allowed\_hosts | \-       | `string` |                        | 允许为监控项发送数据的主机的IP地址列表（逗号分隔）。<br><br>用于trapper和HTTP agent 监控项。 |
|         | units | \-       | `string` |                        | 返回值的单位（bps, B等）。 |
|         | params | \-       | `text` |                        | 根据监控项类型的附加参数：<br>- 脚本、SSH和Telnet 监控项的执行脚本；<br>- 数据库监控监控项的SQL query；<br>- 计算监控项的公式。 |
|         | ipmi\_sensor | \-       | `string` |                        | IPMI传感器。<br><br>仅用于IPMI 监控项。 |
|         | authtype | \-       | `string` | Authentication type for SSH agent items:<br>0 - PASSWORD (default)<br>1 - PUBLIC\_KEY<br><br>Authentication type for HTTP agent items:<br>0 - NONE (default)<br>1 - BASIC<br>2 - NTLM       | 认证类型。<br><br>仅用于SSH和HTTP agent 监控项。 |
|         | username | \-       | `string` |                        | 认证用户名。<br>用于简单检查、SSH、Telnet、数据库监控、JMX和HTTP agent 监控项。<br><br>SSH和Telnet 监控项必需。<br>当用于JMX agent时，密码也应与用户名一起指定，或者两个属性都应留空。 |
|         | password | \-       | `string` |                        | 认证密码。<br>用于简单检查、SSH、Telnet、数据库监控、JMX和HTTP agent 监控项。<br><br>当用于JMX agent时，用户名也应与密码一起指定，或者两个属性都应留空。 |
|         | publickey | \-       | `string` |                        | 公钥file的名称。<br><br>SSH agent 监控项必需。 |
|         | privatekey | \-       | `string` |                        | 私钥file的名称。<br><br>SSH agent 监控项必需。 |
|         | description | \-       | `text` |                        | 监控项描述。 |
|         | inventory\_link | \-       | `string` | 0 - NONE<br><br>Capitalized host inventory field name. For example:<br>4 - ALIAS<br>6 - OS\_FULL<br>14 - HARDWARE<br>etc.       | 主机库存字段，由监控项填充。<br><br>参考[主机资产清单](/manual/api/reference/host/object#主机资产清单)获取支持的主机库存字段及其ID列表。 |
|         | logtimefmt | \-       | `string` |                        | 日志条目中的时间格式。<br>仅用于日志监控项。 |
|         | interface\_ref | \-       | `string` | Format: `if<N>`       | 引用主机接口。 |
|         | jmx\_endpoint | \-       | `string` |                        | JMX端点。<br><br>仅用于JMX agent 监控项。 |
|         | url | \-       | `string` |                        | URL string。<br><br>仅HTTP agent 监控项必需。 |
|         | allow\_traps | \-       | `string` | 0 - NO (default)<br>1 - YES       | 允许像trapper 监控项一样填充值。<br><br>仅用于HTTP agent 监控项。 |
|         | follow\_redirects | \-       | `string` | 0 - NO<br>1 - YES (default)       | 在轮询数据时跟随HTTP响应重定向。<br><br>仅用于HTTP agent 监控项。 |
| headers |                  | \-       |      |                        | HTTP(S)请求头的根元素，其中头名称用作键，头值用作值。<br>仅用于HTTP agent 监控项。 |
|         | name | x        | `string` |                        | 头名称。 |
|         | value | x        | `string` |                        | 头值。 |
|         | http\_proxy | \-       | `string` |                        | HTTP(S) proxy连接string。<br><br>仅用于HTTP agent 监控项。 |
|         | output\_format | \-       | `string` | 0 - RAW (default)<br>1 - JSON       | 如何处理响应。<br><br>仅用于HTTP agent 监控项。 |
|         | post\_type | \-       | `string` | 0 - RAW (default)<br>2 - JSON<br>3 - XML       | 发布数据正文的类型。<br><br>仅用于HTTP agent 监控项。 |
|         | posts | \-       | `string` |                        | HTTP(S)请求正文数据。<br><br>仅用于HTTP agent 监控项。 |
| query\_fields |                  | \-       |      |                        | query参数的根元素。<br><br>仅用于HTTP agent 监控项。 |
|         | name | x        | `string` |                        | 参数名称。 |
|         | value | \-       | `string` |                        | 参数值。 |
|         | request\_method | \-       | `string` | 0 - GET (default)<br>1 - POST<br>2 - PUT<br>3 - HEAD       | 请求方法。<br><br>仅用于HTTP agent 监控项。 |
|         | retrieve\_mode | \-       | `string` | 0 - BODY (default)<br>1 - HEADERS<br>2 - BOTH       | 应存储响应的哪部分。<br><br>仅用于HTTP agent 监控项。 |
|         | ssl\_cert\_file | \-       | `string` |                        | 公共SSL密钥file路径。<br><br>仅用于HTTP agent 监控项。 |
|         | ssl\_key\_file | \-       | `string` |                        | 私有SSL密钥file路径。<br><br>仅用于HTTP agent 监控项。 |
|         | ssl\_key\_password | \-       | `string` |                        | SSL密钥file的密码。<br><br>仅用于HTTP agent 监控项。 |
|         | status\_codes | \-       | `string` |                        | 所需HTTP状态代码的范围，用逗号分隔。支持用户宏。<br>示例：200,200-{$M},{$M},200-400<br><br>仅用于HTTP agent 监控项。 |
|         | timeout | \-       | `string` |                        | 监控项数据轮询请求超时。支持用户宏。<br><br>用于HTTP agent和脚本监控项。 |
|         | verify\_host | \-       | `string` | 0 - NO (default)<br>1 - YES       | 是否验证连接的主机名称与主机证书中的名称匹配。<br><br>仅用于HTTP agent 监控项。 |
|         | verify\_peer | \-       | `string` | 0 - NO (default)<br>1 - YES       | 是否验证主机证书的真实性。<br><br>仅用于HTTP agent 监控项。 |
| parameters |                  | \-       |      |                        | 用户定义参数的根元素。<br><br>仅用于脚本监控项。 |
|         | name | x        | `string` |                        | 参数名称。<br><br>仅用于脚本监控项。 |
|         | value | \-       | `string` |                        | 参数值。<br><br>仅用于脚本监控项。 |
| value map |                  | \-       |      |                        | 值映射。  |
|         | name | x        | `string` |                        | 用于监控项的值映射名称。 |
| preprocessing |                  | \-       |      |                        | 监控项值预处理的根元素。 |
| step |                  | \-       |      |                        | 单个监控项值预处理步骤。 |
|         | type | x        | `string` | 1 - MULTIPLIER<br>2 - RTRIM<br>3 - LTRIM<br>4 - TRIM<br>5 - REGEX<br>6 - BOOL\_TO\_DECIMAL<br>7 - OCTAL\_TO\_DECIMAL<br>8 - HEX\_TO\_DECIMAL<br>9 - SIMPLE\_CHANGE (calculated as (received value-previous value))<br>10 - CHANGE\_PER\_SECOND (calculated as (received value-previous value)/(time now-time of last check))<br>11 - XMLPATH<br>12 - JSONPATH<br>13 - IN\_RANGE<br>14 - MATCHES\_REGEX<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>18 - CHECK\_REGEX\_ERROR<br>19 - DISCARD\_UNCHANGED<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>22 - PROMETHEUS\_PATTERN<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>26 - CHECK\_NOT\_SUPPORTED<br>27 - XML\_TO\_JSON       | 监控项值预处理步骤的类型。 |
|         | parameters | \-       |      |                        | 监控项值预处理步骤参数的根元素。 |
|         | parameter | x        | `string` |                        | 监控项值预处理步骤的单个参数。 |
|         | error\_handler | \-       | `string` | 0 - ORIGINAL\_ERROR (default)<br>1 - DISCARD\_VALUE<br>2 - CUSTOM\_VALUE<br>3 - CUSTOM\_ERROR       | 预处理步骤失败时使用的操作类型。 |
|         | error\_handler\_params | \-       | `string` |                        | 与'error\_handler'一起使用的错误处理程序参数。 |
| master\_item |                  | \-       |      |                        | 单个监控项主监控项。<br><br>依赖监控项必需。 |
|         | key | x        | `string` |                        | 依赖监控项主监控项键值。<br><br>允许递归最多3个依赖监控项，最大依赖监控项数量为29999。 |
| triggers |                  | \-       |      |                        | 简单触发器的根元素。 |
|         | *For trigger element tag values, see host [主机触发器标签](/manual/xml_export_import/hosts#主机触发器标签).* |          |      |                        |             |
| tags |                  | \-       |      |                        | 监控项标签的根元素。 |
|         | tag | x        | `string` |                        | 标签名称。   |
|         | value | \-       | `string` |                        | 标签值。  |

[comment]: # ({/a9f99f47-8a2e4e2f})

[comment]: # ({492e9cc2-19e8eae6})
##### 主机低级别发现规则标签

| 元素 | 元素属性 | 必填 | 类型 | 范围^**[1](#footnotes)**^ | 描述 |
|--|--|-|--|----|--------|
| discovery\_rules |                  | \-       |      |                        | 低级发现规则的根元素。 |
|         | *For most of the element tag values, see element tag values for a regular item. Only the tags that are specific to low-level discovery rules, are described below.* |          |      |                        |             |
|         | type | \-       | `string` | 0 - ZABBIX\_PASSIVE (default)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNAL<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNAL<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>16 - JMX<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT       | 监控项 类型。 |
|         | lifetime | \-       | `string` | Default: 30d       | 不再发现的 监控项 将被删除的时间周期。秒数、带后缀的时间单位或用户宏。 |
| filter |                  |          |      |                        | 单个过滤器。 |
|         | evaltype | \-       | `string` | 0 - AND\_OR (default)<br>1 - AND<br>2 - OR<br>3 - FORMULA       | 用于检查低级发现规则过滤条件的逻辑。 |
|         | formula | \-       | `string` |                        | 过滤条件的自定义计算公式。 |
| conditions |                  | \-       |      |                        | 过滤条件的根元素。 |
|         | macro | x        | `string` |                        | 低级发现宏名称。 |
|         | value | \-       | `string` |                        | 过滤值：正则表达式或全局正则表达式。 |
|         | operator | \-       | `string` | 8 - MATCHES\_REGEX (default)<br>9 - NOT\_MATCHES\_REGEX       | 条件运算符。 |
|         | formulaid | x        | `character` |                        | 用于从自定义表达式中引用条件的任意唯一ID。只能包含大写字母。修改过滤条件时必须由用户定义ID，但在后续请求时会重新生成。 |
| lld\_macro\_paths |                  | \-       |      |                        | LLD宏路径的根元素。 |
|         | lld\_macro | x        | `string` |                        | 低级发现宏名称。 |
|         | path | x        | `string` |                        | 选择器，用于分配给相应宏的值。 |
| preprocessing |                  | \-       |      |                        | LLD规则值预处理。 |
| step |                  | \-       |      |                        | 单个LLD规则值预处理步骤。 |
|         | *For most of the element tag values, see element tag values for a host item value preprocessing. Only the tags that are specific to low-level discovery value preprocessing, are described below.* |          |      |                        |             |
|         | type | x        | `string` | 5 - REGEX<br>11 - XMLPATH<br>12 - JSONPATH<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>27 - XML\_TO\_JSON       | 监控项 值预处理步骤的类型。 |
| trigger\_prototypes |                  | \-       |      |                        | 触发器原型的根元素。 |
|         | *For trigger prototype element tag values, see regular [主机触发器标签](/manual/xml_export_import/hosts#主机触发器标签) tags.* |          |      |                        |             |
| graph\_prototypes |                  | \-       |      |                        | 图形原型的根元素。 |
|         | *For graph prototype element tag values, see regular [主机图形标签](/manual/xml_export_import/hosts#主机图形标签) tags.* |          |      |                        |             |
| host\_prototypes |                  | \-       |      |                        | 主机 原型的根元素。 |
|         | *For host prototype element tag values, see regular [主机标签](/manual/xml_export_import/hosts#主机标签) tags.* |          |      |                        |             |
| item\_prototypes |                  | \-       |      |                        | 监控项原型 的根元素。 |
|         | *For item prototype element tag values, see regular [主机-监控项标签](/manual/xml_export_import/hosts#主机-监控项标签) tags.* |          |      |                        |             |
| master\_item |                  | \-       |      |                        | 单个 监控项 原型主 监控项/监控项 原型数据。 |
|         | key | x        | `string` |                        | 依赖 监控项 原型主 监控项/监控项 原型键值。<br><br>依赖 监控项 的必填项。 |

[comment]: # ({/492e9cc2-19e8eae6})

[comment]: # ({b7a8516e-5ff5f79a})
##### 主机触发器标签

| 元素 | 元素属性 | 必填 | 类型 | 范围^**[1](#footnotes)**^ | 描述 |
|--|--|-|--|----|--------|
| triggers |                  | \-       |      |                        | 触发器根元素。 |
|         | expression | x        | `string` |                        | 触发器表达式。 |
|         | recovery\_mode | \-       | `string` | 0 - EXPRESSION (default)<br>1 - RECOVERY\_EXPRESSION<br>2 - NONE       | 生成OK事件的基础。 |
|         | recovery\_expression | \-       | `string` |                        | 触发器恢复表达式。 |
|         | correlation\_mode | \-       | `string` | 0 - DISABLED (default)<br>1 - TAG\_VALUE       | 关联模式（无事件关联或通过标签进行事件关联）。 |
|         | correlation\_tag | \-       | `string` |                        | 用于事件关联的标签名称。 |
|         | name | x        | `string` |                        | 触发器名称。 |
|         | event_name | \-       | `string` |                        | 事件名称。 |
|         | opdata | \-       | `string` |                        | 操作数据。 |
|         | url | \-       | `string` |                        | 与触发器关联的URL。 |
|         | status | \-       | `string` | 0 - ENABLED (default)<br>1 - DISABLED       | 触发器状态。 |
|         | priority | \-       | `string` | 0 - NOT\_CLASSIFIED (default)<br>1 - INFO<br>2 - WARNING<br>3 - AVERAGE<br>4 - HIGH<br>5 - DISASTER       | 触发器严重性。 |
|         | description | \-       | `text` |                        | 触发器描述。 |
|         | type | \-       | `string` | 0 - SINGLE (default)<br>1 - MULTIPLE       | 事件生成类型（单个问题事件或多个问题事件）。 |
|         | manual\_close | \-       | `string` | 0 - NO (default)<br>1 - YES       | 手动关闭问题事件。 |
| dependencies |                  | \-       |      |                        | 依赖项根元素。 |
|         | name | x        | `string` |                        | 依赖触发器名称。 |
|         | expression | x        | `string` |                        | 依赖触发器表达式。 |
|         | recovery\_expression | \-       | `string` |                        | 依赖触发器恢复表达式。 |
| tags |                  | \-       |      |                        | 事件标签根元素。 |
|         | tag | x        | `string` |                        | 标签名称。   |
|         | value | \-       | `string` |                        | 标签值。  |

[comment]: # ({/b7a8516e-5ff5f79a})

[comment]: # ({181ea4fc-0a8a430a})
##### 主机图形标签

| 元素 | 元素属性 | 必填 | 类型 | 范围^**[1](#footnotes)**^ | 描述 |
|--|--|-|--|----|--------|
| graphs |                  | \-       |      |                        | 图表根元素。 |
|         | name | x        | `string` |                        | 图表名称。 |
|         | width | \-       | `integer` | 20-65535 (default: 900)       | 图表宽度，单位为像素。用于预览及饼图/爆炸图。 |
|         | height | \-       | `integer` | 20-65535 (default: 200)       | 图表高度，单位为像素。用于预览及饼图/爆炸图。 |
|         | yaxismin | \-       | `double` | Default: 0       | Y轴最小值。<br><br>当'ymin\_type\_1'为FIXED时使用。 |
|         | yaxismax | \-       | `double` | Default: 0       | Y轴最大值。<br><br>当'ymax\_type\_1'为FIXED时使用。 |
|         | show\_work\_period | \-       | `string` | 0 - NO<br>1 - YES (default)       | 高亮非工作时间。<br><br>用于普通图和堆叠图。 |
|         | show\_triggers | \-       | `string` | 0 - NO<br>1 - YES (default)       | 将简单触发器值显示为线条。<br><br>用于普通图和堆叠图。 |
|         | type | \-       | `string` | 0 - NORMAL (default)<br>1 - STACKED<br>2 - PIE<br>3 - EXPLODED       | 图表类型。 |
|         | show\_legend | \-       | `string` | 0 - NO<br>1 - YES (default)       | 显示图例。 |
|         | show\_3d | \-       | `string` | 0 - NO (default)<br>1 - YES       | 启用3D样式。<br><br>用于饼图和爆炸饼图。 |
|         | percent\_left | \-       | `double` | Default:0       | 显示左轴百分位线。<br><br>仅用于普通图。 |
|         | percent\_right | \-       | `double` | Default:0       | 显示右轴百分位线。<br><br>仅用于普通图。 |
|         | ymin\_type\_1 | \-       | `string` | 0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM       | Y轴最小值。<br><br>用于普通图和堆叠图。 |
|         | ymax\_type\_1 | \-       | `string` | 0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM       | Y轴最大值。<br><br>用于普通图和堆叠图。 |
| ymin\_item\_1 |                  | \-       |      |                        | 单个监控项详情。<br><br>当'ymin\_type\_1'为监控项时必填。 |
|         | host | x        | `string` |                        | 监控项 主机。 |
|         | key | x        | `string` |                        | 监控项键。 |
| ymax\_item\_1 |                  | \-       |      |                        | 单个监控项详情。<br><br>当'ymax\_type\_1'为监控项时必填。 |
|         | host | x        | `string` |                        | 监控项 主机。 |
|         | key | x        | `string` |                        | 监控项键。 |
| graph\_items |                  | x        |      |                        | 图表监控项根元素。 |
|         | sortorder | \-       | `integer` |                        | 绘制顺序。数值小的优先绘制。可用于将线条或区域绘制在另一元素后方(或前方)。 |
|         | drawtype | \-       | `string` | 0 - SINGLE\_LINE (default)<br>1 - FILLED\_REGION<br>2 - BOLD\_LINE<br>3 - DOTTED\_LINE<br>4 - DASHED\_LINE<br>5 - GRADIENT\_LINE       | 图表监控项绘制样式。<br><br>仅用于普通图。 |
|         | color | \-       | `string` |                        | 元素颜色(6位十六进制)。 |
|         | yaxisside | \-       | `string` | 0 - LEFT (default)<br>1 - RIGHT       | 图表监控项Y轴绘制位置。<br><br>用于普通图和堆叠图。 |
|         | calc\_fnc | \-       | `string` | 1 - MIN<br>2 - AVG (default)<br>4 - MAX<br>7 - ALL (minimum, average and maximum; used only by simple graphs)<br>9 - LAST (used only by pie and exploded pie graphs)       | 当监控项存在多个值时绘制何种数据。 |
|         | type | \-       | `string` | 0 - SIMPLE (default)<br>2 - GRAPH\_SUM (value of the item represents the whole pie; used only by pie and exploded pie graphs)       | 图表监控项类型。 |
| item |                  | x        |      |                        | 单个监控项。 |
|         | host | x        | `string` |                        | 监控项 主机。 |
|         | key | x        | `string` |                        | 监控项键。 |

[comment]: # ({/181ea4fc-0a8a430a})

[comment]: # ({43d5d998-cae5eb15})
##### 主机 Web 场景标签

| 元素 | 元素属性 | 必填 | 类型 | 范围^**[1](#footnotes)**^ | 描述 |
|--|--|-|--|----|--------|
| httptests |                  | \-       |      |                        | 网络场景的根元素。 |
|         | name | x        | `string` |                        | 网络场景名称. |
|         | delay | \-       | `string` | Default: 1m       | 执行Web场景的频率. 支持秒数/带后缀的时间单位/用户宏. |
|         | attempts | \-       | `integer` | 1-10 (default: 1)       | 执行Web场景步骤的尝试次数。 |
|         | agent | \-       | `string` | Default: Zabbix       | 客户端 agent. Zabbix将模拟所选浏览器。当网站针对不同浏览器返回不同内容时，此功能非常有用。 |
|         | http\_proxy | \-       | `string` |                        | 指定要使用的HTTP proxy，格式为：`http://[username[:password]@]proxy.example.com[:port]` |
| variables |                  | \-       |      |                        | 用于场景步骤中可能使用的场景级变量（宏）的根元素。 |
|         | name | x        | `text` |                        | 变量名称. |
|         | value | x        | `text` |                        | 变量值. |
| headers |                  | \-       |      |                        | 执行请求时将发送的HTTP头部信息的根元素。头部应按照HTTP协议中出现的相同语法列出。 |
|         | name | x        | `text` |                        | 表头名称. |
|         | value | x        | `text` |                        | 表头值. |
|         | status | \-       | `string` | 0 - ENABLED (default)<br>1 - DISABLED       | Web场景状态. |
|         | authentication | \-       | `string` | 0 - NONE (default)<br>1 - BASIC<br>2 - NTLM       | 认证方法 |
|         | http\_user | \-       | `string` |                        | 用于基本认证、HTTP或NTLM认证的用户名。 |
|         | http\_password | \-       | `string` |                        | 用于基本认证、HTTP认证或NTLM认证的密码。 |
|         | verify\_peer | \-       | `string` | 0 - NO (default)<br>1 - YES       | 是否验证主机证书的真实性。 |
|         | verify\_host | \-       | `string` | 0 - NO (default)<br>1 - YES       | 是否验证连接中主机名称与主机证书中的名称匹配. |
|         | ssl\_cert\_file | \-       | `string` |                        | 用于客户端认证的SSL证书file名称（必须为PEM格式）。 |
|         | ssl\_key\_file | \-       | `string` |                        | 用于客户端认证的SSL私钥file名称（必须为PEM格式）。 |
|         | ssl\_key\_password | \-       | `string` |                        | SSL私钥 file 密码. |
| steps |                  | x        |      |                        | Web场景步骤的根元素。 |
|         | name | x        | `string` |                        | Web场景步骤名称. |
|         | url | x        | `string` |                        | 监控URL. |
| query\_fields |                  | \-       |      |                        | query字段的根元素 - 一个HTTP字段的array，在执行请求时将被添加到URL中。 |
|         | name | x        | `string` |                        | query 字段名称. |
|         | value | \-       | `string` |                        | query 字段值. |
| posts |                  | \-       |      |                        | 以string（原始POST数据）或HTTP字段array（表单字段数据）形式传递的HTTP POST变量。 |
|         | name | x        | `string` |                        | 表单字段名称. |
|         | value | x        | `string` |                        | 发布字段值. |
| variables |                  | \-       |      |                        | 应在此步骤后应用的步骤级变量（宏）的根元素。<br><br>如果变量值带有'regex:'前缀，则根据'regex:'前缀后的正则表达式模式，从该步骤返回的数据中提取其值 |
|         | name | x        | `string` |                        | 变量名称. |
|         | value | x        | `string` |                        | 变量值. |
| headers |                  | \-       |      |                        | 执行请求时将发送的HTTP头部信息的根元素。头部信息应使用与HTTP协议中相同的语法列出。 |
|         | name | x        | `string` |                        | 表头名称. |
|         | value | x        | `string` |                        | 表头值. |
|         | follow\_redirects | \-       | `string` | 0 - NO<br>1 - YES (default)       | 跟随HTTP重定向。 |
|         | retrieve\_mode | \-       | `string` | 0 - BODY (default)<br>1 - HEADERS<br>2 - BOTH       | HTTP响应检索模式. |
|         | timeout | \-       | `string` | Default: 15s       | 步骤执行超时时间。单位为秒，可带后缀的时间单位或用户宏。 |
|         | required | \-       | `string` |                        | 响应中必须包含的文本。如果为空则忽略。 |
|         | status\_codes | \-       | `string` |                        | 以逗号分隔的HTTP状态码允许列表. 若为空则忽略. 例如: 200-201,210-299 |
| tags |                  | \-       |      |                        | Web场景标签的根元素。 |
|         | tag | x        | `string` |                        | 标签名称.   |
|         | value | \-       | `string` |                        | 标签值.  |

[comment]: # ({/43d5d998-cae5eb15})

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

^**1**^ 对于string值，仅会导出string本身（例如"ZABBIX\_ACTIVE"），而不包含本表中使用的编号。本表中范围值（对应API值）的编号仅用于排序目的。

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