Table of Contents
Discovery check object
The following objects are directly related to the dcheck API.
Discovery check
The discovery check object defines a specific check performed by a network discovery rule. It has the following properties.
| Property | Type | Description |
|---|---|---|
| dcheckid | ID | ID of the discovery check. |
| druleid | ID | ID of the discovery rule that the check belongs to. |
| key_ | string | Item key (if type is set to "Áú»¢¶Ä²© agent") or SNMP OID (if type is set to "SNMPv1 agent", "SNMPv2 agent", or "SNMPv3 agent").Property behavior: - required if type is set to "Áú»¢¶Ä²© agent", "SNMPv1 agent", "SNMPv2 agent", or "SNMPv3 agent" |
| ports | string | One or several port ranges to check, separated by commas. Default: 0. Property behavior: - supported if type is set to "SSH" (0), "LDAP" (1), "SMTP" (2), "FTP" (3), "HTTP" (4), "POP" (5), "NNTP" (6), "IMAP" (7), "TCP" (8), "Áú»¢¶Ä²© agent" (9), "SNMPv1 agent" (10), "SNMPv2 agent" (11), "SNMPv3 agent" (13), "HTTPS" (14), or "Telnet" (15) |
| snmp_community | string | SNMP community. Property behavior: - required if type is set to "SNMPv1 agent" or "SNMPv2 agent" |
| snmpv3_authpassphrase | string | Authentication passphrase. Property behavior: - supported if type is set to "SNMPv3 agent" and snmpv3_securitylevel is set to "authNoPriv" or "authPriv" |
| snmpv3_authprotocol | integer | Authentication protocol. Possible values: 0 - (default) MD5; 1 - SHA1; 2 - SHA224; 3 - SHA256; 4 - SHA384; 5 - SHA512. Property behavior: - supported if type is set to "SNMPv3 agent" and snmpv3_securitylevel is set to "authNoPriv" or "authPriv" |
| snmpv3_contextname | string | SNMPv3 context name. Property behavior: - supported if type is set to "SNMPv3 agent" |
| snmpv3_privpassphrase | string | Privacy passphrase. Property behavior: - supported if type is set to "SNMPv3 agent" and snmpv3_securitylevel is set to "authPriv" |
| snmpv3_privprotocol | integer | Privacy protocol. Possible values: 0 - (default) DES; 1 - AES128; 2 - AES192; 3 - AES256; 4 - AES192C; 5 - AES256C. Property behavior: - supported if type is set to "SNMPv3 agent" and snmpv3_securitylevel is set to "authPriv" |
| snmpv3_securitylevel | string | Security level. Possible values: 0 - noAuthNoPriv; 1 - authNoPriv; 2 - authPriv. Property behavior: - supported if type is set to "SNMPv3 agent" |
| snmpv3_securityname | string | Security name. Property behavior: - supported if type is set to "SNMPv3 agent" |
| type | integer | Type of check. Possible values: 0 - SSH; 1 - LDAP; 2 - SMTP; 3 - FTP; 4 - HTTP; 5 - POP; 6 - NNTP; 7 - IMAP; 8 - TCP; 9 - Áú»¢¶Ä²© agent; 10 - SNMPv1 agent; 11 - SNMPv2 agent; 12 - ICMP ping; 13 - SNMPv3 agent; 14 - HTTPS; 15 - Telnet. Property behavior: - required |
| uniq | integer | Whether to use this check as a device uniqueness criteria. Only a single unique check can be configured for a discovery rule. Possible values: 0 - (default) do not use this check as a uniqueness criteria; 1 - use this check as a uniqueness criteria. Property behavior: - supported if type is set to "Áú»¢¶Ä²© agent", "SNMPv1 agent", "SNMPv2 agent", or "SNMPv3 agent" |
| host_source | integer | Source for host name. Possible values: 1 - (default) DNS; 2 - IP; 3 - discovery value of this check. |
| name_source | integer | Source for visible name. Possible values: 0 - (default) not specified; 1 - DNS; 2 - IP; 3 - discovery value of this check. |
| allow_redirect | integer | Allow situation where the target being ICMP pinged responds from a different IP address. Possible values: 0 - (default) treat redirected responses as if the target host is down (fail); 1 - treat redirected responses as if the target host is up (success). Property behavior: - supported if type is set to "ICMP ping" |