модуль community.general.ipify_facts — получение публичного IP-адреса интернет-шлюза

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install community.general.

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

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

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

Если вы находитесь за NAT и хотите узнать публичный IP-адрес интернет-шлюза.

Параметры

Параметр	Комментарии
api_url string	URL API-сервиса ipify.org. По умолчанию добавляется `?format=json`. По умолчанию: `"https://api.ipify.org/"`
timeout integer	Тайм-аут HTTP-соединения в секундах. По умолчанию: `10`
validate_certs boolean	Если установлено значение `false`, сертификаты SSL не проверяются. Варианты: `false` `true` ← (по умолчанию)

Атрибуты

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

Примечания

Примечание

Дополнительную информацию можно найти на сайте https://www.ipify.org.

Примеры

# Gather IP facts from ipify.org
- name: Get my public IP
  community.general.ipify_facts:

# Gather IP facts from your own ipify service endpoint with a custom timeout
- name: Get my public IP
  community.general.ipify_facts:
    api_url: http://api.example.com/ipify
    timeout: 20

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

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

Ключ	Описание
ipify_public_ip string	Публичный IP-адрес интернет-шлюза. Возвращается: при успехе Пример: `"1.2.3.4"`

Авторы

René Moser (@resmo)

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

© 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/ipify_facts_module.html