cisco.ios.ios_snmp_server модуль — Модуль ресурсов для настройки сервера snmp.

Примечание

Этот модуль является частью коллекции cisco.ios (версия 8.0.0).

У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install cisco.ios.

Для использования в playbook укажите: cisco.ios.ios_snmp_server.

Новая в cisco.ios 2.6.0

Описание
Параметры
Примечания
Примеры
Возвращаемые значения

Описание

Этот модуль предоставляет декларативное управление сервером SNMP на устройствах Cisco IOS.

Псевдонимы: snmp_server

Параметры

Параметр	Комментарии
config словарь	Словарь конфигурации SNMP-сервера
accounting словарь	Параметры учёта SNMP
command строка	Для команд SNMP set
cache целое число	Включить кеш SNMP и интервал истечения срока действия MIB
chassis_id строка	Строка для уникальной идентификации этого шасси (шестнадцатеричный код)
communities список / элементы=словарь	Конфигурация имени сообщества.
acl_v4 строка	Имя стандартного списка управления доступом
acl_v6 строка	Имя списка управления доступом IPv6
name строка	Имя сообщества (по умолчанию Чтение)
ro булево	Разрешены только операции чтения Варианты: `false` `true`
rw булево	Доступ для чтения и записи Варианты: `false` `true`
view строка	Имя просмотра MIB
contact строка	Текст для объекта mib sysContact
context список / элементы=строка	Создание/удаление контекста помимо стандартного
drop словарь	Безмолвно отбрасывать пакеты SNMP
unknown_user булево	Безмолвно отбрасывать пакеты неизвестных пользователей v3 Варианты: `false` `true`
vrf_traffic булево	Безмолвно отбрасывать пакеты SNMP, которые поступают на интерфейсы VRF Варианты: `false` `true`
engine_id список / элементы=словарь	Настройка локального или удалённого SNMPv3 engineID
id строка	строка octet engine ID
local булево	Локальный агент SNMP Варианты: `false` `true`
remote словарь	Удалённый агент SNMP
host строка	Имя хоста или IP-адрес удалённого хоста оповещения SNMP
udp_port целое число	Номер UDP-порта удалённого хоста оповещения SNMP.
vrf строка	VPN-инстанция маршрутизации удалённого хоста оповещения.
file_transfer словарь	Команды, связанные с передачей файлов
access_group строка	Контроль доступа к передаче файлов

protocol list / elements=string	Протокол управления доступом для передачи файлов
groups list / elements=dictionary	Определение группы модели безопасности пользователя
acl_v4 string	указать список доступа, связанный с этой группой
acl_v6 string	указать список доступа, связанный с этой группой
context string	Укажите контекст для связи с группой
group string	Группа SNMP для пользователя
match string	Укажите критерии соответствия имени контекста Варианты: `"exact"` `"prefix"`
notify string	Представление для ограничения уведомлений
read string	Представление для ограничения доступа на чтение
version string	версия группы безопасности snmp Варианты: `"v1"` `"v3"` `"v2c"`
version_option string	имя сообщества для хоста. Варианты: `"auth"` `"noauth"` `"priv"`
write string	Представление для ограничения доступа на запись
hosts list / elements=dictionary	Укажите хосты для получения уведомлений SNMP
community_string string	Строка сообщества SNMPv1/v2c или имя пользователя SNMPv3
host string	Имя хоста или IP-адрес хоста уведомлений SNMP.
informs boolean	Использовать сообщения SNMP inform. Варианты: `false` `true`
traps list / elements=string	Использовать сообщения SNMP trap
version string	Версия SNMP сообщения уведомления. Варианты: `"1"` `"2c"` `"3"`
version_option string	имя сообщества для хоста. Варианты: `"auth"` `"noauth"` `"priv"`
vrf string	Укажите VRF, в котором настроен хост
if_index boolean	Включить сохранение ifindex Варианты: `false` `true`
inform dictionary	Настройка параметров SNMP Informs
pending integer	Установить количество неподтвержденных inform для хранения
retries integer	Установить количество попыток для inform
timeout integer	Установить тайм-аут для inform

ip dictionary	Конфигурация IP ToS для трафика SNMP
dscp integer	Значение IP DSCP для трафика SNMP
precedence integer	Значение IP Precedence для трафика SNMP
location string	Текст для объекта MIB sysLocation
manager integer	Изменение параметров SNMP-менеджера
packet_size integer	Максимальный размер пакета SNMP
password_policy list / elements=dictionary	Политика паролей для пользователей SNMP v3
change integer	Количество изменений символов между старым и новым паролем
digits integer	Количество цифр
lower_case integer	Количество символов в нижнем регистре
max_len integer	Максимальная длина пароля
min_len integer	Минимальная длина пароля
policy_name string	Имя политики
special_char integer	Количество специальных символов
upper_case integer	Количество символов в верхнем регистре
username string	Имя пользователя
queue_length integer	Длина очереди сообщений для каждого хоста TRAP
source_interface string	Исходный интерфейс, используемый для отправки уведомлений SNMP.
system_shutdown boolean	Включить использование команды перезагрузки SNMP Варианты: `false` `true`
trap_source string	Назначить интерфейс для исходного адреса всех trap-сообщений
trap_timeout integer	Установить тайм-аут для повторной передачи сообщений TRAP
traps dictionary	Включить SNMP Traps
aaa_server boolean	Включить SNMP AAA Server traps Варианты: `false` `true`
auth_framework dictionary	Включить SNMP CISCO-AUTH-FRAMEWORK-MIB traps
enable boolean	Включить/выключить механизм аутентификации Варианты: `false` `true`
sec_violation boolean	Режим sec_violation Варианты: `false` `true`
bfd dictionary	Разрешить SNMP BFD traps

