pong
on success¶A trivial test module, this module always returns pong
on successful contact. It does not make sense in playbooks, but it is useful from /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 win_ping module instead.
For Network targets, use the net_ping module instead.
Parameter | Choices/Defaults | Comments |
---|---|---|
data
string
|
Default: "pong"
|
Data to return for the
ping return value.If this parameter is set to
crash , the module will cause an exception. |
See also
The official documentation on the net_ping module.
The official documentation on the win_ping module.
# 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
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
ping
string
|
success |
value provided with the data parameter
Sample:
pong
|
This module is guaranteed to have no backward incompatible interface changes going forward. [stableinterface]
This module is maintained by the Ansible Core Team. [core]
More information about Red Hat’s support of this module is available from this Red Hat Knowledge Base article.
Ansible Core Team
Michael DeHaan
Hint
If you notice any issues in this documentation you can edit this document to improve it.