New in version 2.0.
parameter | required | default | choices | comments |
---|---|---|---|---|
api_url |
no | https://api.ipify.org | URL of the ipify.org API service. ?format=json will be appended per default. | |
timeout (added in 2.3) |
no | 10 | HTTP connection timeout in seconds. |
# Gather IP facts from ipify.org - name: get my public IP ipify_facts: # Gather IP facts from your own ipify service endpoint with a custom timeout - name: get my public IP ipify_facts: api_url: http://api.example.com/ipify timeout: 20
Common return values are documented here Return Values, the following are the fields unique to this module:
name | description | returned | type | sample |
---|---|---|---|---|
ipify_public_ip | Public IP of the internet gateway. | success | string | 1.2.3.4 |
Note
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
This module is community maintained without core committer oversight.
For more information on what this means please read Module Support
For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Helping Testing PRs and Developing Modules.