enable boolean	Включить/выключить bfd Choices: `false` `true`
session_down boolean	Включить ловушки BFD о разрыве сессии Choices: `false` `true`
session_up boolean	Включить ловушки BFD об установлении сессии Choices: `false` `true`
bgp dictionary	Разрешить ловушки bgp
cbgp2 boolean	Включить ловушки BGP MIBv2 Choices: `false` `true`
enable boolean	Включить/выключить ловушки bgp Choices: `false` `true`
state_changes dictionary	Ловушки для изменений состояния FSM
all boolean	Специфическая ловушка CISCO для всех изменений состояния FSM Choices: `false` `true`
backward_trans boolean	Специфическая ловушка CISCO для обратного перехода Choices: `false` `true`
enable boolean	Включить/выключить ловушки bgp state_changes Choices: `false` `true`
limited boolean	Ловушка для стандартного обратного перехода и установленного состояния Choices: `false` `true`
threshold dictionary	Пороговый режим
prefix boolean	Включить/выключить ловушки bgp threshold Choices: `false` `true`
bridge dictionary	Разрешить ловушки, связанные с мостом
enable boolean	Включить/выключить ловушки моста Choices: `false` `true`
newroot boolean	Включить ловушки SNMP STP Bridge MIB newroot Choices: `false` `true`
topologychange boolean	Включить ловушки SNMP STP Bridge MIB topologychange Choices: `false` `true`
bulkstat dictionary	Разрешить уведомления Data-Collection-MIB Collection
collection boolean	Включить уведомления Data-Collection-MIB Collection Choices: `false` `true`
enable boolean	Включить уведомления Data-Collection-MIB Collection и Transfert Choices: `false` `true`
transfer boolean	Включить уведомления Data-Collection-MIB Transfer Choices: `false` `true`

call_home dictionary	SNMP CISCO-CALLHOME-MIB traps
enable boolean	Включить SNMP CISCO-CALLHOME-MIB traps Варианты: `false` `true`
message_send_fail boolean	Включить уведомление SNMP ccmSmtpMsgSendFailNotif Варианты: `false` `true`
server_fail boolean	Включить уведомление SNMP ccmSmtpServerFailNotif Варианты: `false` `true`
casa boolean	Включить SNMP config casa traps Варианты: `false` `true`
cef dictionary	Разрешить traps, связанные с cef
enable boolean	Включить/отключить cef traps Варианты: `false` `true`
inconsistency boolean	Включить SNMP CEF Inconsistency traps Варианты: `false` `true`
peer_fib_state_change boolean	Включить SNMP CEF Peer FIB State change traps Варианты: `false` `true`
peer_state_change boolean	Включить SNMP CEF Peer state change traps Варианты: `false` `true`
resource_failure boolean	Включить SNMP CEF Resource Failure traps Варианты: `false` `true`
cnpd boolean	Включить SNMP cnpd traps Варианты: `false` `true`
config boolean	Включить SNMP config traps Варианты: `false` `true`
config_copy boolean	Включить SNMP config copy traps Варианты: `false` `true`
config_ctid boolean	Включить SNMP config ctid traps Варианты: `false` `true`
cpu dictionary	Разрешить traps, связанные с CPU
enable boolean	Включить/отключить cpu traps Варианты: `false` `true`
threshold boolean	Режим порога Варианты: `false` `true`
dhcp boolean	Включить SNMP dhcp traps Варианты: `false` `true`
dlsw dictionary	Разрешить traps, связанные с dlsw
circuit boolean	Включить SNMP dlsw circuit traps Варианты: `false` `true`

