# Table operations

## GET table row

Send SNMP GET request using the following options:

- with SNMPv3, user ‘usr-none-none’, no authentication, no privacy

- over IPv4/UDP

- to an Agent at demo.snmplabs.com:161

- for IF-MIB::ifInOctets.1 and IF-MIB::ifOutOctets.1 MIB object

- perform response OIDs and values resolution at MIB

Functionally similar to:

$ snmpget -v3 -l authPriv -u usr-md5-des -A authkey1 -X privkey1 demo.snmplabs.com IF-MIB::ifInOctets.1 IF-MIB::ifOutOctets.1

    from pysnmp.hlapi import *

    errorIndication, errorStatus, errorIndex, varBinds = next(
        getCmd(SnmpEngine(),
               UsmUserData('usr-none-none'),
               UdpTransportTarget(('demo.snmplabs.com', 161)),
               ContextData(),
               ObjectType(ObjectIdentity('IF-MIB', 'ifInOctets', 1)),
               ObjectType(ObjectIdentity('IF-MIB', 'ifOutOctets', 1)))
    )

    if errorIndication:
        print(errorIndication)
    elif errorStatus:
        print('%s at %s' % (errorStatus.prettyPrint(),
                            errorIndex and varBinds[int(errorIndex) - 1][0] or '?'))
    else:
        for varBind in varBinds:
            print(' = '.join([x.prettyPrint() for x in varBind]))

`Download` script.

## Fetch table row by composite index

Send SNMP GET request using the following options:

- with SNMPv3, user ‘usr-sha-aes128’, SHA auth, AES128 privacy

- over IPv4/UDP

- to an Agent at demo.snmplabs.com:161

- for TCP-MIB::tcpConnLocalAddress.”0.0.0.0”.22.”0.0.0.0”.0 MIB object

Functionally similar to:

$ snmpget -v3 -l authPriv -u usr-md5-des -A authkey1 -X privkey1 -a SHA -x AES demo.snmplabs.com TCP-MIB::tcpConnLocalAddress.”0.0.0.0”.22.”0.0.0.0”.0

    from pysnmp.hlapi import *

    errorIndication, errorStatus, errorIndex, varBinds = next(
        getCmd(SnmpEngine(),
               UsmUserData('usr-sha-aes128', 'authkey1', 'privkey1',
                           authProtocol=usmHMACSHAAuthProtocol,
                           privProtocol=usmAesCfb128Protocol),
               UdpTransportTarget(('demo.snmplabs.com', 161)),
               ContextData(),
               ObjectType(ObjectIdentity('TCP-MIB',
                                         'tcpConnLocalAddress',
                                         '0.0.0.0', 22,
                                         '0.0.0.0', 0)))
    )

    if errorIndication:
        print(errorIndication)
    elif errorStatus:
        print('%s at %s' % (errorStatus.prettyPrint(),
                            errorIndex and varBinds[int(errorIndex) - 1][0] or '?'))
    else:
        for varBind in varBinds:
            print(' = '.join([x.prettyPrint() for x in varBind]))

`Download` script.

## Fetch scalar and table variables

Send a series of SNMP GETBULK requests using the following options:

- with SNMPv3 with user ‘usr-md5-des’, MD5 auth and DES privacy protocols

- over IPv6/UDP

- to an Agent at [::1]:161

- with values non-repeaters = 1, max-repetitions = 25

- for IP-MIB::ipAdEntAddr and all columns of the IF-MIB::ifEntry table

- stop when response OIDs leave the scopes of the table

Functionally similar to:

$ snmpbulkwalk -v3 -lauthPriv -u usr-md5-des -A authkey1 -X privkey1 -Cn1, -Cr25 demo.snmplabs.com IP-MIB::ipAdEntAddr IP-MIB::ipAddrEntry

    from pysnmp.hlapi import *

    for (errorIndication,
         errorStatus,
         errorIndex,
         varBinds) in bulkCmd(SnmpEngine(),
                              UsmUserData('usr-md5-des', 'authkey1', 'privkey1'),
                              Udp6TransportTarget(('::1', 161)),
                              ContextData(),
                              1, 25,
                              ObjectType(ObjectIdentity('IP-MIB', 'ipAdEntAddr')),
                              ObjectType(ObjectIdentity('IP-MIB', 'ipAddrEntry')),
                              lexicographicMode=False):

        if errorIndication:
            print(errorIndication)
            break
        elif errorStatus:
            print('%s at %s' % (errorStatus.prettyPrint(),
                                errorIndex and varBinds[int(errorIndex) - 1][0] or '?'))
            break
        else:
            for varBind in varBinds:
                print(' = '.join([x.prettyPrint() for x in varBind]))

`Download` script.

## Fetch whole SNMP table

Send a series of SNMP GETNEXT requests using the following options:

- with SNMPv1, community ‘public’

- over IPv4/UDP

- to an Agent at demo.snmplabs.com:161

- for some columns of the IF-MIB::ifEntry table

- stop when response OIDs leave the scopes of initial OIDs

Functionally similar to:

$ snmpwalk -v1 -c public demo.snmplabs.com IF-MIB::ifDescr IF-MIB::ifType IF-MIB::ifMtu IF-MIB::ifSpeed IF-MIB::ifPhysAddress IF-MIB::ifType

    from pysnmp.hlapi import *

    for (errorIndication,
         errorStatus,
         errorIndex,
         varBinds) in nextCmd(SnmpEngine(),
                              CommunityData('public', mpModel=0),
                              UdpTransportTarget(('demo.snmplabs.com', 161)),
                              ContextData(),
                              ObjectType(ObjectIdentity('IF-MIB', 'ifDescr')),
                              ObjectType(ObjectIdentity('IF-MIB', 'ifType')),
                              ObjectType(ObjectIdentity('IF-MIB', 'ifMtu')),
                              ObjectType(ObjectIdentity('IF-MIB', 'ifSpeed')),
                              ObjectType(ObjectIdentity('IF-MIB', 'ifPhysAddress')),
                              ObjectType(ObjectIdentity('IF-MIB', 'ifType')),
                              lexicographicMode=False):

        if errorIndication:
            print(errorIndication)
            break
        elif errorStatus:
            print('%s at %s' % (errorStatus.prettyPrint(),
                                errorIndex and varBinds[int(errorIndex)-1][0] or '?'))
            break
        else:
            for varBind in varBinds:
                print(' = '.join([x.prettyPrint() for x in varBind]))

`Download` script.

See also: library reference.