Модуль cisco.iosxr.iosxr_ping — проверка доступности с помощью ping с коммутатора IOSXR.

Примечание

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

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

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

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

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

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

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

Параметры

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

Примечания

Примечание

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

Примеры

- name: Test reachability to 198.51.100.251 using default vrf
  cisco.iosxr.iosxr_ping:
    dest: 198.51.100.251

- name: Test reachability to 198.51.100.252 using prod vrf
  cisco.iosxr.iosxr_ping:
    dest: 198.51.100.252
    vrf: prod
    afi: ipv4

- name: Test unreachability to 198.51.100.253 using default vrf
  cisco.iosxr.iosxr_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.iosxr.iosxr_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.iosxr.iosxr_ping:
    dest: 198.51.100.249
    df_bit: true
    size: 1400

- name: Test reachability to ipv6 address
  cisco.iosxr.iosxr_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}`

Авторы

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/iosxr/iosxr_ping_module.html