enable boolean	Включить/отключить traps cef Choices: `false` `true`
tconn boolean	Включить SNMP dlsw peer transport connection traps Choices: `false` `true`
eigrp boolean	Включить SNMP eigrp traps Choices: `false` `true`
energywise boolean	Включить SNMP energywise traps Choices: `false` `true`
entity boolean	Включить SNMP entity traps Choices: `false` `true`
entity_diag dictionary	Разрешить SNMP CISCO-ENTITY-DIAG-MIB traps
boot_up_fail boolean	Включить SNMP ceDiagBootUpFailedNotif traps Choices: `false` `true`
enable boolean	Включить SNMP CISCO-ENTITY-DIAG-MIB traps Choices: `false` `true`
hm_test_recover boolean	Включить SNMP ceDiagHMTestRecoverNotif traps Choices: `false` `true`
hm_thresh_reached boolean	Включить SNMP ceDiagHMThresholdReachedNotif traps Choices: `false` `true`
scheduled_test_fail boolean	Включить SNMP ceDiagScheduledTestFailedNotif traps Choices: `false` `true`
entity_perf dictionary	Разрешить SNMP CISCO-ENTITY-PERFORMANCE-MIB traps
enable boolean	Включить SNMP CISCO-ENTITY-PERFORMANCE-MIB traps Choices: `false` `true`
throughput_notif boolean	Включить ENTITY PERFORMANCE MIB throughput traps Choices: `false` `true`
entity_state boolean	Включить SNMP ENTITY-STATE-MIB traps Choices: `false` `true`
envmon dictionary	Включить SNMP environmental monitor traps
enable boolean	Включить/отключить envmon traps Choices: `false` `true`
fan dictionary	Включить SNMP envmon fan traps Этот параметр УСТАРЕЛ и заменён на fan_enable, который принимает bool в качестве входных данных Этот атрибут будет удалён после 2024-09-01
enable boolean	Включить/отключить fan traps Choices: `false` `true`
shutdown boolean	Включить SNMP environmental monitor shutdown traps Choices: `false` `true`

status boolean	Включить SNMP-ловушки об изменении состояния окружающей среды Choices: `false` `true`
supply boolean	Включить SNMP-ловушки монитора питания окружающей среды Choices: `false` `true`
temperature boolean	Включить SNMP-ловушки монитора температуры окружающей среды Choices: `false` `true`
fan_enable boolean	Включить SNMP-ловушки envmon fan Choices: `false` `true`
shutdown boolean	Включить SNMP-ловушки выключения монитора окружающей среды Choices: `false` `true`
status boolean	Включить SNMP-ловушки об изменении состояния окружающей среды Choices: `false` `true`
supply boolean	Включить SNMP-ловушки монитора питания окружающей среды Choices: `false` `true`
temperature boolean	Включить SNMP-ловушки монитора температуры окружающей среды Choices: `false` `true`
errdisable boolean	Включить SNMP-уведомления errdisable Choices: `false` `true`
ether_oam boolean	Включить SNMP-ловушки ethernet oam Choices: `false` `true`
ethernet dictionary	Разрешить ethernet-ловушки
cfm dictionary	Включить SNMP Ethernet CFM-ловушки
alarm boolean	Включить SNMP Ethernet CFM ловушку ошибки Choices: `false` `true`
cc dictionary	Включить SNMP Ethernet CC ловушку
config boolean	Включить SNMP Ethernet CFM ловушки ошибок конфигурации Choices: `false` `true`
cross_connect boolean	Включить SNMP Ethernet CFM ловушки соединения Choices: `false` `true`
loop boolean	Включить SNMP Ethernet CFM ловушки цикла Choices: `false` `true`
mep_down boolean	Включить SNMP Ethernet CFM CC Down ловушки Choices: `false` `true`
mep_up boolean	Включить SNMP Ethernet CFM CC Up ловушки Choices: `false` `true`
crosscheck dictionary	Включить SNMP Ethernet CC crosscheck ловушку

mep_missing boolean	Включить SNMP Ethernet CC кросс-проверку отсутствующей ловушки Choices: `false` `true`
mep_unknown boolean	Включить SNMP Ethernet CC кросс-проверку неизвестных ловушек Choices: `false` `true`
service_up boolean	Включить SNMP Ethernet CC кросс-проверку ловушек сервиса Choices: `false` `true`
evc dictionary	Включить SNMP Ethernet EVC ловушки
create boolean	Включить SNMP Ethernet EVC создание ловушек Choices: `false` `true`
delete boolean	Включить SNMP Ethernet EVC удаление ловушек Choices: `false` `true`
status boolean	Включить SNMP Ethernet EVC статус ловушек Choices: `false` `true`
event_manager boolean	Включить SNMP event-manager ловушки Choices: `false` `true`
firewall dictionary	Включить SNMP брандмауэр ловушки
enable boolean	Включить/выключить ловушки брандмауэра Choices: `false` `true`
serverstatus boolean	Включить ловушку изменения состояния сервера брандмауэра Choices: `false` `true`
flash dictionary	SNMP FLASH уведомления
enable boolean	Включить SNMP FLASH уведомления Choices: `false` `true`
insertion boolean	Включить SNMP Flash вставка уведомлений Choices: `false` `true`
lowspace boolean	Включить SNMP Flash мало места уведомлений Choices: `false` `true`
removal boolean	Включить SNMP Flash удаление уведомлений Choices: `false` `true`
flex_links dictionary	SNMP FLEX Links ловушки
enable boolean	Включить SNMP FLEX Links ловушки Choices: `false` `true`
status boolean	Включить SNMP FLEX Links ловушки изменения состояния Choices: `false` `true`
flowmon boolean	Включить SNMP flowmon ловушки Choices: `false` `true`
frame_relay dictionary	Разрешить frame-relay ловушки

