cisco.ios.ios_snmp_server 模块 – 用于配置 SNMP 服务器的资源模块。

注意

此模块是 cisco.ios 集合（版本 9.0.3）的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install cisco.ios。

要在 playbook 中使用它，请指定：cisco.ios.ios_snmp_server。

cisco.ios 2.6.0 中的新增功能

概要 

此模块提供 Cisco IOS 设备上 SNMP 服务器的声明式管理。

参数 

参数	注释
config 字典	SNMP 服务器配置的字典
accounting 字典	SNMP 记帐参数
command 字符串	用于 SNMP 设置命令
cache 整数	启用 SNMP 缓存和 MIB 过期间隔
chassis_id 字符串	用于唯一标识此机箱的字符串（十六进制）
communities 列表 / 元素=字典	团体名称配置。
acl_v4 字符串	标准访问列表名称
acl_v6 字符串	IPv6 访问列表名称
name 字符串	团体名称（默认 RO）
ro 布尔值	仅允许读取选项 `false` `true`
rw 布尔值	读写访问选项 `false` `true`
view 字符串	MIB 视图名称
contact 字符串	用于 mib 对象 sysContact 的文本
context 列表 / 元素=字符串	创建/删除除默认值之外的上下文
drop 字典	静默丢弃 SNMP 数据包
unknown_user 布尔值	静默丢弃未知 v3 用户数据包选项 `false` `true`
vrf_traffic 布尔值	静默丢弃 VRF 接口上的 SNMP 数据包选项 `false` `true`
engine_id 列表 / 元素=字典	配置本地或远程 SNMPv3 engineID
id 字符串	引擎 ID 八位字节字符串
local 布尔值	本地 SNMP 代理选项 `false` `true`
remote 字典	远程 SNMP 代理
host 字符串	远程 SNMP 通知主机的主机名或 IP 地址
udp_port 整数	远程 SNMP 通知主机的 UDP 端口号。
vrf 字符串	远程通知主机的 VPN 路由实例
file_transfer 字典	与文件传输相关的命令
access_group 字符串	文件传输的访问控制
protocol 列表 / 元素=字符串	文件传输的访问控制协议
groups 列表 / 元素=字典	定义用户安全模型组
acl_v4 字符串	指定与此组关联的访问列表
acl_v6 字符串	指定与此组关联的访问列表
context 字符串	指定要与组关联的上下文
group 字符串	用户的 SNMP 组
match 字符串	指定上下文名称匹配条件选项 `"exact"` `"prefix"`
notify 字符串	用于限制通知的视图
read 字符串	用于限制读取访问的视图
version 字符串	snmp 安全组版本选项 `"v1"` `"v3"` `"v2c"`
version_option 字符串	到主机的团体名称。选项 `"auth"` `"noauth"` `"priv"`
write 字符串	用于限制写入访问的视图
hosts 列表 / 元素=字典	指定接收 SNMP 通知的主机
community_string 字符串	SNMPv1/v2c 团体字符串或 SNMPv3 用户名
host 字符串	SNMP 通知主机的主机名或 IP 地址。
informs 布尔值	使用 SNMP Inform 消息。选项 `false` `true`
traps 列表 / 元素=字符串	使用 SNMP trap 消息
version 字符串	通知消息 SNMP 版本。选项 `"1"` `"2c"` `"3"`
version_option 字符串	到主机的团体名称。选项 `"auth"` `"noauth"` `"priv"`
vrf 字符串	指定配置主机的 VRF
if_index 布尔值	启用 ifindex 持久性选项 `false` `true`
inform 字典	配置 SNMP Inform 选项
pending 整数	设置要保留的未确认的 inform 数量
retries 整数	设置 inform 的重试计数
timeout 整数	设置 inform 的超时时间
ip 字典	SNMP 流量的 IP ToS 配置
dscp 整数	SNMP 流量的 IP DSCP 值
precedence 整数	SNMP 流量的 IP 优先级值
location 字符串	用于 mib 对象 sysLocation 的文本
manager 整数	修改 SNMP 管理器参数
packet_size 整数	最大 SNMP 数据包大小
password_policy 列表 / 元素=字典	SNMP v3 用户密码策略
change 整数	新旧密码之间字符更改的数量
digits 整数	数字的数量
lower_case 整数	小写字符的数量
max_len 整数	最大密码长度
min_len 整数	最小密码长度
policy_name 字符串	策略的名称
special_char 整数	特殊字符的数量
upper_case 整数	大写字符的数量
username 字符串	用户的名称
queue_length 整数	每个 TRAP 主机的消息队列长度
source_interface 字符串	用于发送 SNMP 通知的源接口。
system_shutdown 布尔值	启用 SNMP reload 命令的使用选项 `false` `true`
trap_source 字符串	为所有 trap 的源地址分配接口
trap_timeout 整数	设置 TRAP 消息重传的超时时间
traps 字典	启用 SNMP Trap
aaa_server 布尔值	启用 SNMP AAA 服务器 trap 选项 `false` `true`
auth_framework 字典	启用 SNMP CISCO-AUTH-FRAMEWORK-MIB trap
enable 布尔值	启用/禁用身份验证框架选项 `false` `true`
sec_violation 布尔值	模式 sec_violation 选项 `false` `true`
bfd 字典	允许 SNMP BFD trap
enable 布尔值	启用/禁用 bfd 选项 `false` `true`
session_down 布尔值	启用 BFD 会话关闭 trap 选项 `false` `true`
session_up 布尔值	启用 BFD 会话启动 trap 选项 `false` `true`
bgp 字典	允许 bgp trap
cbgp2 布尔值	启用 BGP MIBv2 trap 选项 `false` `true`
enable 布尔值	启用/禁用 bgp trap 选项 `false` `true`
state_changes 字典	FSM 状态更改的 trap
all 布尔值	所有 fsm 状态更改的 CISCO 特定 trap 选项 `false` `true`
backward_trans 布尔值	后向转换的 CISCO 特定 trap 选项 `false` `true`
enable 布尔值	启用/禁用 bgp state_changes trap 选项 `false` `true`
limited 布尔值	标准后向转换和已建立的 trap 选项 `false` `true`
threshold 字典	模式 threshold
prefix 布尔值	启用/禁用 bgp threshold trap 选项 `false` `true`
bridge 字典	允许与网桥相关的 trap
enable 布尔值	启用/禁用网桥 trap 选项 `false` `true`
newroot 布尔值	启用 SNMP STP 网桥 MIB newroot trap 选项 `false` `true`
topologychange 布尔值	启用 SNMP STP 网桥 MIB topologychange trap 选项 `false` `true`
bulkstat 字典	允许 Data-Collection-MIB 收集通知
collection 布尔值	启用 Data-Collection-MIB 收集通知选项 `false` `true`
enable 布尔值	启用 Data-Collection-MIB 收集和传输通知选项 `false` `true`
transfer 布尔值	启用 Data-Collection-MIB 传输通知选项 `false` `true`
call_home 字典	SNMP CISCO-CALLHOME-MIB trap
enable 布尔值	启用 SNMP CISCO-CALLHOME-MIB trap 选项 `false` `true`
message_send_fail 布尔值	启用 SNMP ccmSmtpMsgSendFailNotif 通知选项 `false` `true`
server_fail 布尔值	启用 SNMP ccmSmtpServerFailNotif 通知选项 `false` `true`
casa 布尔值	启用 SNMP 配置 casa 陷阱选项 `false` `true`
cef 字典	允许 cef 相关陷阱
enable 布尔值	启用/禁用 cef 陷阱选项 `false` `true`
inconsistency 布尔值	启用 SNMP CEF 不一致陷阱选项 `false` `true`
peer_fib_state_change 布尔值	启用 SNMP CEF 对等 FIB 状态更改陷阱选项 `false` `true`
peer_state_change 布尔值	启用 SNMP CEF 对等状态更改陷阱选项 `false` `true`
resource_failure 布尔值	启用 SNMP CEF 资源故障陷阱选项 `false` `true`
cnpd 布尔值	启用 SNMP cnpd 陷阱选项 `false` `true`
config 布尔值	启用 SNMP 配置陷阱选项 `false` `true`
config_copy 布尔值	启用 SNMP 配置复制陷阱选项 `false` `true`
config_ctid 布尔值	启用 SNMP 配置 ctid 陷阱选项 `false` `true`
cpu 字典	允许 CPU 相关陷阱
enable 布尔值	启用/禁用 CPU 陷阱选项 `false` `true`
threshold 布尔值	模式 threshold 选项 `false` `true`
dhcp 布尔值	启用 SNMP dhcp 陷阱选项 `false` `true`
dlsw 字典	允许 dlsw 相关陷阱
circuit 布尔值	启用 SNMP dlsw 电路陷阱选项 `false` `true`
enable 布尔值	启用/禁用 cef 陷阱选项 `false` `true`
tconn 布尔值	启用 SNMP dlsw 对等传输连接陷阱选项 `false` `true`
eigrp 布尔值	启用 SNMP eigrp 陷阱选项 `false` `true`
energywise 布尔值	启用 SNMP energywise 陷阱选项 `false` `true`
entity 布尔值	启用 SNMP 实体陷阱选项 `false` `true`
entity_diag 字典	允许 SNMP CISCO-ENTITY-DIAG-MIB 陷阱
boot_up_fail 布尔值	启用 SNMP ceDiagBootUpFailedNotif 陷阱选项 `false` `true`
enable 布尔值	启用 SNMP CISCO-ENTITY-DIAG-MIB 陷阱选项 `false` `true`
hm_test_recover 布尔值	启用 SNMP ceDiagHMTestRecoverNotif 陷阱选项 `false` `true`
hm_thresh_reached 布尔值	启用 SNMP ceDiagHMThresholdReachedNotif 陷阱选项 `false` `true`
scheduled_test_fail 布尔值	启用 SNMP ceDiagScheduledTestFailedNotif 陷阱选项 `false` `true`
entity_perf 字典	允许 SNMP CISCO-ENTITY-PERFORMANCE-MIB 陷阱
enable 布尔值	启用 SNMP CISCO-ENTITY-PERFORMANCE-MIB 陷阱选项 `false` `true`
throughput_notif 布尔值	启用 ENTITY PERFORMANCE MIB 吞吐量陷阱选项 `false` `true`
entity_state 布尔值	启用 SNMP ENTITY-STATE-MIB 陷阱选项 `false` `true`
envmon 字典	启用 SNMP 环境监控器陷阱
enable 布尔值	启用/禁用 envmon 陷阱选项 `false` `true`
fan 字典	启用 SNMP envmon 风扇陷阱此选项已弃用，并由接受布尔值作为输入的 fan_enable 替换此属性将在 2024-09-01 之后删除
enable 布尔值	启用/禁用风扇陷阱选项 `false` `true`
shutdown 布尔值	启用 SNMP 环境监控器关闭陷阱选项 `false` `true`
status 布尔值	启用 SNMP 环境状态更改陷阱选项 `false` `true`
supply 布尔值	启用 SNMP 环境监控器电源陷阱选项 `false` `true`
temperature 布尔值	启用 SNMP 环境监控器温度陷阱选项 `false` `true`
fan_enable 布尔值	启用 SNMP envmon 风扇陷阱选项 `false` `true`
shutdown 布尔值	启用 SNMP 环境监控器关闭陷阱选项 `false` `true`
status 布尔值	启用 SNMP 环境状态更改陷阱选项 `false` `true`
supply 布尔值	启用 SNMP 环境监控器电源陷阱选项 `false` `true`
temperature 布尔值	启用 SNMP 环境监控器温度陷阱选项 `false` `true`
errdisable 布尔值	启用 SNMP errdisable 通知选项 `false` `true`
ether_oam 布尔值	启用 SNMP 以太网 oam 陷阱选项 `false` `true`
ethernet 字典	允许以太网陷阱
cfm 字典	启用 SNMP 以太网 CFM 陷阱
alarm 布尔值	启用 SNMP 以太网 CFM 故障告警陷阱选项 `false` `true`
cc 字典	启用 SNMP 以太网 CC 陷阱
config 布尔值	启用 SNMP 以太网 CFM 配置错误陷阱选项 `false` `true`
cross_connect 布尔值	启用 SNMP 以太网 CFM 交叉连接陷阱选项 `false` `true`
loop 布尔值	启用 SNMP 以太网 CFM 环路陷阱选项 `false` `true`
mep_down 布尔值	启用 SNMP 以太网 CFM CC 关闭陷阱选项 `false` `true`
mep_up 布尔值	启用 SNMP 以太网 CFM CC 启动陷阱选项 `false` `true`
crosscheck 字典	启用 SNMP 以太网 CC 交叉检查陷阱
mep_missing 布尔值	启用 SNMP 以太网 CC 交叉检查丢失陷阱选项 `false` `true`
mep_unknown 布尔值	启用 SNMP 以太网 CC 交叉检查未知陷阱选项 `false` `true`
service_up 布尔值	启用 SNMP 以太网 CC 交叉检查服务陷阱选项 `false` `true`
evc 字典	启用 SNMP 以太网 EVC 陷阱
create 布尔值	启用 SNMP 以太网 EVC 创建陷阱选项 `false` `true`
delete 布尔值	启用 SNMP 以太网 EVC 删除陷阱选项 `false` `true`
status 布尔值	启用 SNMP 以太网 EVC 状态陷阱选项 `false` `true`
event_manager 布尔值	启用 SNMP 事件管理器陷阱选项 `false` `true`
firewall 字典	启用 SNMP 防火墙陷阱
enable 布尔值	启用/禁用防火墙陷阱选项 `false` `true`
serverstatus 布尔值	启用防火墙服务器状态更改陷阱选项 `false` `true`
flash 字典	SNMP FLASH 通知
enable 布尔值	启用 SNMP FLASH 通知选项 `false` `true`
insertion 布尔值	启用 SNMP Flash 插入通知选项 `false` `true`
lowspace 布尔值	启用 SNMP Flash 空间不足通知选项 `false` `true`
removal 布尔值	启用 SNMP Flash 移除通知选项 `false` `true`
flex_links 字典	SNMP FLEX Links 陷阱
enable 布尔值	启用 SNMP FLEX Links 陷阱选项 `false` `true`
status 布尔值	启用 SNMP FLEX Links 状态更改陷阱选项 `false` `true`
flowmon 布尔值	启用 SNMP flowmon 陷阱选项 `false` `true`
frame_relay 字典	允许帧中继陷阱
enable 布尔值	启用/禁用帧中继陷阱选项 `false` `true`
subif 字典	启用 SNMP 帧中继子接口陷阱
count 整数	每个间隔发送的最大陷阱数
enable 布尔值	启用/禁用子接口陷阱选项 `false` `true`
interval 整数	限制发送的陷阱数量的时间间隔
fru_ctrl 布尔值	启用 SNMP fru-ctrl 陷阱选项 `false` `true`
hsrp 布尔值	启用 SNMP hsrp 陷阱选项 `false` `true`
ike 字典	允许 ike 陷阱
policy 字典	启用 IKE 策略陷阱
add 布尔值	启用 IKE 策略添加陷阱选项 `false` `true`
delete 布尔值	启用 IKE 策略删除陷阱选项 `false` `true`
tunnel 字典	启用 IKE 隧道陷阱
start 布尔值	启用 IKE 隧道启动陷阱选项 `false` `true`
stop 布尔值	启用 IKE 隧道停止陷阱选项 `false` `true`
ipmulticast 布尔值	启用 SNMP ip 多播陷阱选项 `false` `true`
ipsec 字典	允许 ike 陷阱
cryptomap 字典	启用 IPsec 密码映射陷阱
add 布尔值	启用 IPsec 密码映射添加陷阱选项 `false` `true`
attach 布尔值	启用 IPsec 密码映射附加陷阱选项 `false` `true`
delete 布尔值	启用 IPsec 密码映射删除陷阱选项 `false` `true`
detach 布尔值	启用 IPsec 密码映射分离陷阱选项 `false` `true`
too_many_sas 布尔值	启用 IPsec 隧道启动陷阱选项 `false` `true`
tunnel 字典	启用 IPsec 隧道陷阱
start 布尔值	启用 IPsec 隧道启动陷阱选项 `false` `true`
stop 布尔值	启用 IPsec 隧道停止陷阱选项 `false` `true`
ipsla 布尔值	启用 SNMP ipsla 陷阱选项 `false` `true`
isis 布尔值	启用 SNMP isis 陷阱选项 `false` `true`
l2tc 字典	允许 SNMP L2 隧道配置陷阱
enable 布尔值	启用 SNMP L2 隧道配置陷阱选项 `false` `true`
sys_threshold 布尔值	启用 SNMP L2TC 系统阈值陷阱选项 `false` `true`
threshold 布尔值	启用 SNMP L2 隧道配置阈值陷阱选项 `false` `true`
l2tun 字典	允许 SNMP l2tun 陷阱
pseudowire_status 布尔值	启用 BFD 伪线状态陷阱选项 `false` `true`
session 布尔值	启用 BFD 会话陷阱选项 `false` `true`
license 布尔值	启用许可证陷阱选项 `false` `true`
lisp 布尔值	启用 SNMP LISP MIB 陷阱选项 `false` `true`
local_auth 布尔值	启用 SNMP 本地身份验证陷阱选项 `false` `true`
mac_notification 字典	允许 SNMP MAC 通知陷阱
change 布尔值	启用 SNMP MAC 更改陷阱选项 `false` `true`
enable 布尔值	启用 SNMP MAC 通知陷阱选项 `false` `true`
move 布尔值	启用 SNMP MAC 移动陷阱选项 `false` `true`
threshold 布尔值	启用 SNMP MAC 阈值陷阱选项 `false` `true`
memory 字典	允许 MEMORY 陷阱
bufferpeak 布尔值	启用 SNMP 内存 Bufferpeak 陷阱选项 `false` `true`
enable 布尔值	启用 MEMORY 陷阱选项 `false` `true`
mpls 字典	启用 SNMP mpls 陷阱
fast_reroute 字典	允许 SNMP MPLS 快速重路由陷阱
enable 布尔值	启用 SNMP MPLS 快速重路由陷阱选项 `false` `true`
protected 布尔值	启用 MPLS 快速重路由保护陷阱选项 `false` `true`
ldp 字典	允许 SNMP MPLS 标签分发协议陷阱
enable 布尔值	启用 SNMP MPLS 标签分发协议陷阱选项 `false` `true`
pv_limit 布尔值	启用 MPLS LDP 路径向量限制不匹配陷阱选项 `false` `true`
session_down 布尔值	启用 MPLS LDP 会话关闭陷阱选项 `false` `true`
session_up 布尔值	启用 MPLS LDP 会话启动陷阱选项 `false` `true`
threshold 布尔值	启用 MPLS LDP 阈值超出陷阱选项 `false` `true`
rfc 字典	启用 SNMP MPLS RFC 陷阱
ldp 字典	允许 SNMP MPLS 标签分发协议 RFC 陷阱
enable 布尔值	启用 SNMP MPLS 标签分发协议 RFC 陷阱选项 `false` `true`
pv_limit 布尔值	启用 MPLS LDP 路径向量限制不匹配 RFC 陷阱选项 `false` `true`
session_down 布尔值	启用 MPLS LDP 会话关闭 RFC 陷阱选项 `false` `true`
session_up 布尔值	启用 MPLS LDP 会话启动 RFC 陷阱选项 `false` `true`
threshold 布尔值	启用 MPLS LDP 阈值超出 RFC 陷阱选项 `false` `true`
traffic_eng 字典	允许 SNMP MPLS 流量工程 RFC 陷阱
down 布尔值	启用 MPLS TE 隧道关闭 RFC 陷阱选项 `false` `true`
enable 布尔值	启用 SNMP MPLS 流量工程 RFC 陷阱选项 `false` `true`
reoptimized 布尔值	启用 MPLS TE 隧道重新优化 RFC 陷阱选项 `false` `true`
reroute 布尔值	启用 MPLS TE 隧道重路由 RFC 陷阱选项 `false` `true`
up 布尔值	启用 MPLS TE 隧道启动 RFC 陷阱选项 `false` `true`
vpn 字典	允许 SNMP MPLS 虚拟专用网络 RFC 陷阱
enable 布尔值	启用 SNMP MPLS 虚拟专用网络 RFC 陷阱选项 `false` `true`
illegal_label 布尔值	启用 MPLS VPN 非法标签阈值超出 RFC 陷阱选项 `false` `true`
max_thresh_cleared 布尔值	启用 MPLS VPN 最大阈值清除 RFC 陷阱选项 `false` `true`
max_threshold 布尔值	启用 MPLS VPN 最大阈值超出 RFC 陷阱选项 `false` `true`
mid_threshold 布尔值	启用 MPLS VPN 中间阈值超出 RFC 陷阱选项 `false` `true`
vrf_down 布尔值	启用 MPLS VPN vrf 关闭 RFC 陷阱选项 `false` `true`
vrf_up 布尔值	启用 MPLS VPN vrf 启动 RFC 陷阱选项 `false` `true`
traffic_eng 字典	允许 SNMP MPLS 流量工程陷阱
down 布尔值	启用 MPLS TE 隧道关闭陷阱选项 `false` `true`
enable 布尔值	启用 SNMP MPLS 流量工程陷阱选项 `false` `true`
reroute 布尔值	启用 MPLS TE 隧道重路由陷阱选项 `false` `true`
up 布尔值	启用 MPLS TE 隧道启动陷阱选项 `false` `true`
vpn 字典	允许 SNMP MPLS 虚拟专用网络陷阱
enable 布尔值	启用 SNMP MPLS 虚拟专用网络陷阱选项 `false` `true`
illegal_label 布尔值	启用 MPLS VPN 非法标签阈值超出陷阱选项 `false` `true`
max_thresh_cleared 布尔值	启用 MPLS VPN 最大阈值清除陷阱选项 `false` `true`
max_threshold 布尔值	启用 MPLS VPN 最大阈值超出陷阱选项 `false` `true`
mid_threshold 布尔值	启用 MPLS VPN 中间阈值超出陷阱选项 `false` `true`
vrf_down 布尔值	启用 MPLS VPN vrf 关闭陷阱选项 `false` `true`
vrf_up 布尔值	启用 MPLS VPN vrf 启动陷阱选项 `false` `true`
mpls_vpn 布尔值	启用 SNMP mpls 陷阱此选项已弃用，并由接受字典作为输入的 mpls 替换此属性将在 2024-09-01 之后删除选项 `false` `true`
msdp 布尔值	启用 SNMP msdp 陷阱选项 `false` `true`
mvpn 布尔值	启用 SNMP mvpn 陷阱选项 `false` `true`
nhrp 字典	允许 SNMP NHRP 陷阱
enable 布尔值	启用 SNMP NHRP 陷阱选项 `false` `true`
nhc 字典	允许下一跳客户端陷阱
down 布尔值	启用下一跳客户端关闭陷阱选项 `false` `true`
enable 布尔值	启用下一跳客户端陷阱选项 `false` `true`
up 布尔值	启用下一跳客户端启动陷阱选项 `false` `true`
nhp 字典	允许下一跳对等陷阱
down 布尔值	启用下一跳对等关闭陷阱选项 `false` `true`
enable 布尔值	启用下一跳对等陷阱选项 `false` `true`
up 布尔值	启用下一跳对等启动陷阱选项 `false` `true`
nhs 字典	允许下一跳服务器陷阱
down 布尔值	启用下一跳服务器关闭陷阱选项 `false` `true`
enable 布尔值	启用下一跳服务器陷阱选项 `false` `true`
up 布尔值	启用下一跳服务器启动陷阱选项 `false` `true`
quota_exceeded 布尔值	启用超出配额陷阱选项 `false` `true`
ospf 字典	允许 ospf 相关陷阱
cisco_specific 字典	Cisco 特定陷阱
error 布尔值	错误陷阱选项 `false` `true`
lsa 布尔值	Lsa 相关陷阱选项 `false` `true`
retransmit 布尔值	数据包重传陷阱选项 `false` `true`
state_change 字典	状态更改陷阱
nssa_trans_change 布尔值	Nssa 转换器状态更改选项 `false` `true`
shamlink 字典	虚拟接口上的配置不匹配错误
interface 布尔值	虚链路接口状态更改选项 `false` `true`
邻居布尔值	虚链路邻居状态更改选项 `false` `true`
error 布尔值	启用错误陷阱选项 `false` `true`
lsa 布尔值	启用/禁用 OSPF LSA 陷阱选项 `false` `true`
retransmit 布尔值	启用/禁用 OSPF 重传陷阱选项 `false` `true`
state_change 布尔值	启用/禁用状态更改陷阱选项 `false` `true`
ospfv3 字典	允许 OSPFv3 相关陷阱
错误字典	错误陷阱
bad_packet 布尔值	非虚拟接口上的数据包解析失败选项 `false` `true`
config_error 布尔值	非虚拟接口上的配置不匹配错误选项 `false` `true`
enable 布尔值	启用错误陷阱选项 `false` `true`
virt_bad_packet 布尔值	虚拟接口上的数据包解析失败选项 `false` `true`
virt_config_error 布尔值	虚拟接口上的配置不匹配错误选项 `false` `true`
rate_limit 整数	陷阱速率限制值速率限制窗口大小（以秒为单位，介于 2 和 60 之间）
state_change 字典	状态更改陷阱
enable 布尔值	启用状态更改陷阱选项 `false` `true`
if_state_change 布尔值	非虚拟接口状态更改选项 `false` `true`
neighbor_restart_helper_status_change 布尔值	邻居平滑重启辅助状态更改选项 `false` `true`
neighbor_state_change 布尔值	非虚拟邻居状态更改选项 `false` `true`
nssa_translator_status_change 布尔值	NSSA 转换器状态更改选项 `false` `true`
restart_status_change 布尔值	平滑重启状态更改选项 `false` `true`
virtif_state_change 布尔值	虚拟接口状态更改选项 `false` `true`
vn_restart_helper_status_change 布尔值	虚拟邻居平滑重启辅助状态更改选项 `false` `true`
vn_state_change 布尔值	虚拟邻居状态更改选项 `false` `true`
pim 字典	允许 PIM 陷阱
enable 布尔值	启用/禁用 PIM 陷阱选项 `false` `true`
invalid_pim_message 布尔值	启用无效的 PIM 消息陷阱选项 `false` `true`
neighbor_change 布尔值	启用邻居更改陷阱选项 `false` `true`
rp_mapping_change 布尔值	启用 RP 映射更改陷阱选项 `false` `true`
pki 布尔值	启用 SNMP PKI 陷阱选项 `false` `true`
port_security 布尔值	启用 SNMP 端口安全陷阱选项 `false` `true`
power_ethernet 字典	允许 SNMP 以太网供电陷阱
enable 布尔值	启用 SNMP 以太网供电陷阱选项 `false` `true`
group 列表 / 元素=字典	启用基于 SNMP 内联电源组的陷阱。
slot_id 整数	介于 1 和 20 之间的整数（物理插槽号）
threshold 整数	此插槽的阈值级别
police 布尔值	启用策略陷阱选项 `false` `true`
pw_vc 布尔值	启用 SNMP PW VC 陷阱选项 `false` `true`
rep 布尔值	启用 SNMP 弹性以太网协议陷阱选项 `false` `true`
rf 布尔值	启用 CISCO-RF-MIB 中定义的所有 SNMP 陷阱选项 `false` `true`
rsvp 布尔值	启用 SNMP RSVP 陷阱选项 `false` `true`
smart_license 字典	允许智能许可证陷阱
enable 布尔值	启用智能许可证陷阱选项 `false` `true`
entitlement 布尔值	启用授权通知陷阱选项 `false` `true`
global 布尔值	启用全局通知陷阱选项 `false` `true`
snmp 字典	启用 SNMP 陷阱
authentication 布尔值	启用身份验证陷阱选项 `false` `true`
coldstart 布尔值	启用冷启动陷阱选项 `false` `true`
linkdown 布尔值	启用链路关闭陷阱选项 `false` `true`
linkup 布尔值	启用链路启动陷阱选项 `false` `true`
warmstart 布尔值	启用热启动陷阱选项 `false` `true`
stackwise 布尔值	启用 SNMP StackWise 陷阱选项 `false` `true`
stpx 字典	允许 SNMP STPX MIB 陷阱
enable 布尔值	启用 SNMP STPX MIB 陷阱选项 `false` `true`
inconsistency 布尔值	启用 SNMP STPX MIB InconsistencyUpdate 陷阱选项 `false` `true`
loop_inconsistency 布尔值	启用 SNMP STPX MIB LoopInconsistencyUpdate 陷阱选项 `false` `true`
root_inconsistency 布尔值	启用 SNMP STPX MIB RootInconsistencyUpdate 陷阱选项 `false` `true`
syslog 布尔值	启用 SNMP Syslog 陷阱选项 `false` `true`
transceiver_all 布尔值	启用 SNMP 收发器陷阱选项 `false` `true`
trustsec 字典	允许 SNMP CISCO-TRUSTSEC-MIB 陷阱
authz_file_error 布尔值	启用 ctsAuthzCacheFileErrNotif 通知选项 `false` `true`
cache_file_error 布尔值	启用 ctsCacheFileAccessErrNotif 通知选项 `false` `true`
enable 布尔值	启用 SNMP CISCO-TRUSTSEC-MIB 陷阱选项 `false` `true`
keystore_file_error 布尔值	启用 ctsSwKeystoreFileErrNotif 通知选项 `false` `true`
keystore_sync_fail 布尔值	启用 ctsSwKeystoreSyncFailNotif 通知选项 `false` `true`
random_number_fail 布尔值	启用 ctsSapRandonNumberFailNotif 通知选项 `false` `true`
src_entropy_fail 布尔值	启用 ctsSrcEntropyFailNotif 通知选项 `false` `true`
trustsec_interface 字典	允许 SNMP CISCO-TRUSTSEC-INTERFACE-MIB 陷阱
authc_fail 布尔值	启用 ctsiIfAuthenticationFailNotif 陷阱选项 `false` `true`
authz_fail 布尔值	启用 ctsiAuthorizationFailNotif 陷阱选项 `false` `true`
enable 布尔值	启用 SNMP CISCO-TRUSTSEC-INTERFACE-MIB 陷阱选项 `false` `true`
sap_fail 布尔值	启用 ctsiIfSapNegotiationFailNotif 陷阱选项 `false` `true`
supplicant_fail 布尔值	启用 ctsiIfAddSupplicantFailNotif 陷阱选项 `false` `true`
unauthorized 布尔值	启用 ctsiIfUnauthorizedNotifEnable 陷阱选项 `false` `true`
trustsec_policy 字典	允许 SNMP CISCO-TRUSTSEC-POLICY-MIB 陷阱
authz_sgacl_fail 布尔值	启用 ctspAuthorizationSgaclFailNotif 通知选项 `false` `true`
enable 布尔值	启用 SNMP CISCO-TRUSTSEC-POLICY-MIB 陷阱选项 `false` `true`
peer_policy_updated 布尔值	启用 ctspPeerPolicyUpdatedNotif 通知选项 `false` `true`
trustsec_server 字典	允许 SNMP CISCO-TRUSTSEC-SERVER-MIB 陷阱
enable 布尔值	启用 SNMP CISCO-TRUSTSEC-SERVER-MIB 陷阱选项 `false` `true`
provision_secret 布尔值	启用 ctsvNoProvisionSecretNotif 通知选项 `false` `true`
radius_server 布尔值	启用 ctsvNoRadiusServerNotif 通知选项 `false` `true`
trustsec_sxp 字典	允许 SNMP CISCO-TRUSTSEC-SXP-MIB 陷阱
binding_conflict 布尔值	启用 ctsxSxpBindingConflictNotif 通知选项 `false` `true`
binding_err 布尔值	启用 ctsxSxpBindingErrNotif 通知选项 `false` `true`
binding_expn_fail 布尔值	启用 ctsxSxpBindingExpnFailNotif 通知选项 `false` `true`
conn_config_err 布尔值	启用 ctsxSxpConnConfigErrNotif 通知选项 `false` `true`
conn_down 布尔值	启用 ctsxSxpConnDownNotif 通知选项 `false` `true`
conn_srcaddr_err 布尔值	启用 ctsxSxpConnSourceAddrErrNotif 通知选项 `false` `true`
conn_up 布尔值	启用 ctsxSxpConnUpNotif 通知选项 `false` `true`
enable 布尔值	启用 SNMP CISCO-TRUSTSEC-SXP-MIB 陷阱选项 `false` `true`
msg_parse_err 布尔值	启用 ctsxSxpMsgParseErrNotif 通知选项 `false` `true`
oper_nodeid_change 布尔值	启用 ctsxSxpOperNodeIdChangeNotif 通知选项 `false` `true`
tty 布尔值	启用 SNMP TTY TCP 连接陷阱选项 `false` `true`
udld 字典	允许 SNMP CISCO-UDLDP-MIB 陷阱
enable 布尔值	启用 SNMP CISCO-UDLDP-MIB 陷阱选项 `false` `true`
link_fail_rpt 布尔值	启用 SNMP cudldpFastHelloLinkFailRptNotification 陷阱选项 `false` `true`
status_change 布尔值	启用 SNMP cudldpFastHelloStatusChangeNotification 陷阱选项 `false` `true`
vlan_membership 布尔值	启用 SNMP VLAN 成员身份陷阱选项 `false` `true`
vlancreate 布尔值	启用 SNMP VLAN 创建陷阱选项 `false` `true`
vlandelete 布尔值	启用 SNMP VLAN 删除陷阱选项 `false` `true`
vrfmib 字典	允许 vrfmib 陷阱
vnet_trunk_down 布尔值	启用 vnet-trunk-down 陷阱选项 `false` `true`
vnet_trunk_up 布尔值	启用 vnet-trunk-up 陷阱选项 `false` `true`
vrf_down 布尔值	启用 vrf-down 陷阱选项 `false` `true`
vrf_up 布尔值	启用 vrf-up 陷阱选项 `false` `true`
vrrp 布尔值	启用 SNMP VRRP 陷阱选项 `false` `true`
vswitch 字典	允许 SNMP 虚拟交换机通知
dual_active 布尔值	启用 SNMP 虚拟交换机（双活）通知选项 `false` `true`
enable 布尔值	启用 SNMP 虚拟交换机通知选项 `false` `true`
vsl 布尔值	启用 SNMP 虚拟交换机链路 (VSL) 通知选项 `false` `true`
vtp 布尔值	启用 SNMP VTP 陷阱选项 `false` `true`
users 列表 / 元素=字典	定义可以访问 SNMP 引擎的用户
acl_v4 字符串	关联的 IPv4 访问列表
acl_v6 字符串	关联的 IPv6 访问列表
authentication 字典	用户的身份验证参数。由于应用的配置未反映在 running-config 中，因此影响模块的幂等性。
algorithm 字符串	选择身份验证算法。选项 `"md5"` `"sha"`
password 字符串	用户的身份验证密码。
encryption 字典	用户的加密参数。由于应用的配置未反映在 running-config 中，因此影响模块的幂等性。
password 字符串	用户的身份验证密码。
priv 字符串	选择加密算法。选项 `"3des"` `"aes"` `"des"`
priv_option 字符串	为特定的 priv 添加额外的选项（如果有）。
group 字符串	用户的 SNMP 组。
remote 字符串	托管 SNMPv3 用户的系统
udp_port 整数	远程 SNMP 系统使用的 UDP 端口
username 字符串	SNMP 用户名
version 字符串	SNMP 安全版本选项 `"v1"` `"v2c"` `"v3"`
version_option 字符串	启用加密版本选项。选项 `"encrypted"`
vrf 字符串	远程 SNMP 实体的 VPN 路由实例
views 列表 / 元素=字典	定义 SNMPv2 MIB 视图
excluded 布尔值	MIB 系列从视图中排除选项 `false` `true`
family_name 字符串	MIB 视图系列名称
included 布尔值	MIB 系列包含在视图中选项 `false` `true`
name 字符串	视图的名称
running_config 字符串	此选项仅在状态为 parsed 时使用。此选项的值应是通过执行命令 show running-config \| include snmp-server 从 IOS 设备收到的输出。状态 parsed 从 `running_config` 选项读取配置，并根据资源模块的 argspec 将其转换为 Ansible 结构化数据，然后该值将返回到结果内的 parsed 键中。
state 字符串	配置应保留的状态。有关更多详细信息，请参阅示例。对于此模块，状态 replaced 和 overridden 的行为相同。选项 `"merged"` ← (默认) `"replaced"` `"overridden"` `"deleted"` `"parsed"` `"gathered"` `"rendered"`

