community.general.ipinfoio_facts – Retrieve IP geolocation facts of a host’s IP address¶
Note
This plugin is part of the community.general collection (version 2.5.1).
To install it use: ansible-galaxy collection install community.general
.
To use it in a playbook, specify: community.general.ipinfoio_facts
.
Parameters¶
Parameter | Choices/Defaults | Comments |
---|---|---|
http_agent
string
|
Default: "ansible-ipinfoio-module/0.0.1"
|
Set http user agent
|
timeout
integer
|
Default: 10
|
HTTP connection timeout in seconds
|
Notes¶
Note
Check http://ipinfo.io/ for more information
Examples¶
# Retrieve geolocation data of a host's IP address
- name: Get IP geolocation data
community.general.ipinfoio_facts:
Returned Facts¶
Facts returned by this module are added/updated in the hostvars
host facts and can be referenced by name just like any other host fact. They do not need to be registered in order to use them.
Authors¶
Aleksei Kostiuk (@akostyuk)