enable boolean	Включить/выключить трассировку frame-relay Варианты: `false` `true`
subif dictionary	Включить SNMP трассировку для суб-интерфейсов frame-relay
count integer	Максимальное число отправляемых трассировок за интервал
enable boolean	Включить/выключить трассировку subif Варианты: `false` `true`
interval integer	Продолжительность интервала, в котором ограничивается число отправляемых трассировок
fru_ctrl boolean	Включить SNMP fru-ctrl трассировки Варианты: `false` `true`
hsrp boolean	Включить SNMP hsrp трассировки Варианты: `false` `true`
ike dictionary	Разрешить ike трассировки
policy dictionary	Включить IKE Policy трассировки
add boolean	Включить IKE Policy add трассировку Варианты: `false` `true`
delete boolean	Включить IKE Policy delete трассировку Варианты: `false` `true`
tunnel dictionary	Включить IKE Tunnel трассировки
start boolean	Включить IKE Tunnel start трассировку Варианты: `false` `true`
stop boolean	Включить IKE Tunnel stop трассировку Варианты: `false` `true`
ipmulticast boolean	Включить SNMP ip multicast трассировки Варианты: `false` `true`
ipsec dictionary	Разрешить ike трассировки
cryptomap dictionary	Включить IPsec Cryptomap трассировки
add boolean	Включить IPsec Cryptomap add трассировку Варианты: `false` `true`
attach boolean	Включить IPsec Cryptomap Attach трассировку Варианты: `false` `true`
delete boolean	Включить IPsec Cryptomap delete трассировку Варианты: `false` `true`
detach boolean	Включить IPsec Cryptomap Detach трассировку Варианты: `false` `true`
too_many_sas boolean	Включить IPsec Tunnel Start трассировку Варианты: `false` `true`

tunnel dictionary	Включить ловушки IPsec Tunnel
start boolean	Включить ловушку запуска IPsec Tunnel Choices: `false` `true`
stop boolean	Включить ловушку остановки IPsec Tunnel Choices: `false` `true`
ipsla boolean	Включить SNMP ipsla ловушки Choices: `false` `true`
isis boolean	Включить SNMP isis ловушки Choices: `false` `true`
l2tc dictionary	Разрешить SNMP L2 Tunnel Config ловушки
enable boolean	Включить SNMP L2 Tunnel Config ловушки Choices: `false` `true`
sys_threshold boolean	Включить SNMP L2TC System threshold ловушки Choices: `false` `true`
threshold boolean	Включить SNMP L2 Tunnel Config threshold ловушки Choices: `false` `true`
l2tun dictionary	Разрешить SNMP l2tun ловушки
pseudowire_status boolean	Включить ловушки состояния BFD pseudo wire Choices: `false` `true`
session boolean	Включить ловушки сессии BFD Choices: `false` `true`
license boolean	Включить ловушки лицензирования Choices: `false` `true`
lisp boolean	Включить SNMP LISP MIB ловушки Choices: `false` `true`
local_auth boolean	Включить SNMP local auth ловушки Choices: `false` `true`
mac_notification dictionary	Разрешить SNMP MAC Notification ловушки
change boolean	Включить SNMP MAC Change ловушки Choices: `false` `true`
enable boolean	Включить SNMP MAC Notification ловушки Choices: `false` `true`
move boolean	Включить SNMP MAC Move ловушки Choices: `false` `true`
threshold boolean	Включить SNMP MAC Threshold ловушки Choices: `false` `true`
memory dictionary	Разрешить ловушки MEMORY

bufferpeak boolean	Включить SNMP Memory Bufferpeak traps Choices: `false` `true`
enable boolean	Включить MEMORY traps Choices: `false` `true`
mpls dictionary	Включить SNMP mpls traps
fast_reroute dictionary	Разрешить SNMP MPLS fast reroute traps
enable boolean	Включить SNMP MPLS fast reroute traps Choices: `false` `true`
protected boolean	Включить MPLS fast reroute protection traps Choices: `false` `true`
ldp dictionary	Разрешить SNMP MPLS label distribution protocol traps
enable boolean	Включить SNMP MPLS label distribution protocol traps Choices: `false` `true`
pv_limit boolean	Включить MPLS LDP path vector limit mismatch traps Choices: `false` `true`
session_down boolean	Включить MPLS LDP session down traps Choices: `false` `true`
session_up boolean	Включить MPLS LDP session up traps Choices: `false` `true`
threshold boolean	Включить MPLS LDP threshold exceeded traps Choices: `false` `true`
rfc dictionary	Включить SNMP MPLS RFC traps
ldp dictionary	Разрешить SNMP MPLS label distribution protocol RFC traps
enable boolean	Включить SNMP MPLS label distribution protocol RFC traps Choices: `false` `true`
pv_limit boolean	Включить MPLS LDP path vector limit mismatch RFC traps Choices: `false` `true`
session_down boolean	Включить MPLS LDP session down RFC traps Choices: `false` `true`
session_up boolean	Включить MPLS LDP session up RFC traps Choices: `false` `true`
threshold boolean	Включить MPLS LDP threshold exceeded RFC traps Choices: `false` `true`
traffic_eng dictionary	Разрешить SNMP MPLS traffic engineering RFC traps
down boolean	Включить MPLS TE tunnel down RFC traps Choices: `false` `true`