注释 

注意

在 CML 上针对 Cisco IOSXE 版本 17.3 进行了测试。
此模块适用于连接 network_cli。

示例 

# Using state: merged

# Before state:
# -------------

# router-ios#show running-config | section ^snmp-server
# --------------------- EMPTY -----------------

# Merged play:
# ------------

- name: Apply the provided configuration
  cisco.ios.ios_snmp_server:
    config:
      communities:
        - acl_v4: testACL
          name: mergedComm
          rw: true
      contact: contact updated using merged
      engine_id:
        - id: AB0C5342FF0F
          remote:
            host: 172.16.0.12
            udp_port: 25
      groups:
        - group: mergedGroup
          version: v3
          version_option: auth
      file_transfer:
        access_group: test
        protocol:
          - ftp
      hosts:
        - community_string: mergedComm
          host: 172.16.2.9
          informs: true
          traps:
            - msdp
            - stun
            - pki
          version: 2c
        - community_string: mergedComm
          host: 172.16.2.9
          traps:
            - slb
            - pki
      password_policy:
        - change: 3
          digits: 23
          lower_case: 12
          max_len: 24
          policy_name: MergedPolicy
          special_char: 32
          upper_case: 12
        - change: 43
          min_len: 12
          policy_name: MergedPolicy2
          special_char: 22
          upper_case: 12
        - change: 11
          digits: 23
          max_len: 12
          min_len: 12
          policy_name: policy3
          special_char: 22
          upper_case: 12
      traps:
        cef:
          enable: true
          inconsistency: true
          peer_fib_state_change: true
          peer_state_change: true
          resource_failure: true
        msdp: true
        ospf:
          cisco_specific:
            error: true
            lsa: true
            retransmit: true
            state_change:
              nssa_trans_change: true
              shamlink:
                interface: true
                neighbor: true
          error: true
          lsa: true
          retransmit: true
          state_change: true
        syslog: true
        tty: true
      users:
        - acl_v4: "24"
          group: dev
          username: userPaul
          version: v1
    state: merged

