ipinfoio_facts – Retrieve IP geolocation facts of a host’s IP address

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]

Authors

• Aleksei Kostiuk (@akostyuk)

Hint

If you notice any issues in this documentation, you can edit this document to improve it.