enable boolean	Включить SNMP MPLS ловушки трафика RFC Choices: `false` `true`
reoptimized boolean	Включить MPLS TE туннель переоптимизированные ловушки RFC Choices: `false` `true`
reroute boolean	Включить MPLS TE туннель перенаправленные ловушки RFC Choices: `false` `true`
up boolean	Включить MPLS TE туннель поднятые ловушки RFC Choices: `false` `true`
vpn dictionary	Разрешить SNMP MPLS Virtual Private Network ловушки RFC
enable boolean	Включить SNMP MPLS Virtual Private Network ловушки RFC Choices: `false` `true`
illegal_label boolean	Включить MPLS VPN превышение порога незаконных меток ловушки RFC Choices: `false` `true`
max_thresh_cleared boolean	Включить MPLS VPN очистка максимального порога ловушки RFC Choices: `false` `true`
max_threshold boolean	Включить MPLS VPN превышение максимального порога ловушки RFC Choices: `false` `true`
mid_threshold boolean	Включить MPLS VPN превышение среднего порога ловушки RFC Choices: `false` `true`
vrf_down boolean	Включить MPLS VPN vrf отключение ловушки RFC Choices: `false` `true`
vrf_up boolean	Включить MPLS VPN vrf поднятие ловушки RFC Choices: `false` `true`
traffic_eng dictionary	Разрешить SNMP MPLS ловушки управления трафиком
down boolean	Включить MPLS TE туннель отключение ловушек Choices: `false` `true`
enable boolean	Включить SNMP MPLS ловушки управления трафиком Choices: `false` `true`
reroute boolean	Включить MPLS TE туннель перенаправление ловушек Choices: `false` `true`
up boolean	Включить MPLS TE туннель поднятие ловушек Choices: `false` `true`
vpn dictionary	Разрешить SNMP MPLS Virtual Private Network ловушки
enable boolean	Включить SNMP MPLS Virtual Private Network ловушки Choices: `false` `true`
illegal_label boolean	Включить MPLS VPN превышение порога незаконных меток ловушки Choices: `false` `true`

max_thresh_cleared boolean	Включить ловушки MPLS VPN о превышении максимального порога Choices: `false` `true`
max_threshold boolean	Включить ловушки MPLS VPN о превышении максимального порога Choices: `false` `true`
mid_threshold boolean	Включить ловушки MPLS VPN о превышении среднего порога Choices: `false` `true`
vrf_down boolean	Включить ловушки MPLS VPN о отключении VRF Choices: `false` `true`
vrf_up boolean	Включить ловушки MPLS VPN о включении VRF Choices: `false` `true`
mpls_vpn boolean	Включить SNMP MPLS ловушки Этот параметр УСТАРЕЛ и заменён на mpls, который принимает словарь в качестве входных данных Этот атрибут будет удалён после 2024-09-01 Choices: `false` `true`
msdp boolean	Включить SNMP MSDP ловушки Choices: `false` `true`
mvpn boolean	Включить SNMP MVPD ловушки Choices: `false` `true`
nhrp dictionary	Разрешить SNMP NHRP ловушки
enable boolean	Включить SNMP NHRP ловушки Choices: `false` `true`
nhc dictionary	Разрешить ловушки Next Hop Client
down boolean	Включить ловушку Next Hop Client о отключении Choices: `false` `true`
enable boolean	Включить ловушки Next Hop Client Choices: `false` `true`
up boolean	Включить ловушку Next Hop Client о включении Choices: `false` `true`
nhp dictionary	Разрешить ловушки Next Hop Peer
down boolean	Включить ловушку Next Hop Peer о отключении Choices: `false` `true`
enable boolean	Включить ловушки Next Hop Peer Choices: `false` `true`
up boolean	Включить ловушку Next Hop Peer о включении Choices: `false` `true`
nhs dictionary	Разрешить ловушки Next Hop Server
down boolean	Включить ловушку Next Hop Server о отключении Choices: `false` `true`
enable boolean	Включить ловушки Next Hop Server Choices: `false` `true`