# Commands Fired:
# ---------------

# "commands": [
#         "snmp-server contact contact updated using merged",
#         "snmp-server file-transfer access-group test protocol ftp",
#         "snmp-server enable traps msdp",
#         "snmp-server enable traps syslog",
#         "snmp-server enable traps tty",
#         "snmp-server enable traps ospf cisco-specific errors",
#         "snmp-server enable traps ospf cisco-specific retransmit",
#         "snmp-server enable traps ospf cisco-specific lsa",
#         "snmp-server enable traps ospf cisco-specific state-change nssa-trans-change",
#         "snmp-server enable traps ospf cisco-specific state-change shamlink interface",
#         "snmp-server enable traps ospf cisco-specific state-change shamlink neighbor",
#         "snmp-server enable traps ospf errors",
#         "snmp-server enable traps ospf retransmit",
#         "snmp-server enable traps ospf lsa",
#         "snmp-server enable traps ospf state-change",
#         "snmp-server enable traps cef resource-failure peer-state-change peer-fib-state-change inconsistency",
#         "snmp-server host 172.16.2.9 informs version 2c mergedComm msdp stun pki",
#         "snmp-server host 172.16.2.9 mergedComm slb pki",
#         "snmp-server group mergedGroup v3 auth",
#         "snmp-server engineID remote 172.16.0.12 udp-port 25 AB0C5342FF0F",
#         "snmp-server community mergedComm rw testACL",
#         "snmp-server password-policy MergedPolicy define max-len 24 upper-case 12 lower-case 12 special-char 32 digits 23 change 3",
#         "snmp-server password-policy MergedPolicy2 define min-len 12 upper-case 12 special-char 22 change 43",
#         "snmp-server password-policy policy3 define min-len 12 max-len 12 upper-case 12 special-char 22 digits 23 change 11",
#         "snmp-server user userPaul dev v1 access 24"
# ],

