Модуль dellemc.enterprise_sonic.sonic_ip_neighbor — управление глобальной конфигурацией соседей IP в SONiC.

Примечание

Этот модуль входит в коллекцию dellemc.enterprise_sonic (версия 3.2.0).

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

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

Чтобы использовать её в плейбуке, укажите: dellemc.enterprise_sonic.sonic_ip_neighbor.

Добавлено в dellemc.enterprise_sonic 2.1.0

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

Краткое описание

Этот модуль обеспечивает управление глобальной конфигурацией соседей IP на устройствах под управлением SONiC.

Параметры

Параметр	Комментарии
config dictionary	Задаёт глобальную конфигурацию соседей IP.
ipv4_arp_timeout integer	Тайм-аут ARP для IPv4. Допустимый диапазон: от 60 до 14400.
ipv4_drop_neighbor_aging_time integer	Время устаревания отброшенного соседа IPv4. Допустимый диапазон: от 60 до 14400.
ipv6_drop_neighbor_aging_time integer	Время устаревания отброшенного соседа IPv6. Допустимый диапазон: от 60 до 14400.
ipv6_nd_cache_expiry integer	Срок действия кэша ND для IPv6. Допустимый диапазон: от 60 до 14400.
num_local_neigh integer	Количество зарезервированных локальных соседей. Допустимый диапазон: от 0 до 32000.
state string	Состояние конфигурации после завершения работы модуля. Варианты: `"merged"` ← (по умолчанию) `"replaced"` `"overridden"` `"deleted"`

Примечания

Примечание

Поддерживается check_mode.

Примеры

#
# Using "merged" state
#
# Before state:
# -------------
#
# sonic# show running-configuration
# !
# ip arp timeout 180
# ip drop-neighbor aging-time 300
# ipv6 drop-neighbor aging-time 300
# ip reserve local-neigh 0
# ipv6 nd cache expire 180
# !
- name: Configure IP neighbor global
  sonic_ip_neighbor:
    config:
      ipv4_arp_timeout: 1200
      ipv4_drop_neighbor_aging_time: 600
      ipv6_drop_neighbor_aging_time: 600
      ipv6_nd_cache_expiry: 1200
      num_local_neigh: 1000
    state: merged

# After state:
# ------------
#
# sonic# show running-configuration
# !
# ip arp timeout 1200
# ip drop-neighbor aging-time 600
# ipv6 drop-neighbor aging-time 600
# ip reserve local-neigh 1000
# ipv6 nd cache expire 1200
# !
#
# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show running-configuration
# !
# ip arp timeout 1200
# ip drop-neighbor aging-time 600
# ipv6 drop-neighbor aging-time 600
# ip reserve local-neigh 1000
# ipv6 nd cache expire 1200
# !
- name: Delete some IP neighbor configuration
  sonic_ip_neighbor:
    config:
      ipv4_arp_timeout: 0
      ipv4_drop_neighbor_aging_time: 0
    state: deleted

# After state:
# ------------
#
# sonic# show running-configuration
# !
# ip arp timeout 180
# ip drop-neighbor aging-time 300
# ipv6 drop-neighbor aging-time 600
# ip reserve local-neigh 1000
# ipv6 nd cache expire 1200
# !
#
# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show running-configuration
# !
# ip arp timeout 1200
# ip drop-neighbor aging-time 600
# ipv6 drop-neighbor aging-time 600
# ip reserve local-neigh 1000
# ipv6 nd cache expire 1200
# !
- name: Delete all IP neighbor configuration
  sonic_ip_neighbor:
    config: {}
    state: deleted

# After state:
# ------------
#
# sonic# show running-configuration
# !
# ip arp timeout 180
# ip drop-neighbor aging-time 300
# ipv6 drop-neighbor aging-time 300
# ip reserve local-neigh 0
# ipv6 nd cache expire 180
# !
#
# Using "replaced" state
#
# Before state:
# -------------
#
# sonic# show running-configuration
# !
# ip arp timeout 1200
# ip drop-neighbor aging-time 600
# ipv6 drop-neighbor aging-time 300
# ip reserve local-neigh 0
# ipv6 nd cache expire 180
# !
- name: Change some IP neighbor configuration
  sonic_ip_neighbor:
    config:
      ipv6_drop_neighbor_aging_time: 600
      ipv6_nd_cache_expiry: 1200
      num_local_neigh: 1000
    state: replaced

# After state:
# ------------
#
# sonic# show running-configuration
# !
# ip arp timeout 1200
# ip drop-neighbor aging-time 600
# ipv6 drop-neighbor aging-time 600
# ip reserve local-neigh 1000
# ipv6 nd cache expire 1200
# !
#
# Using "overridden" state
#
# Before state:
# -------------
#
# sonic# show running-configuration
# !
# ip arp timeout 1200
# ip drop-neighbor aging-time 600
# ipv6 drop-neighbor aging-time 300
# ip reserve local-neigh 0
# ipv6 nd cache expire 180
# !
- name: Reset IP neighbor configuration, then configure some
  sonic_ip_neighbor:
    config:
      ipv6_drop_neighbor_aging_time: 600
      ipv6_nd_cache_expiry: 1200
      num_local_neigh: 1000
    state: overridden

# After state:
# ------------
#
# sonic# show running-configuration
# !
# ip arp timeout 180
# ip drop-neighbor aging-time 300
# ipv6 drop-neighbor aging-time 600
# ip reserve local-neigh 1000
# ipv6 nd cache expire 1200
# !
#

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:

Ключ	Описание
after list / elements=string	Результирующая конфигурация после вызова модуля. Возвращается: при изменении Пример: `["The configuration returned will always be in the same format as the parameters above.\n"]`
after(generated) list / elements=string	Сгенерированная конфигурация после вызова модуля. Возвращается: когда `check_mode` Пример: `["The configuration returned will always be in the same format as the parameters above.\n"]`
before list / elements=string	Конфигурация до вызова модуля. Возвращается: всегда Пример: `["The configuration returned will always be in the same format as the parameters above.\n"]`
commands list / elements=string	Набор команд, отправленных на удалённое устройство. Возвращается: всегда Пример: `["command 1", "command 2", "command 3"]`

Авторы

1. Zhang (@mingjunzhang2019)

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

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/dellemc/enterprise_sonic/sonic_ip_neighbor_module.html