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

New in version 2.3.

Synopsis
Parameters
Notes
Examples
Returned Facts
Status
Maintenance
- 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 ¶

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

Maintenance ¶

This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.

For a list of other modules that are also maintained by the Ansible Community, see here.

Author ¶

Aleksei Kostiuk (@akostyuk)

Hint

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