# After state:
# ------------

# router-ios#show running-config | section ^snmp-server
# snmp-server engineID remote 172.16.0.12 udp-port 25 AB0C5342FF0F
# snmp-server user userPaul dev v1 access 24
# snmp-server group mergedGroup v3 auth
# snmp-server community mergedComm RW testACL
# snmp-server contact contact updated using merged
# snmp-server enable traps tty
# snmp-server enable traps ospf state-change
# snmp-server enable traps ospf errors
# snmp-server enable traps ospf retransmit
# snmp-server enable traps ospf lsa
# snmp-server enable traps ospf cisco-specific state-change nssa-trans-change
# snmp-server enable traps ospf cisco-specific state-change shamlink interface
# snmp-server enable traps ospf cisco-specific state-change shamlink neighbor
# snmp-server enable traps ospf cisco-specific errors
# snmp-server enable traps ospf cisco-specific retransmit
# snmp-server enable traps ospf cisco-specific lsa
# snmp-server enable traps cef resource-failure peer-state-change peer-fib-state-change inconsistency
# snmp-server enable traps msdp
# snmp-server enable traps syslog
# snmp-server host 172.16.2.9 informs version 2c mergedComm  msdp stun pki
# snmp-server host 172.16.2.9 mergedComm  slb pki
# snmp-server file-transfer access-group test protocol ftp
# snmp-server password-policy MergedPolicy define max-len 24 upper-case 12 lower-case 12 special-char 32 digits 23 change 3
# snmp-server password-policy MergedPolicy2 define min-len 12 upper-case 12 special-char 22 change 43
# snmp-server password-policy policy3 define min-len 12 max-len 12 upper-case 12 special-char 22 digits 23 change 11

