Модуль community.general.ipinfoio_facts – Получение геолокационных данных IP-адреса хоста

Примечание

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

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

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

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

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

Описание

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

Параметры

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

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная Это действие не изменяет состояние.	Может работать в `check_mode` и возвращать прогноз изменения статуса без модификации целевого объекта.
diff_mode	Поддержка: Н/Д Это действие не изменяет состояние.	В режиме сравнения вернет детали изменений (или, возможно, требуемых изменений в `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:

END_OF_DOCUMENT_MARKER

Возвращаемые данные

Данные, возвращаемые этим модулем, добавляются/обновляются в фактах хоста 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"`

Авторы

Алексей Костюк (@akostyuk)

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

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