以下objects与hostprototype
API直接相关。
主机原型object具有以下属性。
属性 | 数据类型 | 描述 |
---|---|---|
hostid | string | (只读) 主机原型的ID。 |
host (required) |
string | 主机原型的技术名称。 |
name | string | 主机原型的可见名称。 默认值: host 属性值。 |
status | integer | 主机原型的状态。 可能的值有: 0 - (默认) 受监控的主机; 1 - 未监控的主机。 |
inventory_mode | integer | 主机清单填充模式。 可能的值有: -1 - (默认) 禁用; 0 - 手动; 1 - 自动。 |
templateid | string | (只读) 父模板主机原型的ID。 |
discover | integer | 主机原型发现状态。 可能的值: 0 - (默认) 将发现新的主机; 1 - 不会发现新的主机,且现有的主机将被标记为丢失。 |
custom_interfaces | integer | 由主机原型创建的主机的接口来源。 可能的值: 0 - (默认) 从父主机继承接口; 1 - 使用主机原型的自定义接口。 |
uuid | string | 通用唯一标识符,用于将导入的主机原型链接到已存在的原型。仅用于模板上的主机原型。如果未提供,则自动生成。 |
请注意,某些方法(更新、删除)所需/可选参数的组合有所不同。
组链接object用于将主机原型与主机组关联,具有以下属性。
属性 | 数据类型 | 描述 |
---|---|---|
groupid (required) |
string | 主机组的标识符。 |
组原型object定义了将为发现的主机创建的组,并具有以下属性。
属性 | 数据类型 | 描述 |
---|---|---|
group_prototypeid | string | (只读) 组原型的ID。 |
name (required) |
string | 组原型的名称。 |
主机原型标签object具有以下属性。
属性 | 数据类型 | 描述 |
---|---|---|
tag (required) |
string | 主机原型标签名称。 |
value | string | 主机原型标签值。 |
自定义接口object具有以下属性。
属性 | 数据类型 | 描述 |
---|---|---|
dns | string | 接口使用的DNS名称。 必填(如果通过DNS建立连接)。可包含宏。 |
ip | string | 接口使用的IP地址。 必填(如果通过IP建立连接)。可包含宏。 |
main (required) |
integer | 该接口是否作为主机的默认接口。每个主机上同类型接口只能有一个设为默认。 可选值: 0 - 非默认; 1 - 默认。 |
port (required) |
string | 接口使用的端口号。可包含用户宏和LLD宏。 |
type (required) |
integer | 接口类型。 可选值: 1 - agent; 2 - SNMP; 3 - IPMI; 4 - JMX。 |
useip (required) |
integer | 是否通过IP建立连接。 可选值: 0 - 使用主机的DNS名称连接; 1 - 使用该主机接口的IP地址连接。 |
details | array | 接口的附加object。必填(当接口类型为SNMP时)。 |
详情 object 具有以下属性。
属性 | 数据类型 | 描述 |
---|---|---|
version (required) |
integer | SNMP接口版本。 可能值为: 1 - SNMPv1; 2 - SNMPv2c; 3 - SNMPv3 |
bulk | integer | 是否使用批量SNMP请求。 可能值为: 0 - 不使用批量请求; 1 - (默认) - 使用批量请求。 |
community | string | SNMP团体名。仅用于SNMPv1和SNMPv2接口。 |
securityname | string | SNMPv3安全名称。仅用于SNMPv3接口。 |
securitylevel | integer | SNMPv3安全级别。仅用于SNMPv3接口。 可能值为: 0 - (默认) - 无认证无加密; 1 - 认证无加密; 2 - 认证加密。 |
authpassphrase | string | SNMPv3认证密码。仅用于SNMPv3接口。 |
privpassphrase | string | SNMPv3加密密码。仅用于SNMPv3接口。 |
authprotocol | integer | SNMPv3认证协议。仅用于SNMPv3接口。 可能值为: 0 - (默认) - MD5; 1 - SHA1; 2 - SHA224; 3 - SHA256; 4 - SHA384; 5 - SHA512。 |
privprotocol | integer | SNMPv3加密协议。仅用于SNMPv3接口。 可能值为: 0 - (默认) - DES; 1 - AES128; 2 - AES192; 3 - AES256; 4 - AES192C; 5 - AES256C。 |
contextname | string | SNMPv3上下文名称。仅用于SNMPv3接口。 |