§³§Ý§Ö§Õ§å§ð§ë§Ú§Ö §à§Ò§ì§Ö§Ü§ä§í §ß§Ñ§á§â§ñ§Þ§å§ð §ã§Ó§ñ§Ù§Ñ§ß§í §ã API §á§â§à§ä§à§ä§Ú§á§Ñ §å§Ù§Ý§Ñ §ã§Ö§ä§Ú (hostprototype
).
§°§Ò§ì§Ö§Ü§ä §á§â§à§ä§à§ä§Ú§á§Ñ §å§Ù§Ý§à§Ó §ã§Ö§ä§Ú §Ú§Þ§Ö§Ö§ä §ã§Ý§Ö§Õ§å§ð§ë§Ú§Ö §ã§Ó§à§Û§ã§ä§Ó§Ñ.
§³§Ó§à§Û§ã§ä§Ó§à | §´§Ú§á | §°§á§Ú§ã§Ñ§ß§Ú§Ö |
---|---|---|
hostid | §ã§ä§â§à§Ü§Ñ | (§ä§à§Ý§î§Ü§à §é§ä§Ö§ß§Ú§Ö) ID §á§â§à§ä§à§ä§Ú§á§Ñ §å§Ù§Ý§à§Ó §ã§Ö§ä§Ú. |
host (§ä§â§Ö§Ò§å§Ö§ä§ã§ñ) |
§ã§ä§â§à§Ü§Ñ | §´§Ö§ç§ß§Ú§é§Ö§ã§Ü§à§Ö §Ú§Þ§ñ §á§â§à§ä§à§ä§Ú§á§Ñ §å§Ù§Ý§à§Ó §ã§Ö§ä§Ú. |
name | §ã§ä§â§à§Ü§Ñ | §£§Ú§Õ§Ú§Þ§à§Ö §Ú§Þ§ñ §á§â§à§ä§à§ä§Ú§á§Ñ §å§Ù§Ý§à§Ó §ã§Ö§ä§Ú. §±§à §å§Þ§à§Ý§é§Ñ§ß§Ú§ð: §Ù§ß§Ñ§é§Ö§ß§Ú§Ö §ã§Ó§à§Û§ã§ä§Ó§Ñ host . |
status | §è§Ö§Ý§à§Ö §é§Ú§ã§Ý§à | §³§à§ã§ä§à§ñ§ß§Ú§Ö §á§â§à§ä§à§ä§Ú§á§Ñ §å§Ù§Ý§à§Ó §ã§Ö§ä§Ú. §£§à§Ù§Þ§à§Ø§ß§í§Ö §Ù§ß§Ñ§é§Ö§ß§Ú§ñ: 0 - (§á§à §å§Þ§à§Ý§é§Ñ§ß§Ú§ð) §å§Ù§Ö§Ý §ã§Ö§ä§Ú §á§à§Õ §ß§Ñ§Ò§Ý§ð§Õ§Ö§ß§Ú§Ö§Þ; 1 - §å§Ù§Ö§Ý §ã§Ö§ä§Ú §Ò§Ö§Ù §ß§Ñ§Ò§Ý§ð§Õ§Ö§ß§Ú§ñ. |
templateid | §ã§ä§â§à§Ü§Ñ | (§ä§à§Ý§î§Ü§à §é§ä§Ö§ß§Ú§Ö) ID §â§à§Õ§Ú§ä§Ö§Ý§î§ã§Ü§à§Ô§à §á§â§à§ä§à§ä§Ú§á§Ñ §å§Ù§Ý§à§Ó §ã§Ö§ä§Ú §Ú§Ù §ê§Ñ§Ò§Ý§à§ß§Ñ. |
tls_connect | §è§Ö§Ý§à§Ö §é§Ú§ã§Ý§à | §±§à§Õ§Ü§Ý§ð§é§Ö§ß§Ú§ñ §Ü §å§Ù§Ý§å §ã§Ö§ä§Ú. §£§à§Ù§Þ§à§Ø§ß§í§Ö §Ù§ß§Ñ§é§Ö§ß§Ú§ñ: 1 - (§á§à §å§Þ§à§Ý§é§Ñ§ß§Ú§ð) §¢§Ö§Ù §ê§Ú§æ§â§à§Ó§Ñ§ß§Ú§ñ; 2 - PSK; 4 - §ã§Ö§â§ä§Ú§æ§Ú§Ü§Ñ§ä. |
tls_accept | §è§Ö§Ý§à§Ö §é§Ú§ã§Ý§à | §³§à§Ö§Õ§Ú§ß§Ö§ß§Ú§ñ §ã §å§Ù§Ý§Ñ §ã§Ö§ä§Ú. §£§à§Ù§Þ§à§Õ§ß§í§Ö §Ò§Ú§ä§à§Ó§í§Ö §Ù§ß§Ñ§é§Ö§ß§Ú§ñ: 1 - (§á§à §å§Þ§à§Ý§é§Ñ§ß§Ú§ð) §¢§Ö§Ù §ê§Ú§æ§â§à§Ó§Ñ§ß§Ú§ñ; 2 - PSK; 4 - §ã§Ö§â§ä§Ú§æ§Ú§Ü§Ñ§ä. |
tls_issuer | §ã§ä§â§à§Ü§Ñ | §¿§Þ§Ú§ä§Ö§ß§ä §ã§Ö§â§ä§Ú§æ§Ú§Ü§Ñ§ä§Ñ. |
tls_subject | §ã§ä§â§à§Ü§Ñ | §³§å§Ò§ì§Ö§Ü§ä §ã§Ö§â§ä§Ú§æ§Ú§Ü§Ñ§ä§Ñ. |
tls_psk_identity | §ã§ä§â§à§Ü§Ñ | §ª§Õ§Ö§ß§ä§Ú§æ§Ú§Ü§Ñ§ä§à§â PSK. §´§â§Ö§Ò§å§Ö§ä§ã§ñ, §Ö§ã§Ý§Ú §Ý§Ú§Ò§à §Ó tls_connect , §Ý§Ú§Ò§à §Ó tls_accept §Ó§í§Ò§â§Ñ§ß PSK. |
tls_psk | §ã§ä§â§à§Ü§Ñ | Pre-shared §Ü§Ý§ð§é, §á§à §Ü§â§Ñ§Û§ß§Ö§Û §Þ§Ö§â§Ö 32 §ê§Ö§ã§ä§ß§Ñ§Õ§è§Ñ§ä§Ö§â§Ú§é§ß§í§ç §è§Ú§æ§â§í. §´§â§Ö§Ò§å§Ö§ä§ã§ñ, §Ö§ã§Ý§Ú §Ý§Ú§Ò§à §Ó tls_connect , §Ý§Ú§Ò§à §Ó tls_accept §Ó§í§Ò§â§Ñ§ß PSK. |
§°§Ò§ì§Ö§Ü§ä §ã§à§Ö§Õ§Ú§ß§Ö§ß§Ú§ñ §ã §Ô§â§å§á§á§à§Û §ã§Ó§ñ§Ù§í§Ó§Ñ§Ö§ä §á§â§à§ä§à§ä§Ú§á §å§Ù§Ý§à§Ó §ã§Ö§ä§Ú §ã §Ô§â§å§á§á§à§Û §å§Ù§Ý§à§Ó §ã§Ö§ä§Ú §Ú §Ú§Þ§Ö§Ö§ä §ã§Ý§Ö§Õ§å§ð§ë§Ú§Ö §ã§Ó§à§Û§ã§ä§Ó§Ñ.
§³§Ó§à§Û§ã§ä§Ó§à | §´§Ú§á | §°§á§Ú§ã§Ñ§ß§Ú§Ö |
---|---|---|
groupid (§à§Ò§ñ§Ù§Ñ§ä§Ö§Ý§î§ß§à§Ö) |
§ã§ä§â§à§Ü§Ñ | ID §Ô§â§å§á§á§í §å§Ù§Ý§à§Ó §ã§Ö§ä§Ú. |
§°§Ò§ì§Ö§Ü§ä §á§â§à§ä§à§ä§Ú§á§Ñ §Ô§â§å§á§á§í §à§á§â§Ö§Õ§Ö§Ý§ñ§Ö§ä §Ô§â§å§á§á§å, §Ü§à§ä§à§â§Ñ§ñ §Ò§å§Õ§Ö§ä §ã§à§Ù§Õ§Ñ§ß§Ñ §Õ§Ý§ñ §à§Ò§ß§Ñ§â§å§Ø§Ö§ß§ß§à§Ô§à §å§Ù§Ý§Ñ, §Ú §à§Ò§Ý§Ñ§Õ§Ñ§Ö§ä §ã§Ý§Ö§Õ§å§ð§ë§Ú§Þ§Ú §ã§Ó§à§Û§ã§ä§Ó§Ñ§Þ§Ú.
§³§Ó§à§Û§ã§ä§Ó§à | §´§Ú§á | §°§á§Ú§ã§Ñ§ß§Ú§Ö |
---|---|---|
group_prototypeid | §ã§ä§â§à§Ü§Ñ | (§ä§à§Ý§î§Ü§à §Õ§Ý§ñ §é§ä§Ö§ß§Ú§ñ) ID §á§â§à§ä§à§ä§Ú§á§Ñ §Ô§â§å§á§á§í. |
name (required) |
§ã§ä§â§à§Ü§Ñ | §¯§Ñ§Ù§Ó§Ñ§ß§Ú§Ö §á§â§à§ä§à§ä§Ú§á§Ñ §Ô§â§å§á§á§í. |
hostid | §ã§ä§â§à§Ü§Ñ | (§ä§à§Ý§î§Ü§à §Õ§Ý§ñ §é§ä§Ö§ß§Ú§ñ) ID §á§â§à§ä§à§ä§Ú§á§Ñ §å§Ù§Ý§Ñ §ã§Ö§ä§Ú. |
templateid | §ã§ä§â§à§Ü§Ñ | (§ä§à§Ý§î§Ü§à §Õ§Ý§ñ §é§ä§Ö§ß§Ú§ñ) ID §á§â§à§ä§à§ä§Ú§á§Ñ §Ô§â§å§á§á§í §â§à§Õ§Ú§ä§Ö§Ý§î§ã§Ü§à§Ô§à §ê§Ñ§Ò§Ý§à§ß§Ñ. |
§°§Ò§ì§Ö§Ü§ä §ä§Ö§Ô§Ñ §á§â§à§ä§à§ä§Ú§á§Ñ §å§Ù§Ý§Ñ §ã§Ö§ä§Ú §Ú§Þ§Ö§Ö§ä §ã§Ý§Ö§Õ§å§ð§ë§Ú§Ö §ã§Ó§à§Û§ã§ä§Ó§Ñ.
§³§Ó§à§Û§ã§ä§Ó§à | §´§Ú§á | §°§á§Ú§ã§Ñ§ß§Ú§Ö |
---|---|---|
tag (§à§Ò§ñ§Ù§Ñ§ä§Ö§Ý§î§ß§à§Ö) |
string | §ª§Þ§ñ §ä§Ö§Ô§Ñ §á§â§à§ä§à§ä§Ú§á§Ñ §å§Ù§Ý§Ñ §ã§Ö§ä§Ú. |
value | §ã§ä§â§à§Ü§Ñ | §©§ß§Ñ§é§Ö§ß§Ú§Ö §ä§Ö§Ô§Ñ §á§â§à§ä§à§ä§Ú§á§Ñ §å§Ù§Ý§Ñ §ã§Ö§ä§Ú. |
The custom interface object has the following properties.
Property | Type | Description |
---|---|---|
dns | string | DNS name used by the interface. Required if the connection is made via DNS. Can contain macros. |
ip | string | IP address used by the interface. Required if the connection is made via IP. Can contain macros. |
main (required) |
integer | Whether the interface is used as default on the host. Only one interface of some type can be set as default on a host. Possible values are: 0 - not default; 1 - default. |
port (required) |
string | Port number used by the interface. Can contain user and LLD macros. |
type (required) |
integer | Interface type. Possible values are: 1 - agent; 2 - SNMP; 3 - IPMI; 4 - JMX. |
useip (required) |
integer | Whether the connection should be made via IP. Possible values are: 0 - connect using host DNS name; 1 - connect using host IP address for this host interface. |
details | array | Additional object for interface. Required if interface 'type' is SNMP. |
The details object has the following properties.
Property | Type | Description |
---|---|---|
version (required) |
integer | SNMP interface version. Possible values are: 1 - SNMPv1; 2 - SNMPv2c; 3 - SNMPv3 |
bulk | integer | Whether to use bulk SNMP requests. Possible values are: 0 - don't use bulk requests; 1 - (default) - use bulk requests. |
community | string | SNMP community. Used only by SNMPv1 and SNMPv2 interfaces. |
securityname | string | SNMPv3 security name. Used only by SNMPv3 interfaces. |
securitylevel | integer | SNMPv3 security level. Used only by SNMPv3 interfaces. Possible values are: 0 - (default) - noAuthNoPriv; 1 - authNoPriv; 2 - authPriv. |
authpassphrase | string | SNMPv3 authentication passphrase. Used only by SNMPv3 interfaces. |
privpassphrase | string | SNMPv3 privacy passphrase. Used only by SNMPv3 interfaces. |
authprotocol | integer | SNMPv3 authentication protocol. Used only by SNMPv3 interfaces. Possible values are: 0 - (default) - MD5; 1 - SHA1; 2 - SHA224; 3 - SHA256; 4 - SHA384; 5 - SHA512. |
privprotocol | integer | SNMPv3 privacy protocol. Used only by SNMPv3 interfaces. Possible values are: 0 - (default) - DES; 1 - AES128; 2 - AES192; 3 - AES256; 4 - AES192C; 5 - AES256C. |
contextname | string | SNMPv3 context name. Used only by SNMPv3 interfaces. |