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

From Get docs
Ansible/docs/2.8/modules/ipinfoio facts module


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

Authors

  • Aleksei Kostiuk (@akostyuk)

Hint

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


© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/ipinfoio_facts_module.html