junos_ping – Тестирует доступность с помощью ping с устройств, на которых запущен Juniper JUNOS
Новая версия 2.8.
Краткое описание
- Тестирует доступность с помощью ping с устройств, на которых запущен Juniper JUNOS, до удаленного узла.
- Тестировано на Junos (17.3R1.10)
- Для модуля сети общего назначения см. модуль net_ping.
- Для целей Windows используйте модуль win_ping.
- Для целей Python используйте модуль ping.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| count целое число | Значение по умолчанию: 5 | Количество пакетов для отправки, чтобы проверить доступность. | |
| dest - / обязательно | IP-адрес или имя хоста (разрешаемый устройством) удаленного узла. | ||
| interface - | Интерфейс источника для использования при отправке пакета(ов) ping. | ||
| interval целое число | Определяет интервал (в секундах) между последовательными ping. | ||
| provider словарь | Устарело Начиная с Ansible 2.5, рекомендуется использовать connection: network_cli или connection: netconf. Дополнительную информацию см. в руководстве по платформе Junos OS Platform Options. Объект словаря, содержащий данные подключения. | ||
| host строка / обязательно | Указывает имя хоста DNS или адрес для подключения к удаленному устройству через указанный транспорт. Значение host используется в качестве адреса назначения для транспорта. | ||
| password строка | Указывает пароль для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды ANSIBLE_NET_PASSWORD. | ||
| port целое число | Значение по умолчанию: 22 | Указывает порт для построения соединения с удаленным устройством. Значение порта по умолчанию установлено на известный порт SSH 22 (для transport=cli) или на порт 830 (для transport=netconf) устройства. | |
| ssh_keyfile путь | Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Это значение — путь к ключу, используемому для аутентификации сеанса SSH. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды ANSIBLE_NET_SSH_KEYFILE. | ||
| timeout целое число | Значение по умолчанию: 10 | Указывает тайм-аут в секундах для связи с сетевым устройством для подключения или отправки команд. Если тайм-аут превышен до завершения операции, модуль выдаст ошибку. | |
| username строка | Настраивает имя пользователя для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды ANSIBLE_NET_USERNAME. | ||
| size целое число | Определяет размер (в байтах) пакета(ов) ping. | ||
| source - | IP-адрес для использования при отправке пакета(ов) ping. | ||
| state - |
| Определяет, является ли ожидаемым результатом успех или неудача. | |
| ttl целое число | Значение времени жизни для ICMP-пакета(ов). | ||
Примечания
Примечание
- Для модуля сети общего назначения см. модуль net_ping.
- Для целей Windows используйте модуль win_ping.
- Для целей Python используйте модуль ping.
- Этот модуль работает только с подключением
network_cli. - Сведения об использовании командной строки и netconf см. в руководстве по параметрам платформы Junos OS Junos OS Platform Options.
- Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве по сети Ansible Ansible Network Guide.
- Дополнительную информацию об использовании Ansible для управления сетевыми устройствами Juniper см. на странице https://www.ansible.com/ansible-juniper.
Примеры
- name: Test reachability to 10.10.10.10
junos_ping:
dest: 10.10.10.10
- name: Test reachability to 10.20.20.20 using source and size set
junos_ping:
dest: 10.20.20.20
size: 1024
ttl: 128
- name: Test unreachability to 10.30.30.30 using interval
junos_ping:
dest: 10.30.30.30
interval: 3
state: absent
- name: Test reachability to 10.40.40.40 setting count and interface
junos_ping:
dest: 10.40.40.40
interface: fxp0
count: 20
size: 512
Возвращаемые значения
Общие значения возвращаемых данных описаны здесь, ниже приведены поля, уникальные для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| commands список | всегда | Список отправленных команд. Пример: ['ping 10.8.38.44 count 10 source 10.8.38.38 ttl 128'] |
| packet_loss строка | всегда | Процент потерянных пакетов. Пример: 0% |
| packets_rx целое число | всегда | Успешно полученные пакеты. Пример: 20 |
| packets_tx целое число | всегда | Успешно отправленные пакеты. Пример: 20 |
| rtt словарь | при успешном ping | Статистика времени задержки (RTT). Пример: {'avg': 2, 'max': 8, 'min': 1, 'stddev': 24} |
Статус
- Гарантия обратной совместимости интерфейса этого модуля не предоставляется. [предварительный просмотр]
- Этот модуль поддерживается командой Ansible Network Team. [сеть]
Поддержка Red Hat
Дополнительную информацию о поддержке этого модуля компанией Red Hat см. в этой статье из базы знаний Red Hat Red Hat Knowledge Base article.
Авторы
- Nilashish Chakraborty (@NilashishC)
Подсказка
Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/junos_ping_module.html