# Using state: deleted

# Before state:
# -------------

# router-ios#show running-config | section ^snmp-server
# snmp-server engineID remote 172.16.0.12 udp-port 25 AB0C5342FF0F
# snmp-server user userPaul dev v1 access 24
# snmp-server group mergedGroup v3 auth
# snmp-server community mergedComm RW testACL
# snmp-server contact contact updated using merged
# snmp-server enable traps tty
# snmp-server enable traps ospf state-change
# snmp-server enable traps ospf errors
# snmp-server enable traps ospf retransmit
# snmp-server enable traps ospf lsa
# snmp-server enable traps ospf cisco-specific state-change nssa-trans-change
# snmp-server enable traps ospf cisco-specific state-change shamlink interface
# snmp-server enable traps ospf cisco-specific state-change shamlink neighbor
# snmp-server enable traps ospf cisco-specific errors
# snmp-server enable traps ospf cisco-specific retransmit
# snmp-server enable traps ospf cisco-specific lsa
# snmp-server enable traps cef resource-failure peer-state-change peer-fib-state-change inconsistency
# snmp-server enable traps msdp
# snmp-server enable traps syslog
# snmp-server host 172.16.2.9 informs version 2c mergedComm  msdp stun pki
# snmp-server host 172.16.2.9 mergedComm  slb pki
# snmp-server file-transfer access-group test protocol ftp
# snmp-server password-policy MergedPolicy define max-len 24 upper-case 12 lower-case 12 special-char 32 digits 23 change 3
# snmp-server password-policy MergedPolicy2 define min-len 12 upper-case 12 special-char 22 change 43
# snmp-server password-policy policy3 define min-len 12 max-len 12 upper-case 12 special-char 22 digits 23 change 11

# Deleted play:
# -------------

- name: Remove all existing configuration
  cisco.ios.ios_snmp_server:
    state: deleted

# Commands Fired:
# ---------------

# "commands": [
#     "no snmp-server contact contact updated using merged",
#     "no snmp-server file-transfer access-group test protocol ftp",
#     "no snmp-server enable traps msdp",
#     "no snmp-server enable traps syslog",
#     "no snmp-server enable traps tty",
#     "no snmp-server enable traps ospf cisco-specific errors",
#     "no snmp-server enable traps ospf cisco-specific retransmit",
#     "no snmp-server enable traps ospf cisco-specific lsa",
#     "no snmp-server enable traps ospf cisco-specific state-change nssa-trans-change",
#     "no snmp-server enable traps ospf cisco-specific state-change shamlink interface",
#     "no snmp-server enable traps ospf cisco-specific state-change shamlink neighbor",
#     "no snmp-server enable traps ospf errors",
#     "no snmp-server enable traps ospf retransmit",
#     "no snmp-server enable traps ospf lsa",
#     "no snmp-server enable traps ospf state-change",
#     "no snmp-server enable traps cef resource-failure peer-state-change peer-fib-state-change inconsistency",
#     "no snmp-server host 172.16.2.9 informs version 2c mergedComm msdp stun pki",
#     "no snmp-server host 172.16.2.9 mergedComm slb pki",
#     "no snmp-server group mergedGroup v3 auth",
#     "no snmp-server engineID remote 172.16.0.12 udp-port 25 AB0C5342FF0F",
#     "no snmp-server community mergedComm rw testACL",
#     "no snmp-server password-policy MergedPolicy define max-len 24 upper-case 12 lower-case 12 special-char 32 digits 23 change 3",
#     "no snmp-server password-policy MergedPolicy2 define min-len 12 upper-case 12 special-char 22 change 43",
#     "no snmp-server password-policy policy3 define min-len 12 max-len 12 upper-case 12 special-char 22 digits 23 change 11",
#     "no snmp-server user userPaul dev v1 access 24"
# ],