up boolean	Включить ловушку Next Hop Server up Choices: `false` `true`
quota_exceeded boolean	Включить ловушку quota-exceeded Choices: `false` `true`
ospf dictionary	Разрешить ловушки, связанные с OSPF
cisco_specific dictionary	Ловушки, специфичные для Cisco
error boolean	Ловушки ошибок Choices: `false` `true`
lsa boolean	Ловушки, связанные с LSA Choices: `false` `true`
retransmit boolean	Ловушки повторной передачи пакетов Choices: `false` `true`
state_change dictionary	Ловушки изменения состояния
nssa_trans_change boolean	Изменения состояния транслятора NSSA Choices: `false` `true`
shamlink dictionary	Ошибки несоответствия конфигурации на виртуальных интерфейсах
interface boolean	Изменения состояния интерфейса Sham Link Choices: `false` `true`
neighbor boolean	Изменения состояния соседа Sham Link Choices: `false` `true`
error boolean	Включить ловушки ошибок Choices: `false` `true`
lsa boolean	Включить/отключить ловушки OSPF LSA Choices: `false` `true`
retransmit boolean	Включить/отключить ловушки повторной передачи OSPF Choices: `false` `true`
state_change boolean	Включить/отключить ловушки изменения состояния Choices: `false` `true`
ospfv3 dictionary	Разрешить ловушки, связанные с OSPFv3
errors dictionary	Ловушки ошибок
bad_packet boolean	Ошибка разбора пакета на невиртуальных интерфейсах Choices: `false` `true`
config_error boolean	Ошибки несоответствия конфигурации на невиртуальных интерфейсах Choices: `false` `true`
enable boolean	Включить ловушки ошибок Choices: `false` `true`

virt_bad_packet boolean	Ошибка разбора пакета на виртуальных интерфейсах Choices: `false` `true`
virt_config_error boolean	Ошибки несоответствия конфигурации на виртуальных интерфейсах Choices: `false` `true`
rate_limit integer	Значения ограничения скорости ловушек Размер окна ограничения скорости в секундах (от 2 до 60)
state_change dictionary	Ловушки изменения состояния
enable boolean	Включить ловушки изменения состояния Choices: `false` `true`
if_state_change boolean	Изменения состояния невиртуальных интерфейсов Choices: `false` `true`
neighbor_restart_helper_status_change boolean	Изменения состояния помощника грациозного перезапуска соседа Choices: `false` `true`
neighbor_state_change boolean	Изменения состояния невиртуальных соседей Choices: `false` `true`
nssa_translator_status_change boolean	Изменения состояния транслятора NSSA Choices: `false` `true`
restart_status_change boolean	Изменения состояния грациозного перезапуска Choices: `false` `true`
virtif_state_change boolean	Изменения состояния виртуального интерфейса Choices: `false` `true`
vn_restart_helper_status_change boolean	Изменения состояния помощника грациозного перезапуска виртуального соседа Choices: `false` `true`
vn_state_change boolean	Изменения состояния виртуального соседа Choices: `false` `true`
pim dictionary	Разрешить ловушки PIM
enable boolean	Включить/выключить ловушки PIM Choices: `false` `true`
invalid_pim_message boolean	Включить ловушку недопустимого сообщения PIM Choices: `false` `true`
neighbor_change boolean	Включить ловушку изменения соседа Choices: `false` `true`
rp_mapping_change boolean	Включить ловушку изменения сопоставления RP Choices: `false` `true`
pki boolean	Включить ловушки SNMP PKI Choices: `false` `true`

port_security boolean	Включить SNMP-ловушки защиты портов Варианты: `false` `true`
power_ethernet dictionary	Разрешить SNMP-ловушки Power Ethernet
enable boolean	Включить SNMP-ловушки Power Ethernet Варианты: `false` `true`
group list / elements=dictionary	Включить SNMP-ловушки на основе группы встроенного питания.
slot_id integer	Целое число от 1 до 20 (номер физического слота)
threshold integer	Пороговый уровень для этого слота
police boolean	Включить ловушку контроля Варианты: `false` `true`
pw_vc boolean	Включить SNMP-ловушки pw vc Варианты: `false` `true`
rep boolean	Включить SNMP-ловушки Resilient Ethernet Protocol Варианты: `false` `true`
rf boolean	Включить все SNMP-ловушки, определенные в CISCO-RF-MIB Варианты: `false` `true`
rsvp boolean	Включить SNMP-ловушки RSVP Варианты: `false` `true`
smart_license dictionary	Разрешить ловушки smart license
enable boolean	Включить ловушки smart license Варианты: `false` `true`
entitlement boolean	Включить ловушку уведомления о правах Варианты: `false` `true`
global boolean	Включить глобальные ловушки уведомлений Варианты: `false` `true`
snmp dictionary	Включить SNMP-ловушки
authentication boolean	Включить ловушку аутентификации Варианты: `false` `true`
coldstart boolean	Включить ловушку coldStart Варианты: `false` `true`
linkdown boolean	Включить ловушку linkDown Варианты: `false` `true`
linkup boolean	Включить ловушку linkUp Варианты: `false` `true`
warmstart boolean	Включить ловушку warmStart Варианты: `false` `true`

