ansible / ansible.builtin / v2.7.7 / module / ping Try to connect to host, verify a usable python and return C(pong) on success | "added in version" historical of ansible.builtin" Authors: Ansible Core Team, Michael DeHaan stableinterface | supported by coreansible.builtin.ping (v2.7.7) — module
pip
Install with pip install ansible==2.7.7
A trivial test module, this module always returns C(pong) on successful contact. It does not make sense in playbooks, but it is useful from C(/usr/bin/ansible) to verify the ability to login and that a usable Python is configured.
This is NOT ICMP ping, this is just a trivial test module that requires Python on the remote-node.
For Windows targets, use the M(win_ping) module instead.
For Network targets, use the M(net_ping) module instead.
# Test we can logon to 'webservers' and execute python with json lib. # ansible webservers -m ping # Example from an Ansible Playbook - ping:
# Induce an exception to see what happens - ping: data: crash
data: default: pong description: - Data to return for the C(ping) return value. - If this parameter is set to C(crash), the module will cause an exception.
ping: description: value provided with the data parameter returned: success sample: pong type: string