# After state:
# ------------

# router-ios#show running-config | section ^snmp-server
# --------------------- EMPTY -----------------

# Using state: overridden

# Before state:
# -------------

# router-ios#show running-config | section ^snmp-server
# snmp-server engineID remote 172.16.0.12 udp-port 25 AB0C5342FF0F
# snmp-server user userPaul dev v1 access 24
# snmp-server group mergedGroup v3 auth
# snmp-server community mergedComm RW testACL
# snmp-server contact contact updated using merged
# snmp-server enable traps tty
# snmp-server enable traps ospf state-change
# snmp-server enable traps ospf errors
# snmp-server enable traps ospf retransmit
# snmp-server enable traps ospf lsa
# snmp-server enable traps ospf cisco-specific state-change nssa-trans-change
# snmp-server enable traps ospf cisco-specific state-change shamlink interface
# snmp-server enable traps ospf cisco-specific state-change shamlink neighbor
# snmp-server enable traps ospf cisco-specific errors
# snmp-server enable traps ospf cisco-specific retransmit
# snmp-server enable traps ospf cisco-specific lsa
# snmp-server enable traps cef resource-failure peer-state-change peer-fib-state-change inconsistency
# snmp-server enable traps msdp
# snmp-server enable traps syslog
# snmp-server host 172.16.2.9 informs version 2c mergedComm  msdp stun pki
# snmp-server host 172.16.2.9 mergedComm  slb pki
# snmp-server file-transfer access-group test protocol ftp
# snmp-server password-policy MergedPolicy define max-len 24 upper-case 12 lower-case 12 special-char 32 digits 23 change 3
# snmp-server password-policy MergedPolicy2 define min-len 12 upper-case 12 special-char 22 change 43
# snmp-server password-policy policy3 define min-len 12 max-len 12 upper-case 12 special-char 22 digits 23 change 11

# Overridden play:
# ----------------

- name: Override commands with provided configuration
  cisco.ios.ios_snmp_server:
    config:
      location: "location entry for snmp"
      packet_size: 500
      communities:
        - acl_v4: acl_uq
          name: communityOverriden
          rw: true
    state: overridden

# Commands Fired:
# ---------------
# "commands": [
#       "no snmp-server contact contact updated using merged",
#       "no snmp-server file-transfer access-group test protocol ftp",
#       "snmp-server location location entry for snmp",
#       "snmp-server packetsize 500",
#       "no snmp-server enable traps msdp",
#       "no snmp-server enable traps syslog",
#       "no snmp-server enable traps tty",
#       "no snmp-server enable traps ospf cisco-specific errors",
#       "no snmp-server enable traps ospf cisco-specific retransmit",
#       "no snmp-server enable traps ospf cisco-specific lsa",
#       "no snmp-server enable traps ospf cisco-specific state-change nssa-trans-change",
#       "no snmp-server enable traps ospf cisco-specific state-change shamlink interface",
#       "no snmp-server enable traps ospf cisco-specific state-change shamlink neighbor",
#       "no snmp-server enable traps ospf errors",
#       "no snmp-server enable traps ospf retransmit",
#       "no snmp-server enable traps ospf lsa",
#       "no snmp-server enable traps ospf state-change",
#       "no snmp-server enable traps cef resource-failure peer-state-change peer-fib-state-change inconsistency",
#       "no snmp-server host 172.16.2.9 informs version 2c mergedComm msdp stun pki",
#       "no snmp-server host 172.16.2.9 mergedComm slb pki",
#       "no snmp-server group mergedGroup v3 auth",
#       "no snmp-server engineID remote 172.16.0.12 udp-port 25 AB0C5342FF0F",
#       "snmp-server community communityOvverriden rw acl_uq",
#       "no snmp-server community mergedComm rw testACL",
#       "no snmp-server password-policy MergedPolicy define max-len 24 upper-case 12 lower-case 12 special-char 32 digits 23 change 3",
#       "no snmp-server password-policy MergedPolicy2 define min-len 12 upper-case 12 special-char 22 change 43",
#       "no snmp-server password-policy policy3 define min-len 12 max-len 12 upper-case 12 special-char 22 digits 23 change 11",
#       "no snmp-server user userPaul dev v1 access 24"
#     ],

# After state:
# ------------

# router-ios#show running-config | section ^snmp-server
# snmp-server community communityOverriden RW acl_uq
# snmp-server packetsize 500
# snmp-server location location entry for snmp

# Using state: replaced

# Before state:
# -------------

# router-ios#show running-config | section ^snmp-server
# snmp-server community communityOverriden RW acl_uq
# snmp-server packetsize 500
# snmp-server location location entry for snmp

# Replaced play:
# --------------

- name: Replace commands with provided configuration
  cisco.ios.ios_snmp_server:
    config:
      location: "updated location entry"
      packet_size: 500
      communities:
        - acl_v4: acl_uq
          name: communityOverriden
          rw: true
    state: replaced

# Commands Fired:
# ---------------

# "commands": [
#     "snmp-server location updated location entry"
#     ],

# After state:
# ------------

# router-ios#show running-config | section ^snmp-server
# snmp-server community communityOverriden RW acl_uq
# snmp-server packetsize 500
# snmp-server location updated location entry

# Using state: gathered

# Before state:
# -------------

# router-ios#show running-config | section ^snmp-server
# snmp-server engineID remote 172.16.0.12 udp-port 25 AB0C5342FF0F
# snmp-server user userPaul dev v1 access 24
# snmp-server group mergedGroup v3 auth
# snmp-server community communityOvverriden RW acl_uq
# snmp-server community mergedComm RW testACL
# snmp-server packetsize 500
# snmp-server location updated location entry
# snmp-server contact contact updated using merged
# snmp-server enable traps tty
# snmp-server enable traps ospf state-change
# snmp-server enable traps ospf errors
# snmp-server enable traps ospf retransmit
# snmp-server enable traps ospf lsa
# snmp-server enable traps ospf cisco-specific state-change nssa-trans-change
# snmp-server enable traps ospf cisco-specific state-change shamlink interface
# snmp-server enable traps ospf cisco-specific state-change shamlink neighbor
# snmp-server enable traps ospf cisco-specific errors
# snmp-server enable traps ospf cisco-specific retransmit
# snmp-server enable traps ospf cisco-specific lsa
# snmp-server enable traps cef resource-failure peer-state-change peer-fib-state-change inconsistency
# snmp-server enable traps msdp
# snmp-server enable traps syslog
# snmp-server host 172.16.2.9 informs version 2c mergedComm  msdp stun pki
# snmp-server host 172.16.2.9 mergedComm  slb pki
# snmp-server file-transfer access-group test protocol ftp
# snmp-server password-policy MergedPolicy define max-len 24 upper-case 12 lower-case 12 special-char 32 digits 23 change 3
# snmp-server password-policy MergedPolicy2 define min-len 12 upper-case 12 special-char 22 change 43
# snmp-server password-policy policy3 define min-len 12 max-len 12 upper-case 12 special-char 22 digits 23 change 11

# Gathered play:
# --------------

- name: Gather listed snmp config
  cisco.ios.ios_snmp_server:
    state: gathered

# Module Execution Result:
# ------------------------

#   "gathered": {
#         "communities": [
#             {
#                 "acl_v4": "acl_uq",
#                 "name": "communityOvverriden",
#                 "rw": true
#             },
#             {
#                 "acl_v4": "testACL",
#                 "name": "mergedComm",
#                 "rw": true
#             }
#         ],
#         "contact": "contact updated using merged",
#         "engine_id": [
#             {
#                 "id": "AB0C5342FF0F",
#                 "remote": {
#                     "host": "172.16.0.12",
#                     "udp_port": 25
#                 }
#             }
#         ],
#         "file_transfer": {
#             "access_group": "test",
#             "protocol": [
#                 "ftp"
#             ]
#         },
#         "groups": [
#             {
#                 "group": "mergedGroup",
#                 "version": "v3",
#                 "version_option": "auth"
#             }
#         ],
#         "hosts": [
#             {
#                 "community_string": "mergedComm",
#                 "host": "172.16.2.9",
#                 "informs": true,
#                 "traps": [
#                     "msdp",
#                     "stun",
#                     "pki"
#                 ],
#                 "version": "2c"
#             },
#             {
#                 "community_string": "mergedComm",
#                 "host": "172.16.2.9",
#                 "traps": [
#                     "slb",
#                     "pki"
#                 ]
#             }
#         ],
#         "location": "updated location entry",
#         "packet_size": 500,
#         "password_policy": [
#             {
#                 "change": 3,
#                 "digits": 23,
#                 "lower_case": 12,
#                 "max_len": 24,
#                 "policy_name": "MergedPolicy",
#                 "special_char": 32,
#                 "upper_case": 12
#             },
#             {
#                 "change": 43,
#                 "min_len": 12,
#                 "policy_name": "MergedPolicy2",
#                 "special_char": 22,
#                 "upper_case": 12
#             },
#             {
#                 "change": 11,
#                 "digits": 23,
#                 "max_len": 12,
#                 "min_len": 12,
#                 "policy_name": "policy3",
#                 "special_char": 22,
#                 "upper_case": 12
#             }
#         ],
#         "traps": {
#             "cef": {
#                 "enable": true,
#                 "inconsistency": true,
#                 "peer_fib_state_change": true,
#                 "peer_state_change": true,
#                 "resource_failure": true
#             },
#             "msdp": true,
#             "ospf": {
#                 "cisco_specific": {
#                     "error": true,
#                     "lsa": true,
#                     "retransmit": true,
#                     "state_change": {
#                         "nssa_trans_change": true,
#                         "shamlink": {
#                             "interface": true,
#                             "neighbor": true
#                         }
#                     }
#                 },
#                 "error": true,
#                 "lsa": true,
#                 "retransmit": true,
#                 "state_change": true
#             },
#             "syslog": true,
#             "tty": true
#         },
#         "users": [
#             {
#                 "acl_v4": "24",
#                 "group": "dev",
#                 "username": "userPaul",
#                 "version": "v1"
#             }
#         ]
#     },

