net_ping – Проверка доступности с помощью ping с сетевого устройства

Новая версия 2.4.

Обзор
Параметры
Примечания
Примеры
Значения возврата
Статус

Обзор

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
count -	Значение по умолчанию: 5	Количество пакетов для отправки.
dest - / обязательно		IP-адрес или имя хоста (разрешимое коммутатором) удалённого узла.
source -		IP-адрес источника.
state -	Варианты: отсутствует present ←	Определяет, ожидается успех или неудача.
vrf -	Значение по умолчанию: "default"	VRF для переадресации.

Примечания

Примечание

Для целей Windows используйте модуль win_ping.
Для целей, работающих на Python, используйте модуль ping.
Этот модуль поддерживается на ansible_network_os сетевых платформах. Подробнее см. Параметры сетевой платформы.

Примеры

- name: Test reachability to 10.10.10.10 using default vrf
  net_ping:
    dest: 10.10.10.10

- name: Test reachability to 10.20.20.20 using prod vrf
  net_ping:
    dest: 10.20.20.20
    vrf: prod

- name: Test unreachability to 10.30.30.30 using default vrf
  net_ping:
    dest: 10.30.30.30
    state: absent

- name: Test reachability to 10.40.40.40 using prod vrf and setting count and source
  net_ping:
    dest: 10.40.40.40
    source: loopback0
    vrf: prod
    count: 20

Значения возврата

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

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

Статус

Отсутствует гарантия обратной совместимости интерфейса модуля. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

Jacob McGill (@jmcgill298)

Подсказка

Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/net_ping_module.html