Documentation

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

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)

Hint

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