Модуль community.general.ipinfoio_facts — получение геолокационных сведений об IP-адресе узла

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в состав ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general.

Чтобы использовать модуль в плейбуке, укажите: community.general.ipinfoio_facts.

Краткое описание
Параметры
Атрибуты
Примечания
Примеры
Возвращаемые факты

Краткое описание

Сбор геолокационных сведений об IP-адресе узла с помощью API ipinfo.io.

Параметры

Параметр	Комментарии
http_agent строка	Задает пользовательский агент HTTP. По умолчанию: `"ansible-ipinfoio-module/0.0.1"`
timeout целое число	Тайм-аут HTTP-соединения в секундах. По умолчанию: `10`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная Это действие не изменяет состояние.	Может работать в режиме `check_mode` и возвращать прогноз изменения состояния, не изменяя целевой узел.
diff_mode	Поддержка: не применимо Это действие не изменяет состояние.	В режиме diff возвращает сведения об изменениях (или о возможных изменениях в `check_mode`).
facts	Поддержка: полная	Действие возвращает словарь `ansible_facts`, обновляющий существующие факты узла.

Примечания

Примечание

Дополнительную информацию см. на сайте http://ipinfo.io/.

Примеры

# Retrieve geolocation data of a host's IP address
- name: Get IP geolocation data
  community.general.ipinfoio_facts:

Возвращаемые факты

Факты, возвращаемые этим модулем, добавляются в факты узла hostvars или обновляют их; на них можно ссылаться по имени так же, как на любые другие факты узла. Для их использования не требуется регистрировать их.

Ключ	Описание
city строка	Название города. Возвращается: при успешном выполнении Пример: `"Mountain View"`
country строка	Код страны ISO 3166-1 alpha-2. Возвращается: при успешном выполнении Пример: `"US"`
hostname строка	Доменное имя. Возвращается: при успешном выполнении Пример: `"google-public-dns-a.google.com"`
ip строка	Публичный IP-адрес узла. Возвращается: при успешном выполнении Пример: `"8.8.8.8"`
loc строка	Широта и долгота местоположения. Возвращается: при успешном выполнении Пример: `"37.3860,-122.0838"`
org строка	Название организации. Возвращается: при успешном выполнении Пример: `"AS3356 Level 3 Communications, Inc."`
postal строка	Почтовый индекс. Возвращается: при успешном выполнении Пример: `"94035"`
region строка	Название штата или провинции. Возвращается: при успешном выполнении Пример: `"California"`

Авторы

Aleksei Kostiuk (@akostyuk)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/ipinfoio_facts_module.html