community.general.ipinfoio_facts – Получение географических данных об IP-адресе хоста
Примечание
Этот плагин входит в коллекцию community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в книге задач укажите: community.general.ipinfoio_facts.
Описание
- Сбор географических данных об IP-адресе хоста с использованием API ipinfo.io
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| http_agent строка | Значение по умолчанию: "ansible-ipinfoio-module/0.0.1" | Установить http user agent |
| timeout целое число | Значение по умолчанию: 10 | Таймаут подключения HTTP в секундах |
Примечания
Примечание
- Для получения дополнительной информации посетите 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 |
Авторы
- Алексей Костюк (@akostyuk)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/ipinfoio_facts_module.html