# Using state: rendered

# Rendered play:
# --------------

- name: Render the commands for provided configuration
  cisco.ios.ios_snmp_server:
    config:
      accounting:
        command: default
      cache: 2
      chassis_id: entry for chassis id
      communities:
        - acl_v6: te
          name: test
          ro: true
          view: terst1
        - acl_v4: "1322"
          name: wete
          ro: true
        - acl_v4: paul
          name: weteww
          rw: true
      contact: details contact
      context:
        - contextA
        - contextB
      engine_id:
        - id: AB0C5342FA0A
          local: true
        - id: AB0C5342FAAB
          remote:
            host: 172.16.0.2
            udp_port: 23
        - id: AB0C5342FAAA
          remote:
            host: 172.16.0.1
            udp_port: 22
      file_transfer:
        access_group: testAcl
        protocol:
          - ftp
          - rcp
      groups:
        - group: grpFamily
          version: v3
          version_option: auth
        - context: mycontext
          group: grpFamily
          version: v1
        - acl_v4: "2"
          group: grp1
          notify: me
          version: v1
        - group: newtera
          version: v3
          version_option: priv
        - group: relaplacing
          version: v3
          version_option: noauth
      hosts:
        - community_string: check
          host: 172.16.2.99
          informs: true
          traps:
            - msdp
            - stun
          version: 2c
        - community_string: check
          host: 172.16.2.99
          traps:
            - slb
            - pki
        - community_string: checktrap
          host: 172.16.2.99
          traps:
            - isis
            - hsrp
        - community_string: newtera
          host: 172.16.2.1
          traps:
            - rsrb
            - pim
            - rsvp
            - slb
            - pki
          version: "3"
          version_option: priv
        - community_string: relaplacing
          host: 172.16.2.1
          traps:
            - slb
            - pki
          version: "3"
          version_option: noauth
        - community_string: trapsac
          host: 172.16.2.1
          traps:
            - tty
            - bgp
          version: 2c
        - community_string: www
          host: 172.16.1.1
          traps:
            - tty
            - bgp
          version: "3"
          version_option: auth
      inform:
        pending: 2
      ip:
        dscp: 2
      location: "entry for snmp location"
      packet_size: 500
      password_policy:
        - change: 3
          digits: 23
          lower_case: 12
          max_len: 24
          policy_name: policy1
          special_char: 32
          upper_case: 12
        - change: 9
          min_len: 12
          policy_name: policy2
          special_char: 22
          upper_case: 12
        - change: 11
          digits: 23
          max_len: 12
          min_len: 12
          policy_name: policy3
          special_char: 22
          upper_case: 12
      queue_length: 2
      source_interface: Loopback999
      system_shutdown: true
      trap_source: GigabitEthernet0/0
      trap_timeout: 2
      traps:
        auth_framework:
          enable: true
        bgp:
          cbgp2: true
          enable: true
        bfd:
          enable: true
          session_down: true
          session_up: true
        bridge:
          enable: true
          newroot: true
          topologychange: true
        casa: true
        cef:
          enable: true
          inconsistency: true
          peer_fib_state_change: true
          peer_state_change: true
          resource_failure: true
        dlsw:
          enable: true
        eigrp: true
        ethernet:
          cfm:
            alarm: true
          evc:
            status: true
        event_manager: true
        flowmon: true
        frame_relay:
          enable: true
          subif:
            enable: true
        hsrp: true
        ike:
          policy:
            add: true
            delete: true
          tunnel:
            start: true
            stop: true
        ipmulticast: true
        ipsec:
          cryptomap:
            add: true
            attach: true
            delete: true
            detach: true
          too_many_sas: true
          tunnel:
            start: true
            stop: true
        ipsla: true
        l2tun:
          pseudowire_status: true
          session: true
        msdp: true
        ospf:
          cisco_specific:
            error: true
            lsa: true
            retransmit: true
            state_change:
              nssa_trans_change: true
              shamlink:
                interface: true
                neighbor: true
          error: true
          lsa: true
          retransmit: true
          state_change: true
        pim:
          enable: true
          invalid_pim_message: true
          neighbor_change: true
          rp_mapping_change: true
        pki: true
        rsvp: true
        snmp:
          authentication: true
          coldstart: true
          linkdown: true
          linkup: true
          warmstart: true
        syslog: true
        tty: true
      users:
        - acl_v4: "24"
          group: groupFamily
          username: paul
          version: v1
        - acl_v4: ipv6
          group: groupFamily
          username: domnic
          version: v3
        - group: relaplacing
          username: relaplacing
          version: v3
    state: rendered

# Module Execution Result:
# ------------------------

# "rendered": [
#     "snmp-server accounting commands default",
#     "snmp-server cache interval 2",
#     "snmp-server chassis-id entry for chassis id",
#     "snmp-server contact details contact",
#     "snmp-server file-transfer access-group testAcl protocol ftp rcp",
#     "snmp-server inform pending 2",
#     "snmp-server ip dscp 2",
#     "snmp-server location entry for snmp location",
#     "snmp-server packetsize 500",
#     "snmp-server queue-length 2",
#     "snmp-server trap timeout 2",
#     "snmp-server source-interface informs Loopback999",
#     "snmp-server trap-source GigabitEthernet0/0",
#     "snmp-server system-shutdown",
#     "snmp-server enable traps auth-framework",
#     "snmp-server enable traps bfd session-down session-up",
#     "snmp-server enable traps bgp cbgp2",
#     "snmp-server enable traps bridge newroot topologychange",
#     "snmp-server enable traps casa",
#     "snmp-server enable traps eigrp",
#     "snmp-server enable traps event-manager",
#     "snmp-server enable traps flowmon",
#     "snmp-server enable traps hsrp",
#     "snmp-server enable traps ipsla",
#     "snmp-server enable traps msdp",
#     "snmp-server enable traps pki",
#     "snmp-server enable traps rsvp",
#     "snmp-server enable traps syslog",
#     "snmp-server enable traps tty",
#     "snmp-server enable traps ipmulticast",
#     "snmp-server enable traps ike policy add",
#     "snmp-server enable traps ike policy delete",
#     "snmp-server enable traps ike tunnel start",
#     "snmp-server enable traps ike tunnel stop",
#     "snmp-server enable traps ipsec cryptomap add",
#     "snmp-server enable traps ipsec cryptomap delete",
#     "snmp-server enable traps ipsec cryptomap attach",
#     "snmp-server enable traps ipsec cryptomap detach",
#     "snmp-server enable traps ipsec tunnel start",
#     "snmp-server enable traps ipsec tunnel stop",
#     "snmp-server enable traps ipsec too-many-sas",
#     "snmp-server enable traps ospf cisco-specific errors",
#     "snmp-server enable traps ospf cisco-specific retransmit",
#     "snmp-server enable traps ospf cisco-specific lsa",
#     "snmp-server enable traps ospf cisco-specific state-change nssa-trans-change",
#     "snmp-server enable traps ospf cisco-specific state-change shamlink interface",
#     "snmp-server enable traps ospf cisco-specific state-change shamlink neighbor",
#     "snmp-server enable traps ospf errors",
#     "snmp-server enable traps ospf retransmit",
#     "snmp-server enable traps ospf lsa",
#     "snmp-server enable traps ospf state-change",
#     "snmp-server enable traps l2tun pseudowire status",
#     "snmp-server enable traps l2tun session",
#     "snmp-server enable traps pim neighbor-change rp-mapping-change invalid-pim-message",
#     "snmp-server enable traps snmp authentication linkdown linkup warmstart coldstart",
#     "snmp-server enable traps frame-relay",
#     "snmp-server enable traps cef resource-failure peer-state-change peer-fib-state-change inconsistency",
#     "snmp-server enable traps dlsw",
#     "snmp-server enable traps ethernet evc status",
#     "snmp-server enable traps ethernet cfm alarm",
#     "snmp-server host 172.16.2.99 informs version 2c check msdp stun",
#     "snmp-server host 172.16.2.99 check slb pki",
#     "snmp-server host 172.16.2.99 checktrap isis hsrp",
#     "snmp-server host 172.16.2.1 version 3 priv newtera rsrb pim rsvp slb pki",
#     "snmp-server host 172.16.2.1 version 3 noauth relaplacing slb pki",
#     "snmp-server host 172.16.2.1 version 2c trapsac tty bgp",
#     "snmp-server host 172.16.1.1 version 3 auth www tty bgp",
#     "snmp-server group grpFamily v1 context mycontext",
#     "snmp-server group grp1 v1 notify me access 2",
#     "snmp-server group newtera v3 priv",
#     "snmp-server group relaplacing v3 noauth",
#     "snmp-server engineID local AB0C5342FA0A",
#     "snmp-server engineID remote 172.16.0.2 udp-port 23 AB0C5342FAAB",
#     "snmp-server engineID remote 172.16.0.1 udp-port 22 AB0C5342FAAA",
#     "snmp-server community test view terst1 ro ipv6 te",
#     "snmp-server community wete ro 1322",
#     "snmp-server community weteww rw paul",
#     "snmp-server context contextA",
#     "snmp-server context contextB",
#     "snmp-server password-policy policy1 define max-len 24 upper-case 12 lower-case 12 special-char 32 digits 23 change 3",
#     "snmp-server password-policy policy2 define min-len 12 upper-case 12 special-char 22 change 9",
#     "snmp-server password-policy policy3 define min-len 12 max-len 12 upper-case 12 special-char 22 digits 23 change 11",
#     "snmp-server user paul groupFamily v1 access 24",
#     "snmp-server user domnic groupFamily v3 access ipv6",
#     "snmp-server user relaplacing relaplacing v3"
# ]

