Documentation
> 主机接口对象
以下对象与 主机接口 API 直接相关。
主机接口
主机接口对象具有以下属性。
注意，IP和DNS都是必需的。如果您不想使用DNS，请将其设置为空字符串.
| 属性 | 类型 | 描述 |
|---|---|---|
| available | 整型 | (只读) 主机接口的可用性。 可能的值有: 0 - (默认) 未知; 1 - 可用; 2 - 不可用。 |
| details | 数组 | 接口的附加对象。 如果接口 'type'是SNMP，则必选 |
| disable_until | 时间戳 | (只读) 不可用主机接口的下一次轮询时间。 |
| dns (必选) |
字符串 | 接口使用的DNS名称 如果通过IP直接连接，则可以为空。 |
| error | 字符串 | (只读) 主机接口不可用的错误文本。 |
| errors_from | 时间戳 | (只读) 主机接口不可用开始时间。 |
| hostid (必选) |
字符串 | 接口所属的主机ID。 |
| interfaceid | 字符串 | (只读) 接口的ID。 |
| ip (必选) |
字符串 | 接口使用的IP地址。 如果使用DNS域名连接，可以设置为空。 |
| main (必选) |
整型 | 该接口是否在主机上用作默认的接口，在主机上只能将某种类型的一个接口设置为默认值。 可能的值有: 0 - 不是默认; 1 - 默认。 |
| port (必选) |
字符串 | 接口使用的端口号，可以包含用户宏。 |
| type (必选) |
整型 | 接口类型。 可能的值有: 1 - agent; 2 - SNMP; 3 - IPMI; 4 - JMX。 |
| useip (必选) |
整型 | 是否通过IP进行连接。 可能的值有: 0 - 使用主机DNS进行连接; 1 - 使用主机接口的主机IP进行连接。 |
注意，对于某些方法（更新、删除），必需/可选参数组合是不同的。
详细信息标签
详细信息对象具有以下属性。
| 属性 | 类型 | 描述 |
|---|---|---|
| version (必选) |
整型 | SNMP接口版本。 可能的值有: 1 - SNMPv1; 2 - SNMPv2c; 3 - SNMPv3 |
| bulk | 整型 | 是否使用批量的SNMP请求. 可能的值有: 0 - 不使用批量请求; 1 - (默认) - 使用批量请求。 |
| community | 字符串 | SNMP 团体字 (必选)。 仅在SNMPv1和SNMPv2接口中使用。 |
| securityname | 字符串 | SNMPv3 安全名称。仅在SNMPv3接口中使用。 |
| securitylevel | 字符串 | SNMPv3安全级别。 仅在SNMPv3接口中使用。 可能的值有: 0 - (默认) - noAuthNoPriv; 1 - authNoPriv; 2 - authPriv. |
| authpassphrase | 字符串 | SNMPv3身份验证密码。仅在SNMPv3接口中使用。 |
| privpassphrase | string | SNMPv3隐私密码。仅在SNMPv3接口中使用。 |
| authprotocol | integer | SNMPv3身份认证协议。仅在SNMPv3接口中使用。 可能的值有: 0 - (默认) - MD5; 1 - SHA1; 2 - SHA224; 3 - SHA256; 4 - SHA384; 5 - SHA512. |
| privprotocol | 整型 | SNMPv3隐私协议。仅在SNMPv3接口中使用。 可能的值有: 0 - (默认) - DES; 1 - AES128; 2 - AES192; 3 - AES256; 4 - AES192C; 5 - AES256C. |
| contextname | string | SNMPv3上下文名称。仅在SNMPv3接口中使用。 |