ansible.builtin.snmp_facts (v2.9.27) — module

Install Ansible via pip

Install with pip install ansible==2.9.27

Description

Retrieve facts for a device using SNMP, the facts will be inserted to the ansible_facts key.

Requirements

• pysnmp

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Gather facts with SNMP version 2
  snmp_facts:
    host: '{{ inventory_hostname }}'
    version: v2c
    community: public
  delegate_to: local

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Gather facts using SNMP version 3
  snmp_facts:
    host: '{{ inventory_hostname }}'
    version: v3
    level: authPriv
    integrity: sha
    privacy: aes
    username: snmp-user
    authkey: abc12345
    privkey: def6789
  delegate_to: localhost

Inputs

    
host:
    description:
    - Set to target snmp server (normally C({{ inventory_hostname }})).
    required: true
    type: str

level:
    choices:
    - authNoPriv
    - authPriv
    description:
    - Authentication level.
    - Required if version is v3.
    type: str

authkey:
    description:
    - Authentication key.
    - Required if version is v3.
    type: str

privacy:
    choices:
    - aes
    - des
    description:
    - Encryption algorithm.
    - Required if level is authPriv.
    type: str

privkey:
    description:
    - Encryption key.
    - Required if version is authPriv.
    type: str

version:
    choices:
    - v2
    - v2c
    - v3
    description:
    - SNMP Version to use, v2/v2c or v3.
    required: true
    type: str

username:
    description:
    - Username for SNMPv3.
    - Required if version is v3.
    type: str

community:
    description:
    - The SNMP community string, required if version is v2/v2c.
    type: str

integrity:
    choices:
    - md5
    - sha
    description:
    - Hashing algorithm.
    - Required if version is v3.
    type: str

Outputs

ansible_all_ipv4_addresses:
  description: List of all IPv4 addresses.
  returned: success
  sample:
  - 127.0.0.1
  - 172.17.0.1
  type: list
ansible_interfaces:
  description: Dictionary of each network interface and its metadata.
  returned: success
  sample:
    '1':
      adminstatus: up
      description: ''
      ifindex: '1'
      ipv4:
      - address: 127.0.0.1
        netmask: 255.0.0.0
      mac: ''
      mtu: '65536'
      name: lo
      operstatus: up
      speed: '65536'
    '2':
      adminstatus: up
      description: ''
      ifindex: '2'
      ipv4:
      - address: 192.168.213.128
        netmask: 255.255.255.0
      mac: 000a305a52a1
      mtu: '1500'
      name: Intel Corporation 82545EM Gigabit Ethernet Controller (Copper)
      operstatus: up
      speed: '1500'
  type: dict
ansible_syscontact:
  description: The textual identification of the contact person for this managed node,
    together with information on how to contact this person.
  returned: success
  sample: Me <me@example.org>
  type: str
ansible_sysdescr:
  description: A textual description of the entity.
  returned: success
  sample: Linux ubuntu-user 4.4.0-93-generic
  type: str
ansible_syslocation:
  description: The physical location of this node (e.g., `telephone closet, 3rd floor').
  returned: success
  sample: Sitting on the Dock of the Bay
  type: str
ansible_sysname:
  description: An administratively-assigned name for this managed node.
  returned: success
  sample: ubuntu-user
  type: str
ansible_sysobjectid:
  description: The vendor's authoritative identification of the network management
    subsystem contained in the entity.
  returned: success
  sample: 1.3.6.1.4.1.8072.3.2.10
  type: str
ansible_sysuptime:
  description: The time (in hundredths of a second) since the network management portion
    of the system was last re-initialized.
  returned: success
  sample: 42388
  type: int