Queryhost - Listing

Valid parameters are:

The remaining parameters for QueryHost depends on the version of SNMP requested.

Version 1 and 2c

The parameters required are:

Version 3

Extra information is required to satify the snmpv3 credentials. These must be added to the call.

Listing interfaces

Output of a list response (NOTE: id => 0 is used to set the default threasholds for all interfaces and is not a ‘real’ interface):

    {
      interfaces => [
        {
          discards_critical => 15,
          discards_warning => "",
          errors_critical => 10,
          errors_warning => "",
          extra_info => "alias:'' speed:'' link:'' status:''",
          id => 0,
          ifAlias => undef,
          ifDescr => "",
          ifLink => undef,
          ifSpeed => undef,
          ifStatus => undef,
          interfacename => "",
          throughput_critical => "0:50%",
          throughput_warning => "",
        },
        {
          discards_critical => "",
          discards_warning => "",
          errors_critical => "",
          errors_warning => "",
          extra_info => "alias:'192.168.13.0 network' speed:'10Mbit/s' link:'up' status:'up'",
          id => 1,
          ifAlias => "192.168.13.0 network",
          ifDescr => "Ethernet0/0",
          ifLink => "up",
          ifSpeed => "10Mbit/s",
          ifStatus => "up",
          interfacename => "Ethernet0/0",
          throughput_critical => "",
          throughput_warning => "",
        },
        {
          discards_critical => "",
          discards_warning => "",
          errors_critical => "",
          errors_warning => "",
          extra_info => "alias:'192.168.21.0 network' speed:'10Mbit/s' link:'down' status:'down'",
          id => 3,
          ifAlias => "192.168.21.0 network",
          ifDescr => "Ethernet0/1",
          ifLink => "down",
          ifSpeed => "10Mbit/s",
          ifStatus => "down",
          interfacename => "Ethernet0/1",
          throughput_critical => "",
          throughput_warning => "",
        },
        {
          discards_critical => "",
          discards_warning => "",
          errors_critical => "",
          errors_warning => "",
          extra_info => "alias:'' speed:'8Gbit/s' link:'up' status:'up'",
          id => 5,
          ifAlias => "",
          ifDescr => "Loopback0",
          ifLink => "up",
          ifSpeed => "8Gbit/s",
          ifStatus => "up",
          interfacename => "Loopback0",
          throughput_critical => "",
          throughput_warning => "",
        },
        {
          discards_critical => "",
          discards_warning => "",
          errors_critical => "",
          errors_warning => "",
          extra_info => "alias:'' speed:'10Gbit/s' link:'up' status:'up'",
          id => 4,
          ifAlias => "",
          ifDescr => "Null0",
          ifLink => "up",
          ifSpeed => "10Gbit/s",
          ifStatus => "up",
          interfacename => "Null0",
          throughput_critical => "",
          throughput_warning => "",
        },
        {
          discards_critical => "",
          discards_warning => "",
          errors_critical => "",
          errors_warning => "",
          extra_info => "alias:'192.168.250.0 network' speed:'2Mbit/s' link:'up' status:'down'",
          id => 2,
          ifAlias => "192.168.250.0 network",
          ifDescr => "Serial0/0",
          ifLink => "up",
          ifSpeed => "2Mbit/s",
          ifStatus => "down",
          interfacename => "Serial0/0",
          throughput_critical => "",
          throughput_warning => "",
        },
        {
          discards_critical => "",
          discards_warning => "",
          errors_critical => "",
          errors_warning => "",
          extra_info => "alias:'' speed:'100Mbit/s' link:'up' status:'up'",
          id => 7,
          ifAlias => "",
          ifDescr => "Virtual-Access1",
          ifLink => "up",
          ifSpeed => "100Mbit/s",
          ifStatus => "up",
          interfacename => "Virtual-Access1",
          throughput_critical => "",
          throughput_warning => "",
        },
        {
          discards_critical => "",
          discards_warning => "",
          errors_critical => "",
          errors_warning => "",
          extra_info => "alias:'' speed:'100Mbit/s' link:'up' status:'down'",
          id => 8,
          ifAlias => "",
          ifDescr => "Virtual-Access2",
          ifLink => "up",
          ifSpeed => "100Mbit/s",
          ifStatus => "down",
          interfacename => "Virtual-Access2",
          throughput_critical => "",
          throughput_warning => "",
        },
        {
          discards_critical => "",
          discards_warning => "",
          errors_critical => "",
          errors_warning => "",
          extra_info => "alias:'' speed:'100Mbit/s' link:'up' status:'down'",
          id => 6,
          ifAlias => "",
          ifDescr => "Virtual-Template1",
          ifLink => "up",
          ifSpeed => "100Mbit/s",
          ifStatus => "down",
          interfacename => "Virtual-Template1",
          throughput_critical => "",
          throughput_warning => "",
        },
      ],
      system_description => "Cisco Internetwork Operating System Software",
    }

Testing connection

    {
        system_description => "Cisco Internetwork Operating System Software",
    }
["Opsview"] ["API", "Technical Reference"]

Was this topic helpful?