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

Примечание

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

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

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

Для использования в плейбуке укажите: cisco.iosxr.iosxr_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 логическое значение	Сканирование пинга. Варианты: `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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/cisco/iosxr/iosxr_ping_module.html