Модуль community.general.ip2location_info — получение геолокационной информации по IP-адресу узла
Примечание
Этот модуль входит в коллекцию community.general (версия 12.6.1).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install community.general.
Чтобы использовать коллекцию в плейбуке, укажите: community.general.ip2location_info.
Добавлено в community.general 12.2.0
Краткое описание
- Сбор геолокационной информации по IP-адресу узла с помощью API api.ip2location.io, не требующего ключа.
Параметры
Параметр | Комментарии |
|---|---|
http_agent string | Задает HTTP-агент пользователя. По умолчанию: |
ip string | IP-адрес, для которого нужно получить геолокационную информацию. |
timeout integer | Тайм-аут HTTP-соединения в секундах. По умолчанию: |
Атрибуты
Атрибут | Поддержка | Описание |
|---|---|---|
check_mode | Поддержка: полная Это действие не изменяет состояние. | Может работать в режиме |
diff_mode | Поддержка: не применимо Это действие не изменяет состояние. | В режиме diff возвращает сведения об изменениях (или о возможных изменениях в |
Примечания
Примечание
- Этот модуль использует конечную точку, не требующую ключа, для которой действуют ограничения на использование. Дополнительную информацию см. на странице https://www.ip2location.io/ip2location-documentation.
Примеры
# Retrieve geolocation data of a host's IP address
- name: Get IP geolocation data
community.general.ip2location_info:
register: result
- name: Show some information
ansible.builtin.debug:
msg: "{{ result.ip }} is located in {{ result.country_code }} ({{ result.country_name }})"
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
as string | Название автономной системы (AS). Возвращается: при успехе Пример: |
asn string | Номер автономной системы (ASN). Возвращается: при успехе Пример: |
city_name string | Название города. Возвращается: при успехе Пример: |
country_code string | Код страны по стандарту ISO 3166-1 alpha-2. Возвращается: при успехе Пример: |
country_name string | Название страны согласно ISO 3166. Возвращается: при успехе Пример: |
ip string | Публичный IP-адрес узла. Возвращается: при успехе Пример: |
is_proxy boolean | Является ли адрес прокси-сервером. Возвращается: при успехе Пример: |
latitude float | Широта города. Возвращается: при успехе Пример: |
longitude float | Долгота города. Возвращается: при успехе Пример: |
region_name string | Название штата или провинции. Возвращается: при успехе Пример: |
time_zone string | Часовой пояс UTC (с учетом перехода на летнее время). Возвращается: при успехе Пример: |
zip_code string | Почтовый индекс. Возвращается: при успехе Пример: |
Ссылки на коллекцию
© 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/ip2location_info_module.html
