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 по адресу ../network/user_guide/platform_junos. Объект словаря, содержащий детали подключения.
	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 -		Варианты: absent present ←	Определяет, ожидаемый результат - успех или неудача.
ttl целое число			Значение времени жизни для ICMP-пакета(ов).

Примечания

Примечание

Для модуля общего назначения сети см. модуль net_ping.
Для целей Windows используйте модуль win_ping.
Для целей Python используйте модуль ping.
Для получения информации по использованию CLI и netconf, обратитесь к руководству Junos OS Platform Options guide.
Для получения дополнительной информации об использовании 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 Knowledge Base.

Авторы

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.8/modules/junos_ping_module.html