# Using state: parsed

# File: parsed.cfg
# ----------------

# snmp-server engineID local AB0C5342FA0A
# snmp-server engineID remote 172.16.0.2 udp-port 23 AB0C5342FAAB
# snmp-server engineID remote 172.16.0.1 udp-port 22 AB0C5342FAAA
# snmp-server user newuser newfamily v1 access 24
# snmp-server user paul familypaul v3 access ipv6 ipv6acl
# snmp-server user replaceUser replaceUser v3
# snmp-server group group0 v3 auth
# snmp-server group group1 v1 notify me access 2
# snmp-server group group2 v3 priv
# snmp-server group replaceUser v3 noauth
# snmp-server community commu1 view view1 RO ipv6 te
# snmp-server community commu2 RO 1322
# snmp-server community commu3 RW paul
# snmp-server trap timeout 2
# snmp-server trap-source GigabitEthernet0/0
# snmp-server source-interface informs Loopback999
# snmp-server packetsize 500
# snmp-server enable traps vrfmib vrf-up vrf-down vnet-trunk-up vnet-trunk-down
# snmp-server host 172.16.2.99 informs version 2c check  msdp stun
# snmp-server host 172.16.2.1 version 2c trapsac  tty bgp
# snmp-server host 172.16.1.1 version 3 auth group0  tty bgp
# snmp-server context contextWord1
# snmp-server context contextWord2
# snmp-server file-transfer access-group testAcl protocol ftp
# snmp-server file-transfer access-group testAcl protocol rcp
# snmp-server cache interval 2
# snmp-server password-policy policy2 define min-len 12 upper-case 12 special-char 22 change 9
# snmp-server password-policy policy3 define min-len 12 max-len 12 upper-case 12 special-char 22 digits 23 change 11
# snmp-server accounting commands default
# snmp-server inform pending 2

# Parsed play:
# ------------

- name: Parse the provided configuration with the existing running configuration
  cisco.ios.ios_snmp_server:
    running_config: "{{ lookup('file', 'parsed.cfg') }}"
    state: parsed

# Module Execution Result:
# ------------------------
#
#  "parsed": {
#     "accounting": {
#         "command": "default"
#     },
#     "cache": 2,
#     "communities": [
#         {
#             "acl_v6": "te",
#             "name": "commu1",
#             "ro": true,
#             "view": "view1"
#         },
#         {
#             "acl_v4": "1322",
#             "name": "commu2",
#             "ro": true
#         },
#         {
#             "acl_v4": "paul",
#             "name": "commu3",
#             "rw": true
#         }
#     ],
#     "context": [
#         "contextWord1",
#         "contextWord2"
#     ],
#     "engine_id": [
#         {
#             "id": "AB0C5342FA0A",
#             "local": true
#         },
#         {
#             "id": "AB0C5342FAAA",
#             "remote": {
#                 "host": "172.16.0.1",
#                 "udp_port": 22
#             }
#         },
#         {
#             "id": "AB0C5342FAAB",
#             "remote": {
#                 "host": "172.16.0.2",
#                 "udp_port": 23
#             }
#         }
#     ],
#     "file_transfer": {
#         "access_group": "testAcl",
#         "protocol": [
#             "rcp",
#             "ftp"
#         ]
#     },
#     "groups": [
#         {
#             "group": "group0",
#             "version": "v3",
#             "version_option": "auth"
#         },
#         {
#             "acl_v4": "2",
#             "group": "group1",
#             "notify": "me",
#             "version": "v1"
#         },
#         {
#             "group": "group2",
#             "version": "v3",
#             "version_option": "priv"
#         },
#         {
#             "group": "replaceUser",
#             "version": "v3",
#             "version_option": "noauth"
#         }
#     ],
#     "hosts": [
#         {
#             "community_string": "group0",
#             "host": "172.16.1.1",
#             "traps": [
#                 "tty",
#                 "bgp"
#             ],
#             "version": "3",
#             "version_option": "auth"
#         },
#         {
#             "community_string": "trapsac",
#             "host": "172.16.2.1",
#             "traps": [
#                 "tty",
#                 "bgp"
#             ],
#             "version": "2c"
#         },
#         {
#             "community_string": "check",
#             "host": "172.16.2.99",
#             "informs": true,
#             "traps": [
#                 "msdp",
#                 "stun"
#             ],
#             "version": "2c"
#         }
#     ],
#     "inform": {
#         "pending": 2
#     },
#     "packet_size": 500,
#     "password_policy": [
#         {
#             "change": 9,
#             "min_len": 12,
#             "policy_name": "policy2",
#             "special_char": 22,
#             "upper_case": 12
#         },
#         {
#             "change": 11,
#             "digits": 23,
#             "max_len": 12,
#             "min_len": 12,
#             "policy_name": "policy3",
#             "special_char": 22,
#             "upper_case": 12
#         }
#     ],
#     "source_interface": "Loopback999",
#     "trap_source": "GigabitEthernet0/0",
#     "trap_timeout": 2,
#     "traps": {
#         "vrfmib": {
#             "vnet_trunk_down": true,
#             "vnet_trunk_up": true,
#             "vrf_down": true,
#             "vrf_up": true
#         }
#     },
#     "users": [
#         {
#             "acl_v4": "24",
#             "group": "newfamily",
#             "username": "newuser",
#             "version": "v1"
#         },
#         {
#             "acl_v4": "ipv6",
#             "group": "familypaul",
#             "username": "paul",
#             "version": "v3"
#         },
#         {
#             "group": "replaceUser",
#             "username": "replaceUser",
#             "version": "v3"
#         }
#     ]
# }

返回值 

常见的返回值在此处记录此处，以下是此模块独有的字段

键	描述
after 字典	模块执行后的结果配置。返回: 当更改时示例: `"此输出将始终与模块 argspec 的格式相同。\n"`
before 字典	模块执行之前的配置。返回: 当 state 为 `merged`、`replaced`、`overridden`、`deleted` 或 `purged` 时示例: `"此输出将始终与模块 argspec 的格式相同。\n"`
commands 列表 / 元素=字符串	推送到远程设备的命令集。返回: 当 state 为 `merged`、`replaced`、`overridden`、`deleted` 或 `purged` 时示例： `["snmp-server host 172.16.2.99 informs version 2c check msdp stun", "snmp-server engineID remote 172.16.0.2 udp-port 23 AB0C5342FAAB", "snmp-server group grp1 v1 notify me access 2"]`
已收集列表 / 元素=字符串	从远程设备收集的网络资源的相关信息，以结构化数据的形式呈现。返回：当 state 为 `gathered` 时示例： `["此输出的格式将始终与模块的参数规范相同。\n"]`
已解析列表 / 元素=字符串	根据模块的参数规范，将 running_config 选项中提供的设备原生配置解析为结构化数据。返回：当 state 为 `parsed` 时示例： `["此输出的格式将始终与模块的参数规范相同。\n"]`
已渲染列表 / 元素=字符串	任务中提供的配置以设备原生格式呈现（离线）。返回：当 state 为 `rendered` 时示例： `["snmp-server enable traps ipsec cryptomap attach", "snmp-server password-policy policy1 define max-len 24 upper-case 12 lower-case 12 special-char 32 digits 23 change 3", "snmp-server cache interval 2"]`

作者

Sagar Paul (@KB-perByte)