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

• Synopsis
• Parameters
• Notes
• Examples
• Returned Facts
• Status
  • Author

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

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 flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Author

• Aleksei Kostiuk (@akostyuk)