stackwise boolean	Включить SNMP stackwise traps Choices: `false` `true`
stpx dictionary	Разрешить SNMP STPX MIB traps
enable boolean	Включить SNMP STPX MIB traps Choices: `false` `true`
inconsistency boolean	Включить SNMP STPX MIB InconsistencyUpdate traps Choices: `false` `true`
loop_inconsistency boolean	Включить SNMP STPX MIB LoopInconsistencyUpdate traps Choices: `false` `true`
root_inconsistency boolean	Включить SNMP STPX MIB RootInconsistencyUpdate traps Choices: `false` `true`
syslog boolean	Включить SNMP syslog traps Choices: `false` `true`
transceiver_all boolean	Включить SNMP transceiver traps Choices: `false` `true`
trustsec dictionary	Разрешить SNMP CISCO-TRUSTSEC-MIB traps
authz_file_error boolean	Включить уведомления ctsAuthzCacheFileErrNotif Choices: `false` `true`
cache_file_error boolean	Включить уведомления ctsCacheFileAccessErrNotif Choices: `false` `true`
enable boolean	Включить SNMP CISCO-TRUSTSEC-MIB traps Choices: `false` `true`
keystore_file_error boolean	Включить уведомления ctsSwKeystoreFileErrNotif Choices: `false` `true`
keystore_sync_fail boolean	Включить уведомления ctsSwKeystoreSyncFailNotif Choices: `false` `true`
random_number_fail boolean	Включить уведомления ctsSapRandonNumberFailNotif Choices: `false` `true`
src_entropy_fail boolean	Включить уведомления ctsSrcEntropyFailNotif Choices: `false` `true`
trustsec_interface dictionary	Разрешить SNMP CISCO-TRUSTSEC-INTERFACE-MIB traps
authc_fail boolean	Включить trap ctsiIfAuthenticationFailNotif Choices: `false` `true`
authz_fail boolean	Включить trap ctsiAuthorizationFailNotif Choices: `false` `true`
enable boolean	Включить SNMP CISCO-TRUSTSEC-INTERFACE-MIB traps Choices: `false` `true`

sap_fail boolean	Включить ловушку ctsiIfSapNegotiationFailNotif Варианты: `false` `true`
supplicant_fail boolean	Включить ловушку ctsiIfAddSupplicantFailNotif Варианты: `false` `true`
unauthorized boolean	Включить ловушку ctsiIfUnauthorizedNotifEnable Варианты: `false` `true`
trustsec_policy dictionary	Разрешить ловушки SNMP CISCO-TRUSTSEC-POLICY-MIB
authz_sgacl_fail boolean	Включить уведомления ctspAuthorizationSgaclFailNotif Варианты: `false` `true`
enable boolean	Включить ловушки SNMP CISCO-TRUSTSEC-POLICY-MIB Варианты: `false` `true`
peer_policy_updated boolean	Включить уведомления ctspPeerPolicyUpdatedNotif Варианты: `false` `true`
trustsec_server dictionary	Разрешить ловушки SNMP CISCO-TRUSTSEC-SERVER-MIB
enable boolean	Включить ловушки SNMP CISCO-TRUSTSEC-SERVER-MIB Варианты: `false` `true`
provision_secret boolean	Включить уведомление ctsvNoProvisionSecretNotif Варианты: `false` `true`
radius_server boolean	Включить уведомление ctsvNoRadiusServerNotif Варианты: `false` `true`
trustsec_sxp dictionary	Разрешить ловушки SNMP CISCO-TRUSTSEC-SXP-MIB
binding_conflict boolean	Включить уведомления ctsxSxpBindingConflictNotif Варианты: `false` `true`
binding_err boolean	Включить уведомления ctsxSxpBindingErrNotif Варианты: `false` `true`
binding_expn_fail boolean	Включить уведомления ctsxSxpBindingExpnFailNotif Варианты: `false` `true`
conn_config_err boolean	Включить уведомления ctsxSxpConnConfigErrNotif Варианты: `false` `true`
conn_down boolean	Включить уведомления ctsxSxpConnDownNotif Варианты: `false` `true`
conn_srcaddr_err boolean	Включить уведомления ctsxSxpConnSourceAddrErrNotif Варианты: `false` `true`
conn_up boolean	Включить уведомления ctsxSxpConnUpNotif Варианты: `false` `true`

