net_ping - Тестирование доступности с помощью ping с сетевого устройства
Новое в версии 2.4.
Описание
- Тестирует доступность с помощью ping с сетевого устройства до удаленного узла назначения.
- Для целевых систем Windows используйте модуль win_ping вместо него.
- Для целевых систем с Python используйте модуль ping вместо него.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| count | Значение по умолчанию: 5 | Количество пакетов для отправки. |
| dest обязательно | IP-адрес или имя хоста (разрешаемый коммутатором) удаленного узла. | |
| source | IP-адрес источника. | |
| state |
| Определяет, является ли ожидаемый результат успешным или неудачным. |
| vrf | Значение по умолчанию: "default" | VRF для использования в пересылке. |
Примечания
Примечание
Примеры
- name: Test reachability to 10.10.10.10 using default vrf
net_ping:
dest: 10.10.10.10
- name: Test reachability to 10.20.20.20 using prod vrf
net_ping:
dest: 10.20.20.20
vrf: prod
- name: Test unreachability to 10.30.30.30 using default vrf
net_ping:
dest: 10.30.30.30
state: absent
- name: Test reachability to 10.40.40.40 using prod vrf and setting count and source
net_ping:
dest: 10.40.40.40
source: loopback0
vrf: prod
count: 20
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| commands список | всегда | Показывает отправленный командный запрос. Пример: ['ping vrf prod 10.40.40.40 count 20 source loopback0'] |
| packet_loss строка | всегда | Процент потерянных пакетов. Пример: 0% |
| packets_rx целое число | всегда | Успешно полученные пакеты. Пример: 20 |
| packets_tx целое число | всегда | Успешно отправленные пакеты. Пример: 20 |
| rtt словарь | всегда | Показатели RTT. Пример: {'avg': 2, 'max': 8, 'min': 1} |
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что его поддерживает сообщество Ansible. Подробнее см. Техническое обслуживание и поддержка модулей.
Список других модулей, поддерживаемых сообществом Ansible, см. здесь.
Автор
- Jacob McGill (@jmcgill298)
Подсказка
Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/net_ping_module.html
