You are reading an unmaintained version of the Ansible documentation. Unmaintained Ansible versions can contain unfixed security vulnerabilities (CVE). Please upgrade to a maintained version. See the latest Ansible documentation.

junipernetworks.junos.junos_snmp_server module – Manage SNMP server configuration on Junos devices.

Note

This module is part of the junipernetworks.junos collection (version 2.10.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install junipernetworks.junos.

To use it in a playbook, specify: junipernetworks.junos.junos_snmp_server.

New in version 2.9.0: of junipernetworks.junos

Synopsis

• This module manages SNMP server configuration on devices running Junos.

Note

This module has a corresponding action plugin.

Requirements

The below requirements are needed on the host that executes this module.

• ncclient (>=v0.6.4)

• xmltodict (>=0.12.0)

Parameters

Parameter	Comments
config dictionary	A dictionary of SNMP server configuration.
arp dictionary	Specify JVision arp setting.
host_name_resolution boolean	Enable host name resolution. Choices: no yes
set boolean	Set JVision arp. Choices: no yes
client_lists list / elements=dictionary	Specify client list.
addresses list / elements=dictionary	Specify list of addresses/prefixes.
address string	Specify address or prefix.
restrict boolean	Deny access. Choices: no yes
name string	Specify client list name.
communities list / elements=dictionary	Specify list of community string.
authorization string	Specify Authorization type. Choices: read-only read-write
client_list_name string	Specify the name of client list or prefix list.
clients list / elements=dictionary	Specify List of source address prefix ranges to accept.
address string	Specify address or prefix.
restrict boolean	Deny access. Choices: no yes
logical_system list / elements=string	Use logical-system name for v1/v2c clients.
name string	Specify name of the community.
routing_instances list / elements=dictionary	Use routing-instance name for v1/v2c clients.
client_list_name string	Specify the name of client list or prefix list.
clients list / elements=dictionary	Specify List of source address prefix ranges to accept.
address string	Specify address or prefix.
restrict boolean	Deny access. Choices: no yes
name string	Specify routing-instances.
view string	Specify view name.
contact string	Specify contact information for administrator.
customization dictionary	Customize SNMP behaviour based on knob.
ether_stats_ifd_only boolean	To stop exposing IFLs as part of etherStatsTable. Choices: no yes
description string	System description.
engine_id dictionary	Specify SNMPv3 engine ID
local string	Local engine ID.
use_default_ip_address boolean	Use default IP address for the engine ID. Choices: no yes
use_mac_address boolean	Uses management interface MAC Address for the engine ID. Choices: no yes
filter_duplicates boolean	Filter requests with duplicate source address/port and request ID. Choices: no yes
filter_interfaces dictionary	List of interfaces that needs to be filtered.
all_internal_interfaces boolean	Filter all internal interfaces. Choices: no yes
interfaces list / elements=string	Specify filter specified interfaces.
set boolean	Set filter-interfaces. Choices: no yes
health_monitor dictionary	Specify health monitoring configuration.
falling_threshold integer	Falling threshold applied to all monitored objects.
idp boolean	IDP health monitor configuration. Choices: no yes
interval integer	Interval between samples.
rising_threshold integer	Rising threshold applied to all monitored objects.
set boolean	Set health-monitor configuration. Choices: no yes
if_count_with_filter_interfaces boolean	Filter interfaces config for ifNumber and ipv6Interfaces. Choices: no yes
interfaces list / elements=string	Restrict SNMP requests to interfaces.
location string	Specify physical location of system.
logical_system_trap_filter boolean	Allow only logical-system specific traps. Choices: no yes
name string	System name override.
nonvolatile dictionary	Configure the handling of nonvolatile SNMP Set requests.
commit_delay integer	Delay between affirmative SNMP Set reply and start of commit (seconds).
proxies list / elements=dictionary	SNMP proxy configuration.
device_name string	Satellite/Proxied Device name or IP address.
logical_system list / elements=string	Use logical-system name for v1/v2c clients.
name string	Specify proxy name.
routing_instances list / elements=dictionary	Use routing-instance name for v1/v2c clients.
client_list_name string	Specify the name of client list or prefix list.
clients list / elements=dictionary	Specify List of source address prefix ranges to accept.
address string	Specify address or prefix.
restrict boolean	Deny access. Choices: no yes
name string	Specify routing-instances.
version_v1 dictionary	Specify For v1 proxy configuration define snmp-community.
no_default_comm_to_v3_config boolean	Specify No default snmp-community and v3 configuration. Choices: no yes
snmp_community string	Specify community name.
version_v2c dictionary	For v2c proxy configuration define snmp-community.
no_default_comm_to_v3_config boolean	Specify No default snmp-community and v3 configuration. Choices: no yes
snmp_community string	Specify community name.
version_v3 dictionary	For v3 proxy configuration define security-name.
context boolean	pecify context name associated to this security-name. Choices: no yes
security_name string	Specify v3 security-name.
rmon dictionary	Specify Remote Monitoring configuration.
alarms list / elements=dictionary	RMON alarm entries.
description string	General description of alarm (stored in alarmOwner).
falling_event_index integer	Event triggered after falling threshold is crossed.
falling_threshold integer	Specify falling-threshold.
falling_threshold_interval integer	Interval between samples during falling-threshold test.
id string	Specify alarm ID.
interval integer	Interval between samples.
request_type string	Type of SNMP request to issue for alarm. Choices: get-next-request get-request walk-request
rising_event_index integer	Event triggered after rising threshold is crossed.
rising_threshold integer	The rising threshold.
sample_type string	Method of sampling the selected variable. Choices: absolute-value delta-value
startup_alarm string	The alarm that may be sent upon entry startup. Choices: falling-alarm rising-alarm rising-or-falling-alarm
syslog_subtag string	Tag to be added to syslog messages.
variable string	OID of MIB variable to be monitored.
events list / elements=dictionary	RMON event entries.
community string	The community (trap group) for outgoing traps.
description string	General description of event.
id integer	Specify event ID.
type string	The type of notification for this event. Choices: log log-and-trap none snmptrap
set boolean	Set Remote monitoring configuration. Choices: no yes
routing_instance_access dictionary	SNMP routing-instance options.
access_lists list / elements=string	Allow/Deny SNMP access to routing-instances.
set boolean	Set routing_instance_access. Choices: no yes
snmp_v3 dictionary	SNMPv3 configuration information.
notify list / elements=dictionary	Used to select management targets for notifications as well as the type of notifications.
name string	Specify notify name.
tag string	Notifications will be sent to all targets configured with this tag.
type string	Notification type.
notify_filter list / elements=dictionary	Filters to apply to SNMP notifications.
name string	Specify notify filter name.
oids list / elements=dictionary	OID to include/exclude from notify filter.
exclude boolean	Exclude this OID from the notify filtered. Choices: no yes
include boolean	Include this OID in the notify filter. Choices: no yes
oid string	Specify OID.
snmp_community list / elements=dictionary	SNMP community and view-based access control model configuration.
community_index string	Unique index value in this community table entry.
community_name string	SNMPv1/v2c community name (default is same as community-index).
context string	Context used when performing access control.
security_name string	Security name used when performing access control.
tag string	Tag identifier for set of targets allowed to use this community string.
target_addresses list / elements=dictionary	Identifies notification targets as well as allowed management stations.
address string	SNMP target address.
address_mask string	Mask range of addresses for community string access control.
logical_system string	Logical-system name for trap destination.
name string	SNMP target address name.
port integer	SNMP target port number.
retry_count integer	Maximum retry count for confirmed SNMP notifications.
routing_instance string	Routing instance for trap destination.
tag_list string	SNMP tag list used to select target addresses.
target_parameters string	SNMPv3 target parameter name in the target parameters table.
timeout integer	Acknowledgment timeout for confirmed SNMP notifications (seconds).
target_parameters list / elements=dictionary	SNMPv3 target parameter name in the target parameters table.
name string	SNMPv3 target parameters name.
notify_filter string	Notify filter with filter name to apply to notifications.
parameters dictionary	Parameters used when sending notifications.
message_processing_model string	The message processing model to be used when generating SNMP notifications. Choices: v1 v2c v3
security_level string	Security-level used when generating SNMP notifications. Choices: authentication none privacy
security_model string	Security-model used when generating SNMP notifications. Choices: usm v1 v2c
security_name string	Security name used when generating SNMP notifications.
usm dictionary	User-based security model (USM) information.
local_engine dictionary	Local engine user configuration.
users list / elements=dictionary	SNMPv3 USM user information.
authentication_md5 dictionary	Configure MD5 authentication.
key string	Encrypted key used for user authentication.
password string	User’s authentication password
authentication_none boolean	Set no authentication for the user. Choices: no yes
authentication_sha dictionary	Configure SHA authentication.
key string	Encrypted key used for user authentication.
password string	User’s authentication password
name string	User name.
privacy_3des dictionary	Configure Triple DES privacy.
key string	Encrypted key used for user privacy.
password string	User’s privacy password
privacy_aes128 dictionary	Configure AES128 privacy.
key string	Encrypted key used for user privacy.
password string	User’s privacy password
privacy_des dictionary	Configure DES privacy.
key string	Encrypted key used for user privacy.
password string	User’s privacy password
privacy_none boolean	Set no privacy for the user. Choices: no yes
remote_engine list / elements=dictionary	Remote engine user configuration.
id string	Remote engine id.
users list / elements=dictionary	SNMPv3 USM user information.
authentication_md5 dictionary	Configure MD5 authentication.
key string	Encrypted key used for user authentication.
password string	User’s authentication password
authentication_none boolean	Set no authentication for the user. Choices: no yes
authentication_sha dictionary	Configure SHA authentication.
key string	Encrypted key used for user authentication.
password string	User’s authentication password
name string	User name.
privacy_3des dictionary	Configure Triple DES privacy.
key string	Encrypted key used for user privacy.
password string	User’s privacy password
privacy_aes128 dictionary	Configure AES128 privacy.
key string	Encrypted key used for user privacy.
password string	User’s privacy password
privacy_des dictionary	Configure DES privacy.
key string	Encrypted key used for user privacy.
password string	User’s privacy password
privacy_none boolean	Set no privacy for the user. Choices: no yes
subagent dictionary	SNMP subagent configuration.
tcp dictionary	Allow SNMP subagent tcp connection.
routing_instances_default boolean	Specify routing-instance name for tcp connection. Choices: no yes
set boolean	Set SNMP subagent TCP. Choices: no yes
traceoptions dictionary	Configure trace options for SNMP.
file dictionary	Specify trace file options.
files integer	Specify maximum number of trace files.
match string	Regular expression for lines to be logged.
no_world_readable boolean	Don’t allow any user to read the log file. Choices: no yes
size integer	Specify maximum trace file size.
world_readable boolean	Allow any user to read the log file. Choices: no yes
flag dictionary	Specify flag traceoptions.
all boolean	Trace everything. Choices: no yes
general boolean	Trace general events. Choices: no yes
interface_stats boolean	Trace interface statistics (logical and physical). Choices: no yes
nonvolatile_sets boolean	Nonvolatile SNMP set request handling. Choices: no yes
pdu boolean	Dump SNMP request/response packets. Choices: no yes
protocol_timeouts boolean	Trace SNMP request timeouts. Choices: no yes
routing_socket boolean	Trace routing socket calls. Choices: no yes
subagent boolean	Trace master-agent interations with sub-agents. Choices: no yes
timer boolean	Trace internal timer events. Choices: no yes
varbind_error boolean	Trace varbind errors. Choices: no yes
memory_trace dictionary	Memory tracing information.
set boolean	set memory traceoptions. Choices: no yes
size integer	Specify Memory size reserved for tracing.
no_remote_trace boolean	Disable remote tracing. Choices: no yes
trap_groups list / elements=dictionary	Specify SNMP trap options.
categories dictionary	Specify Trap categories.
authentication boolean	Specify Authentication failures. Choices: no yes
chassis boolean	Specify Chassis or environment notifications. Choices: no yes
chassis_cluster boolean	Specify Clustering notifications. Choices: no yes
configuration boolean	Configuration notifications. Choices: no yes
dot3oam_events boolean	Specify 802.3ah notifications. Choices: no yes
link boolean	Link up-down transitions. Choices: no yes
otn_alarms dictionary	OTN alarm trap subcategories.
oc_lof boolean	Loss of frame alarm notifications. Choices: no yes
oc_lom boolean	Loss of multiframe alarm notification. Choices: no yes
oc_los boolean	Loss of signal alarm notification. Choices: no yes
odu_ais boolean	ODU Alarm indication signal alarm notification. Choices: no yes
odu_bbe_threshold boolean	ODU Background block error threshold alarm notification. Choices: no yes
odu_bdi boolean	ODU Backward defect indication alarm notification. Choices: no yes
odu_bdodu_es_threshold boolean	ODU Errored Second threshold alarm notification. Choices: no yes
odu_lck boolean	ODU Locked alarm notification. Choices: no yes
odu_oci boolean	ODU Open connection indicator alarm notifications. Choices: no yes
odu_rx_aps_change boolean	ODU Receive APS change notifications. Choices: no yes
odu_sd boolean	ODU Signal degrade alarm notifications. Choices: no yes
odu_ses_threshold boolean	ODU Severely Errored Second threshold alarm notification. Choices: no yes
odu_sf boolean	ODU Signal fail alarm notification. Choices: no yes
odu_ttim boolean	ODU Trace identification mismatch alarm notification. Choices: no yes
odu_uas_threshold boolean	ODU Unavailable Second threshold alarm notification. Choices: no yes
opu_ptm boolean	ODU Payload Type Mismatch alarm notification. Choices: no yes
otu_ais boolean	OTU Alarm indication signal alarm notification. Choices: no yes
otu_bbe_threshold boolean	OTU Background block error threshold alarm notification. Choices: no yes
otu_bdi boolean	OTU Backward defect indication alarm notification. Choices: no yes
otu_es_threshold boolean	OTU Errored Second threshold alarm notification. Choices: no yes
otu_fec_deg boolean	OTU Fec degraded errors alarm notification. Choices: no yes
otu_fec_exe boolean	OTU Fec excessive errors alarm notification. Choices: no yes
otu_iae boolean	OTU Incoming alignment error alarm notification. Choices: no yes
otu_sd boolean	OTU Signal degrade alarm notification. Choices: no yes
otu_ses_threshold boolean	OTU Severely Errored Second threshold alarm notification. Choices: no yes
otu_sf boolean	OTU Signal fail alarm notification. Choices: no yes
otu_ttim boolean	OTU Trace identification mismatch alarm notification. Choices: no yes
otu_uas_threshold boolean	OTU Unavailable Second threshold alarm notification. Choices: no yes
set boolean	Set otn_alarms. Choices: no yes
wavelength_lock boolean	Wavelength lock alarm notification. Choices: no yes
remote_operations boolean	Remote operations. Choices: no yes
rmon_alarm boolean	RMON rising and falling alarms. Choices: no yes
routing boolean	Routing protocol notifications. Choices: no yes
services boolean	Services notifications. Choices: no yes
startup boolean	System warm and cold starts. Choices: no yes
vrrp_events boolean	VRRP notifications. Choices: no yes
destination_port integer	SNMP trap receiver port number
logical_system list / elements=string	Use logical-system name for v1/v2c clients.
name string	Specify trap group name.
routing_instance string	Routing instance for trap destination.
targets list / elements=string	Targets for trap messages
version string	SNMP version. Choices: all v1 v2
trap_options dictionary	SNMP trap options.
agent_address dictionary	Agent address for v1 trap PDUs.
outgoing_interface boolean	Use address on outgoing interfaces. Choices: no yes
context_oid boolean	Add context oid in varbind of all traps at the end. Choices: no yes
enterprise_oid boolean	Add snmpTrapEnterprise oid in varbind of all traps. Choices: no yes
logical_system list / elements=string	Use logical-system name for v1/v2c clients.
routing_instance string	Specify routing-instance.
set boolean	Set trap options. Choices: no yes
source_address dictionary	IPv4/IPv6 source address for trap PDUs.
address string	Use specified address.
lowest_loopback boolean	Use lowest address on loopback interfaces. Choices: no yes
views list / elements=dictionary	Define MIB views.
name string	MIB view name.
oids list / elements=dictionary	OID include/exclude list
exclude boolean	Exclude this OID from the view. Choices: no yes
include boolean	Include this OID from the view. Choices: no yes
oid string	OID to include or exclude from view.
running_config string	This option is used only with state parsed. The value of this option should be the output received from the Junos device by executing the command show system snmp. The state parsed reads the configuration from running_config option and transforms it into Ansible structured data as per the resource module’s argspec and the value is then returned in the parsed key within the result.
state string	The state the configuration should be left in. Refer to examples for more details. Choices: merged ← (default) replaced deleted overridden parsed gathered rendered

Notes

Note

• This module requires the netconf system service be enabled on the device being managed.

• This module works with connection netconf.

• See the Junos OS Platform Options.

• Tested against JunOS v18.4R1

Examples

# Using merged
#
# Before state
# ------------
#
# vagrant@vsrx# show routing-instances
# clv1 {
#     description clv1;
# }
# clv2 {
#     description clv2;
# }
- name: Merge provided SNMP configuration into running configuration.
  junipernetworks.junos.junos_snmp_server:
    config:
      arp:
        set: true
        host_name_resolution: true
      client_lists:   # ATTR-----2
         - name: cl1
           addresses:
             - address: "192.16.1.0/24"
             - address: "192.16.2.0/24"
             - address: "11.11.11.11"
               restrict: true
         - name: cl2
           addresses:
             - address: "192.16.4.0/24"
      routing_instance_access:  # ATTR-----3
        set: true
        access_lists:
          - "clv1"
          - "clv2"
    state: merged
#
# -------------------------
# Module Execution Result
# -------------------------
#     "after": {
#         "arp": {
#             "host_name_resolution": true
#         },
#         "client_lists": [
#             {
#                 "addresses": [
#                     {
#                         "address": "192.16.1.0/24"
#                     },
#                     {
#                         "address": "192.16.2.0/24"
#                     },
#                     {
#                         "address": "11.11.11.11/32",
#                         "restrict": true
#                     }
#                 ],
#                 "name": "cl1"
#             },
#             {
#                 "addresses": [
#                     {
#                         "address": "192.16.4.0/24"
#                     }
#                 ],
#                 "name": "cl2"
#             }
#         ],
#         "routing_instance_access": {
#             "access_lists": [
#                 "clv1",
#                 "clv2"
#             ]
#         }
#     },
#     "before": {},
#     "changed": true,
#     "commands": [
#           "<nc:snmp xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0">"
#           "<nc:arp><nc:host-name-resolution/></nc:arp><nc:client-list><nc:name>cl1</nc:name>"
#           "<nc:client-address-list><nc:name>192.16.1.0/24</nc:name></nc:client-address-list>"
#           "<nc:client-address-list><nc:name>192.16.2.0/24</nc:name></nc:client-address-list><nc:client-address-list>"
#           "<nc:name>11.11.11.11</nc:name><nc:restrict/></nc:client-address-list></nc:client-list><nc:client-list>"
#           "<nc:name>cl2</nc:name><nc:client-address-list><nc:name>192.16.4.0/24</nc:name></nc:client-address-list>"
#           "</nc:client-list><nc:routing-instance-access><nc:access-list><nc:name>clv1</nc:name></nc:access-list>"
#           "<nc:access-list><nc:name>clv2</nc:name></nc:access-list></nc:routing-instance-access></nc:snmp>"
#     ]
# After state
# -----------
#
# vagrant@vsrx# show snmp
# client-list cl1 {
#     192.16.1.0/24;
#     192.16.2.0/24;
#     11.11.11.11/32 {
#         restrict;
#     }
# }
# client-list cl2 {
#     192.16.4.0/24;
# }
# routing-instance-access {
#     access-list {
#         clv1;
#         clv2;
#     }
# }
# arp {
#     host-name-resolution;
# }
# vagrant@vsrx# show routing-instances
# clv1 {
#     description clv1;
# }
# clv2 {
#     description clv2;
# }
#
# Using Replaced
# Before state
# ------------
#
# vagrant@vsrx# show snmp
# client-list cl1 {
#     192.16.1.0/24;
#     192.16.2.0/24;
#     11.11.11.11/32 {
#         restrict;
#     }
# }
# client-list cl2 {
#     192.16.4.0/24;
# }
# routing-instance-access {
#     access-list {
#         clv1;
#         clv2;
#     }
# }
# arp {
#     host-name-resolution;
# }
# vagrant@vsrx# show routing-instances
# clv1 {
#     description clv1;
# }
# clv2 {
#     description clv2;
# }

- name: Replaced running SNMP server configuration with provided configuration
  junipernetworks.junos.junos_snmp_server:
    config:
      contact: "[email protected]"
      customization:
        ether_stats_ifd_only: True
      description: "Local SNMP Server"
      engine_id:
        local: "local1"
        use_default_ip_address: True
        use_mac_address: True
      filter_duplicates: True
      filter_interfaces:
        set: True
        all_internal_interfaces: True
        interfaces:
          - "eth1"
          - "eth2"
    state: replaced
#
# -------------------------
# Module Execution Result
# -------------------------
#     "after": {
#         "contact": "[email protected]",
#         "customization": {
#             "ether_stats_ifd_only": true
#         },
#         "description": "Local SNMP Server",
#         "engine_id": {
#             "use_mac_address": true
#         },
#         "filter_duplicates": true,
#         "filter_interfaces": {
#             "all_internal_interfaces": true,
#             "interfaces": [
#                 "eth1",
#                 "eth2"
#             ]
#         }
#     },
#     "before":
#      {
#         "arp": {
#             "host_name_resolution": true
#         },
#         "client_lists": [
#             {
#                 "addresses": [
#                     {
#                         "address": "192.16.1.0/24"
#                     },
#                     {
#                         "address": "192.16.2.0/24"
#                     },
#                     {
#                         "address": "11.11.11.11/32",
#                         "restrict": true
#                     }
#                 ],
#                 "name": "cl1"
#             },
#             {
#                 "addresses": [
#                     {
#                         "address": "192.16.4.0/24"
#                     }
#                 ],
#                 "name": "cl2"
#             }
#         ],
#         "routing_instance_access": {
#             "access_lists": [
#                 "clv1",
#                 "clv2"
#             ]
#         }
#     },
#     "changed": true,
#     "commands": [
#         "<nc:snmp xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0"/>",
#         "<nc:snmp xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0" delete="delete"/>",
#         "<nc:snmp xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0">"
#         "<nc:contact>[email protected]</nc:contact><nc:customization>"
#         "<nc:ether-stats-ifd-only/></nc:customization><nc:description>Local SNMP Server</nc:description>"
#         "<nc:engine-id><nc:local>local1</nc:local><nc:use-default-ip-address/><nc:use-mac-address/>"
#         "</nc:engine-id><nc:filter-duplicates/><nc:filter-interfaces><nc:all-internal-interfaces/><nc:interfaces>"
#         "<nc:name>eth1</nc:name></nc:interfaces><nc:interfaces><nc:name>eth2</nc:name></nc:interfaces>"
#         "</nc:filter-interfaces></nc:snmp>"
#     ]
# After state
# -----------
#
# vagrant@vsrx# show routing-instances
# clv1 {
#     description clv1;
# }
# clv2 {
#     description clv2;
# }
# vagrant@vsrx# show snmp
# description "Local SNMP Server";
# contact "[email protected]";
# filter-interfaces {
#     interfaces {
#         eth1;
#         eth2;
#     }
#     all-internal-interfaces;
# }
# filter-duplicates;
# engine-id {
#     use-mac-address;
# }
# customization {
#     ether-stats-ifd-only;
# }

# Using overridden
#
# Before state
# ------------
#
# vagrant@vsrx# show snmp
# client-list cl1 {
#     192.16.1.0/24;
#     192.16.2.0/24;
#     11.11.11.11/32 {
#         restrict;
#     }
# }
# client-list cl2 {
#     192.16.4.0/24;
# }
# routing-instance-access {
#     access-list {
#         clv1;
#         clv2;
#     }
# }
# arp {
#     host-name-resolution;
# }
# vagrant@vsrx# show routing-instances
# clv1 {
#     description clv1;
# }
# clv2 {
#     description clv2;
# }
- name: Override running SNMP server configuration with provided configuration
  junipernetworks.junos.junos_snmp_server:
    config:
      contact: "[email protected]"
      customization:
        ether_stats_ifd_only: True
      description: "Local SNMP Server"
      engine_id:
        local: "local1"
        use_default_ip_address: True
        use_mac_address: True
      filter_duplicates: True
      filter_interfaces:
        set: True
        all_internal_interfaces: True
        interfaces:
          - "eth1"
          - "eth2"
    state:  overridden
#
# -------------------------
# Module Execution Result
# -------------------------
#     "after": {
#         "contact": "[email protected]",
#         "customization": {
#             "ether_stats_ifd_only": true
#         },
#         "description": "Local SNMP Server",
#         "engine_id": {
#             "use_mac_address": true
#         },
#         "filter_duplicates": true,
#         "filter_interfaces": {
#             "all_internal_interfaces": true,
#             "interfaces": [
#                 "eth1",
#                 "eth2"
#             ]
#         }
#     },
#     "before":
#      {
#         "arp": {
#             "host_name_resolution": true
#         },
#         "client_lists": [
#             {
#                 "addresses": [
#                     {
#                         "address": "192.16.1.0/24"
#                     },
#                     {
#                         "address": "192.16.2.0/24"
#                     },
#                     {
#                         "address": "11.11.11.11/32",
#                         "restrict": true
#                     }
#                 ],
#                 "name": "cl1"
#             },
#             {
#                 "addresses": [
#                     {
#                         "address": "192.16.4.0/24"
#                     }
#                 ],
#                 "name": "cl2"
#             }
#         ],
#         "routing_instance_access": {
#             "access_lists": [
#                 "clv1",
#                 "clv2"
#             ]
#         }
#     },
#     "changed": true,
#     "commands": [
#         "<nc:snmp xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0"/>",
#         "<nc:snmp xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0" delete="delete"/>",
#         "<nc:snmp xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0">"
#         "<nc:contact>[email protected]</nc:contact><nc:customization>"
#         "<nc:ether-stats-ifd-only/></nc:customization><nc:description>Local SNMP Server</nc:description>"
#         "<nc:engine-id><nc:local>local1</nc:local><nc:use-default-ip-address/><nc:use-mac-address/>"
#         "</nc:engine-id><nc:filter-duplicates/><nc:filter-interfaces><nc:all-internal-interfaces/><nc:interfaces>"
#         "<nc:name>eth1</nc:name></nc:interfaces><nc:interfaces><nc:name>eth2</nc:name></nc:interfaces>"
#         "</nc:filter-interfaces></nc:snmp>"
#     ]
# After state
# -----------
#
# vagrant@vsrx# show routing-instances
# clv1 {
#     description clv1;
# }
# clv2 {
#     description clv2;
# }
# vagrant@vsrx# show snmp
# description "Local SNMP Server";
# contact "[email protected]";
# filter-interfaces {
#     interfaces {
#         eth1;
#         eth2;
#     }
#     all-internal-interfaces;
# }
# filter-duplicates;
# engine-id {
#     use-mac-address;
# }
# customization {
#     ether-stats-ifd-only;
# }
#
# Using deleted
#
# Before state
# ------------
#
# vagrant@vsrx# show routing-instances
# clv1 {
#     description clv1;
# }
# clv2 {
#     description clv2;
# }
# vagrant@vsrx# show snmp
# description "Local SNMP Server";
# contact "[email protected]";
# filter-interfaces {
#     interfaces {
#         eth1;
#         eth2;
#     }
#     all-internal-interfaces;
# }
# filter-duplicates;
# engine-id {
#     use-mac-address;
# }
# customization {
#     ether-stats-ifd-only;
# }
#
- name: Delete running SNMP server configuration
  junipernetworks.junos.junos_snmp_server:
    config:
    state: deleted
#
# -------------------------
# Module Execution Result
# -------------------------
#     "after": {},
#     "before": {
#         "contact": "[email protected]",
#         "customization": {
#             "ether_stats_ifd_only": true
#         },
#         "description": "Local SNMP Server",
#         "engine_id": {
#             "use_mac_address": true
#         },
#         "filter_duplicates": true,
#         "filter_interfaces": {
#             "all_internal_interfaces": true,
#             "interfaces": [
#                 "eth1",
#                 "eth2"
#             ]
#         }
#     },
#     "changed": true,
#     "commands": [
#               "<nc:snmp xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0"/>",
#               "<nc:snmp xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0" delete="delete"/>"
#     ]
# After state
# -----------
#
# vagrant@vsrx# show routing-instances
# clv1 {
#     description clv1;
# }
# clv2 {
#     description clv2;
# }
# vagrant@vsrx# show snmp
# description "Local SNMP Server";
# contact "[email protected]";
# filter-interfaces {
#     interfaces {
#         eth1;
#         eth2;
#     }
#     all-internal-interfaces;
# }
# filter-duplicates;
# engine-id {
#     use-mac-address;
# }
# customization {
#     ether-stats-ifd-only;
# }
#
- name: Gather running SNMP server configuration
  junipernetworks.junos.junos_snmp_server:
    state: gathered
#
# -------------------------
# Module Execution Result
# -------------------------
#     "gathered": {
#         "contact": "[email protected]",
#         "customization": {
#             "ether_stats_ifd_only": true
#         },
#         "description": "Local SNMP Server",
#         "engine_id": {
#             "use_mac_address": true
#         },
#         "filter_duplicates": true,
#         "filter_interfaces": {
#             "all_internal_interfaces": true,
#             "interfaces": [
#                 "eth1",
#                 "eth2"
#             ]
#         }
#     },
#     "changed": false,
# Using rendered
#
# Before state
# ------------
#
- name: Render xml for provided facts.
  junipernetworks.junos.junos_snmp_server:
    config:
      arp:
        set: true
        host_name_resolution: true
      routing_instance_access:  # ATTR-----3
        set: true
        access_lists:
          - "clv1"
          - "clv2"
    state: rendered
#
# -------------------------
# Module Execution Result
# -------------------------
#     "rendered": [
#           "<nc:snmp xmlns:nc="urn:ietf:params:xml:ns:netconf:base:1.0">"
#           "<nc:arp><nc:host-name-resolution/></nc:arp><nc:routing-instance-access>"
#           "<nc:access-list><nc:name>clv1</nc:name></nc:access-list><nc:access-list><nc:name>clv2</nc:name>"
#           "</nc:access-list></nc:routing-instance-access></nc:snmp>"
#     ]
#
# Using parsed
# parsed.cfg
# ------------
# <?xml version="1.0" encoding="UTF-8"?>
# <rpc-reply message-id="urn:uuid:0cadb4e8-5bba-47f4-986e-72906227007f">
#     <configuration changed-seconds="1590139550" changed-localtime="2020-05-22 09:25:50 UTC">
#         <version>18.4R1-S2.4</version>
#         <system xmlns="http://yang.juniper.net/junos-es/conf/system">
#            <snmp>
#         <client-list>
#             <name>cl1</name>
#             <client-address-list>
#                 <name>192.16.1.0/24</name>
#             </client-address-list>
#             <client-address-list>
#                 <name>192.16.2.0/24</name>
#             </client-address-list>
#             <client-address-list>
#                 <name>11.11.11.11/32</name>
#                 <restrict/>
#             </client-address-list>
#         </client-list>
#         <client-list>
#             <name>cl2</name>
#             <client-address-list>
#                 <name>192.16.4.0/24</name>
#             </client-address-list>
#         </client-list>
#         <routing-instance-access>
#             <access-list>
#                 <name>clv1</name>
#             </access-list>
#             <access-list>
#                 <name>clv2</name>
#             </access-list>
#         </routing-instance-access>
#         <arp>
#             <host-name-resolution/>
#         </arp>
#     </snmp>
#     </system>
#     </configuration>
# </rpc-reply>
#
- name: Parse SNMP server running config
  junipernetworks.junos.junos_snmp_server:
    running_config: "{{ lookup('file', './parsed.cfg') }}"
    state: parsed
#
#
# -------------------------
# Module Execution Result
# -------------------------
#
#
# "parsed":  {
#         "arp": {
#             "host_name_resolution": true
#         },
#         "client_lists": [
#             {
#                 "addresses": [
#                     {
#                         "address": "192.16.1.0/24"
#                     },
#                     {
#                         "address": "192.16.2.0/24"
#                     },
#                     {
#                         "address": "11.11.11.11/32",
#                         "restrict": true
#                     }
#                 ],
#                 "name": "cl1"
#             },
#             {
#                 "addresses": [
#                     {
#                         "address": "192.16.4.0/24"
#                     }
#                 ],
#                 "name": "cl2"
#             }
#         ],
#         "routing_instance_access": {
#             "access_lists": [
#                 "clv1",
#                 "clv2"
#             ]
#         }
#     }
#
#

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key	Description
after dictionary	The resulting configuration model invocation. Returned: when changed Sample: “The configuration returned will always be in the same format\n of the parameters above.\n”
before dictionary	The configuration prior to the model invocation. Returned: always Sample: “The configuration returned will always be in the same format\n of the parameters above.\n”
commands list / elements=string	The set of commands pushed to the remote device. Returned: always Sample: [“\u003cnc:arp\u003e\u003cnc:host-name-resolution/\u003e\u003c/nc:arp\u003e\u003cnc:routing-instance-access\u003e\””, “\u003cnc:snmp xmlns:nc=\”urn:ietf:params:xml:ns:netconf:base:1.0\”\u003e”]

Authors

• Rohit Thakur (@rohitthakur2590)

Collection links

Issue Tracker Repository (Sources)