# snmp_get

**Descripción**

Realiza una operación SNMP GET para recuperar el valor de un OID especificado.

**Parámetros**

<table border="1" id="bkmrk-nombre-tipo-requerid" style="border-collapse: collapse; width: 100%; height: 377px;"><tbody><tr style="height: 29px;"><td style="width: 25%; height: 29px;">**Nombre**</td><td style="width: 25%; height: 29px;">**Tipo**</td><td style="width: 25%; height: 29px;">**Requerido**</td><td style="width: 25%; height: 29px;">**Descripción**</td></tr><tr><td style="width: 25%;">oid</td><td style="width: 25%;">str</td><td style="width: 25%;">Si</td><td style="width: 25%;">El OID para la operación SNMP GET</td></tr><tr style="height: 29px;"><td style="width: 25%; height: 29px;">host</td><td style="width: 25%; height: 29px;">str</td><td style="width: 25%; height: 29px;">Si</td><td style="width: 25%; height: 29px;">Dirección IP o nombre del dispositivo SNMP</td></tr><tr style="height: 29px;"><td style="width: 25%; height: 29px;">version</td><td style="width: 25%; height: 29px;">int</td><td style="width: 25%; height: 29px;">No</td><td style="width: 25%; height: 29px;">Versión del protocolo SNMP (1, 2 o 3)</td></tr><tr style="height: 29px;"><td style="width: 25%; height: 29px;">community</td><td style="width: 25%; height: 29px;">str</td><td style="width: 25%; height: 29px;">No</td><td style="width: 25%; height: 29px;">Contraseña simple para acceso en SNMPv1/v2c</td></tr><tr style="height: 29px;"><td style="width: 25%; height: 29px;">user</td><td style="width: 25%; height: 29px;">str</td><td style="width: 25%; height: 29px;">Si</td><td style="width: 25%; height: 29px;">Nombre de usuario en SNMPv3</td></tr><tr style="height: 29px;"><td style="width: 25%; height: 29px;">auth\_protocol</td><td style="width: 25%; height: 29px;">str</td><td style="width: 25%; height: 29px;">No</td><td style="width: 25%; height: 29px;">Protocolo de autenticación en SNMPv3 (MD5, SHA, etc.)</td></tr><tr style="height: 29px;"><td style="width: 25%; height: 29px;">auth\_password</td><td style="width: 25%; height: 29px;">str</td><td style="width: 25%; height: 29px;">No</td><td style="width: 25%; height: 29px;">Contraseña de autenticación en SNMPv3</td></tr><tr style="height: 29px;"><td style="width: 25%; height: 29px;">privacy\_protocol</td><td style="width: 25%; height: 29px;">str</td><td style="width: 25%; height: 29px;">No</td><td style="width: 25%; height: 29px;">Protocolo de cifrado en SNMPv3 (DES, AES, etc.)</td></tr><tr style="height: 29px;"><td style="width: 25%; height: 29px;">privacy\_password</td><td style="width: 25%; height: 29px;">str</td><td style="width: 25%; height: 29px;">No</td><td style="width: 25%; height: 29px;">Contraseña de cifrado en SNMPv3</td></tr><tr style="height: 29px;"><td style="width: 25%; height: 29px;">security\_level</td><td style="width: 25%; height: 29px;">str</td><td style="width: 25%; height: 29px;">No</td><td style="width: 25%; height: 29px;">Nivel de seguridad en SNMPv3</td></tr><tr style="height: 29px;"><td style="width: 25%; height: 29px;">timeout</td><td style="width: 25%; height: 29px;">int</td><td style="width: 25%; height: 29px;">No</td><td style="width: 25%; height: 29px;">Tiempo máximo de espera para respuestas SNMP</td></tr><tr style="height: 29px;"><td style="width: 25%; height: 29px;">retries</td><td style="width: 25%; height: 29px;">int</td><td style="width: 25%; height: 29px;">No</td><td style="width: 25%; height: 29px;">Número de intentos en caso de fallo</td></tr><tr style="height: 29px;"><td style="width: 25%; height: 29px;">remote\_port</td><td style="width: 25%; height: 29px;">int</td><td style="width: 25%; height: 29px;">No</td><td style="width: 25%; height: 29px;">Puerto remoto para comunicación SNMP</td></tr></tbody></table>

**Return**

<table border="1" id="bkmrk-tipo-none" style="border-collapse: collapse; width: 100%; height: 58px;"><tbody><tr style="height: 29px;"><td style="width: 50%; height: 29px;">**Tipo**</td><td style="width: 50%; height: 29px;">**Descripción**</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">str</td><td style="width: 50%; height: 29px;">El valor recuperado del OID especificado</td></tr></tbody></table>

 **Versión**

- 1.0.0

**Ejemplo**

```
import PandoraPlugintools as pt

# Set global variables
pt.set_global_variable('hostname', '192.168.1.1')
pt.set_global_variable('version', 2)
pt.set_global_variable('community', 'public')
pt.set_global_variable('timeout', 5)
pt.set_global_variable('retries', 2)
pt.set_global_variable('remote_port', 161)

# Create an SNMP session
session = pt.create_snmp_session()

# Specify the OID for the SNMP GET operation
oid = '1.3.6.1.2.1.1.1.0'

# Perform an SNMP GET operation
value = pt.snmp_get(session, oid)
print('SNMP GET Value:', value)
```