community.general.ipinfoio_facts – Получение географических данных об IP-адресе хоста
Примечание
Этот плагин входит в коллекцию community.general (версия 2.0.1).
Для его установки используйте: ansible-galaxy collection install community.general.
Чтобы использовать его в playbook, укажите: 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/ipinfoio_facts_module.html