enable boolean	Включить SNMP CISCO-TRUSTSEC-SXP-MIB traps Choices: `false` `true`
msg_parse_err boolean	Включить уведомления ctsxSxpMsgParseErrNotif Choices: `false` `true`
oper_nodeid_change boolean	Включить уведомления ctsxSxpOperNodeIdChangeNotif Choices: `false` `true`
tty boolean	Включить SNMP ловушки TCP-соединения tty Choices: `false` `true`
udld dictionary	Разрешить SNMP CISCO-UDLDP-MIB traps
enable boolean	Включить SNMP CISCO-UDLDP-MIB traps Choices: `false` `true`
link_fail_rpt boolean	Включить SNMP cudldpFastHelloLinkFailRptNotification traps Choices: `false` `true`
status_change boolean	Включить SNMP cudldpFastHelloStatusChangeNotification traps Choices: `false` `true`
vlan_membership boolean	Включить SNMP ловушки членства VLAN Choices: `false` `true`
vlancreate boolean	Включить SNMP ловушки создания VLAN Choices: `false` `true`
vlandelete boolean	Включить SNMP ловушки удаления VLAN Choices: `false` `true`
vrfmib dictionary	Разрешить vrfmib traps
vnet_trunk_down boolean	Включить ловушки vnet-trunk-down Choices: `false` `true`
vnet_trunk_up boolean	Включить ловушку vnet-trunk-up Choices: `false` `true`
vrf_down boolean	Включить ловушку vrf-down Choices: `false` `true`
vrf_up boolean	Включить ловушку vrf-up Choices: `false` `true`
vrrp boolean	Включить SNMP vrrp traps Choices: `false` `true`
vswitch dictionary	Разрешить SNMP уведомления виртуального коммутатора
dual_active boolean	Включить уведомление SNMP виртуального коммутатора (Dual Active) Choices: `false` `true`
enable boolean	Включить SNMP уведомления виртуального коммутатора Choices: `false` `true`

vsl boolean	Включить уведомление SNMP Virtual Switch Link (VSL) Choices: `false` `true`
vtp boolean	Включить SNMP VTP traps Choices: `false` `true`
users list / elements=dictionary	Определить пользователя, который может получить доступ к механизму SNMP
acl_v4 string	Связанный список доступа ipv4
acl_v6 string	Связанный список доступа ipv6
authentication dictionary	Параметры аутентификации для пользователя. Влияет на идемпотентность модуля, так как применённая конфигурация не отражается в running-config.
algorithm string	Выберите алгоритм для аутентификации. Choices: `"md5"` `"sha"`
password string	Пароль аутентификации для пользователя.
encryption dictionary	Параметры шифрования для пользователя. Влияет на идемпотентность модуля, так как применённая конфигурация не отражается в running-config.
password string	Пароль аутентификации для пользователя.
priv string	Выберите алгоритм для шифрования. Choices: `"3des"` `"aes"` `"des"`
priv_option string	Добавить дополнительный параметр для конкретного priv, если есть.
group string	Группа SNMP для пользователя.
remote string	Система, где размещён пользователь SNMPv3
udp_port integer	UDP-порт, используемый удалённой системой SNMP
username string	Имя пользователя SNMP
version string	Версия безопасности SNMP Choices: `"v1"` `"v2c"` `"v3"`
version_option string	Включить зашифрованный параметр версии. Choices: `"encrypted"`
vrf string	VPN Routing instance удалённого объекта SNMP
views list / elements=dictionary	Определить представление SNMPv2 MIB
excluded boolean	Семейство MIB исключено из представления Choices: `false` `true`
family_name string	Имя семейства представлений MIB
included boolean	Семейство MIB включено в представление Choices: `false` `true`
name string	Имя представления

running_config

string

Этот параметр используется только со значением parsed.

Значение этого параметра должно быть выводом с устройства IOS, полученным после выполнения команды show running-config | include snmp-server.

Состояние parsed считывает конфигурацию из параметра running_config и преобразует её в структурированные данные Ansible в соответствии со спецификацией аргументов модуля ресурса, а затем возвращает значение в ключе parsed в результате.

state

string

Состояние, в котором должна остаться конфигурация.

Для получения более подробной информации обратитесь к примерам.

Состояния replaced и overridden имеют идентичное поведение для данного модуля.

Варианты:

"merged" ← (по умолчанию)
"replaced"
"overridden"
"deleted"
"parsed"
"gathered"
"rendered"

Примечания

Примечание

Проверено на Cisco IOSXE версии 17.3 на CML.
Этот модуль работает с подключением 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 словарь	Результирующая конфигурация после выполнения модуля. Возвращается: при изменении Пример: `"This output will always be in the same format as the module argspec.\n"`
before словарь	Конфигурация до выполнения модуля. Возвращается: когда state равен `merged`, `replaced`, `overridden`, `deleted` или `purged` Пример: `"This output will always be in the same format as the module 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"]`
gathered список / элементы=строка	Данные об сетевом ресурсе, собранные с удаленного устройства в виде структурированных данных. Возвращается: когда state равен `gathered` Пример: `["This output will always be in the same format as the module argspec.\n"]`
parsed список / элементы=строка	Конфигурация устройства, предоставленная в параметре running_config, проанализированная в структурированные данные в соответствии со спецификацией аргументов модуля. Возвращается: когда state равен `parsed` Пример: `["This output will always be in the same format as the module argspec.\n"]`
rendered список / элементы=строка	Предоставленная конфигурация в задании, преобразованная в формат, понятный устройству (оффлайн). Возвращается: когда 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)

Ссылки на коллекции

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/cisco/ios/ios_snmp_server_module.html