Модуль cisco.ios.ios_ping — проверка доступности с помощью ping с коммутатора IOS.

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install cisco.ios.

Чтобы использовать её в плейбуке, укажите: cisco.ios.ios_ping.

Добавлено в cisco.ios 1.0.0

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

Обзор

Проверяет доступность удалённого узла с коммутатора с помощью ping.
Для сетевых задач общего назначения см. модуль net_ping.
Для целевых узлов под управлением Windows используйте модуль win_ping.
Для целевых узлов под управлением Python используйте модуль ping.

Примечание

У этого модуля есть соответствующий модуль действий.

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

Параметры

Параметр	Описание
afi строка	Задаёт тип эхо-запроса: ip или ipv6. Варианты: `"ip"` ← (по умолчанию) `"ipv6"`
count целое число	Количество отправляемых пакетов.
dest строка / обязательный	IP-адрес или имя узла (разрешаемое коммутатором) удалённого узла.
df_bit логическое значение	Установить бит DF. Варианты: `false` ← (по умолчанию) `true`
egress строка	Принудительно направить трафик через исходящий интерфейс, минуя маршрутизацию.
ingress строка	Исходный интерфейс LAN для входящего трафика.
size целое число	Размер отправляемого пакета.
source строка	Исходный IP-адрес.
state строка	Определяет, ожидается ли успешный результат или сбой. Варианты: `"absent"` `"present"` ← (по умолчанию)
timeout целое число	Задаёт интервал ожидания.
vrf строка	VRF, используемая для пересылки.

Примечания

Примечание

Проверено на Cisco IOSXE версии 17.3 в CML.
Для сетевых задач общего назначения см. модуль net_ping.
Для целевых узлов под управлением Windows используйте модуль win_ping.
Для целевых узлов под управлением Python используйте модуль ping.

Примеры

- name: Test reachability to 198.51.100.251 using default vrf
  cisco.ios.ios_ping:
    dest: 198.51.100.251

- name: Test reachability to 198.51.100.252 using prod vrf
  cisco.ios.ios_ping:
    dest: 198.51.100.252
    vrf: prod
    afi: ip

- name: Test un reachability to 198.51.100.253 using default vrf
  cisco.ios.ios_ping:
    dest: 198.51.100.253
    state: absent

- name: Test reachability to 198.51.100.250 using prod vrf and setting count and source
  cisco.ios.ios_ping:
    dest: 198.51.100.250
    source: loopback0
    vrf: prod
    count: 20

- name: Test reachability to 198.51.100.249 using df-bit and size
  cisco.ios.ios_ping:
    dest: 198.51.100.249
    df_bit: true
    size: 1400

- name: Test reachability to ipv6 address
  cisco.ios.ios_ping:
    dest: 2001:db8:ffff:ffff:ffff:ffff:ffff:ffff
    afi: ipv6

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

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

Ключ	Описание
commands список / элементы=строка	Отображает отправленную команду. Возвращается: всегда Пример: `["ping vrf prod 198.51.100.251 count 20 source loopback0"]`
packet_loss строка	Процент потерянных пакетов. Возвращается: всегда Пример: `"0%"`
packets_rx целое число	Успешно полученные пакеты. Возвращается: всегда Пример: `20`
packets_tx целое число	Успешно отправленные пакеты. Возвращается: всегда Пример: `20`
rtt словарь	Отображает статистику RTT. Возвращается: всегда Пример: `{"avg": 2, "max": 8, "min": 1}`

Авторы

Jacob McGill (@jmcgill298)
Sagar Paul (@KB-perByte)

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

© 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/cisco/ios/ios_ping_module.html