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

Примечание

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

У вас, возможно, уже установлена эта коллекция, если вы используете пакет 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/cisco/ios/ios_ping_module.html