ansible.netcommon.net_ping – Tests reachability using ping from a network device
Note
This plugin is part of the ansible.netcommon collection (version 2.4.0).
You might already have this collection installed if you are using the ansible
package. It is not included in ansible-core
. To check whether it is installed, run ansible-galaxy collection list
.
To install it, use: ansible-galaxy collection install ansible.netcommon
.
To use it in a playbook, specify: ansible.netcommon.net_ping
.
New in version 1.0.0: of ansible.netcommon
Synopsis
- Tests reachability using ping from network device to a remote destination.
Note
This module has a corresponding action plugin.
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
count string | Default: 5 | Number of packets to send. |
dest string / required | The IP Address or hostname (resolvable by switch) of the remote node. | |
source string | The source IP Address. | |
state string |
| Determines if the expected result is success or fail. |
vrf string | Default: "default" | The VRF to use for forwarding. |
Notes
Note
- For targets running Python, use the ansible.builtin.shell module along with ping command instead.
- This module is supported on
ansible_network_os
network platforms. See the Network Platform Options for details.
Examples
- name: Test reachability to 10.10.10.10 using default vrf ansible.netcommon.net_ping: dest: 10.10.10.10 - name: Test reachability to 10.20.20.20 using prod vrf ansible.netcommon.net_ping: dest: 10.20.20.20 vrf: prod - name: Test unreachability to 10.30.30.30 using default vrf ansible.netcommon.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 ansible.netcommon.net_ping: dest: 10.40.40.40 source: loopback0 vrf: prod count: 20 - Note: - For targets running Python, use the M(ansible.builtin.shell) module along with ping command instead. - Example: name: ping shell: ping -c 1 <remote-ip>
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
commands list / elements=string | always | Show the command sent. Sample: ['ping vrf prod 10.40.40.40 count 20 source loopback0'] |
packet_loss string | always | Percentage of packets lost. Sample: 0% |
packets_rx integer | always | Packets successfully received. Sample: 20 |
packets_tx integer | always | Packets successfully transmitted. Sample: 20 |
rtt dictionary | always | Show RTT stats. Sample: {'avg': 2, 'max': 8, 'min': 1} |
Authors
- Jacob McGill (@jmcgill298)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/ansible/netcommon/net_ping_module.html