ipinfoio_facts – Retrieve IP geolocation facts of a host’s IP address¶
New in version 2.3.
Synopsis¶
Gather IP geolocation facts of a host’s IP address using ipinfo.io API
Parameters¶
| Parameter | Choices/Defaults | Comments |
|---|---|---|
|
http_agent
-
|
Default: "ansible-ipinfoio-module/0.0.1"
|
Set http user agent
|
|
timeout
-
|
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
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.
| Fact | Returned | Description |
|---|---|---|
|
city
string
|
City name
Sample:
Mountain View
|
|
|
country
string
|
ISO 3166-1 alpha-2 country code
Sample:
US
|
|
|
hostname
string
|
Domain name
Sample:
google-public-dns-a.google.com
|
|
|
ip
string
|
Public IP address of a host
Sample:
8.8.8.8
|
|
|
loc
string
|
Latitude and Longitude of the location
Sample:
37.3860,-122.0838
|
|
|
org
string
|
organization's name
Sample:
AS3356 Level 3 Communications, Inc.
|
|
|
postal
string
|
Postal code
Sample:
94035
|
|
|
region
string
|
State or province name
Sample:
California
|
Status¶
This module is not guaranteed to have a backwards compatible interface. [preview]
This module is maintained by the Ansible Community. [community]