o nnh @sBddlmZdZdZdZddlmZddZedkred Sd S) ) annotationsa --- module: ping version_added: historical short_description: Try to connect to host, verify a usable python and return V(pong) on success description: - A trivial test module, this module always returns V(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(ansible.windows.win_ping) module instead. - For Network targets, use the M(ansible.netcommon.net_ping) module instead. options: data: description: - Data to return for the RV(ping) return value. - If this parameter is set to V(crash), the module will cause an exception. type: str default: pong extends_documentation_fragment: - action_common_attributes attributes: check_mode: support: full diff_mode: support: none platform: platforms: posix seealso: - module: ansible.netcommon.net_ping - module: ansible.windows.win_ping author: - Ansible Core Team - Michael DeHaan a # Test we can logon to 'webservers' and execute python with json lib. # ansible webservers -m ansible.builtin.ping - name: Example from an Ansible Playbook ansible.builtin.ping: - name: Induce an exception to see what happens ansible.builtin.ping: data: crash zx ping: description: Value provided with the O(data) parameter. returned: success type: str sample: pong ) AnsibleModulecCsTtttdddddd}|jddkrtd t|jdd }|jd i|dS) Nstrpong)typedefault)dataT) argument_specsupports_check_modercrashboom)ping)rdictparams Exception exit_json)moduleresultrr?/usr/local/lib/python3.10/dist-packages/ansible/modules/ping.pymainEs r__main__N) __future__r DOCUMENTATIONEXAMPLESRETURNansible.module_utils.basicrr__name__rrrrs $