Модуль hetzner.hcloud.network_info — сбор информации о сетях Hetzner Cloud.

Примечание

Этот модуль входит в коллекцию hetzner.hcloud (версия 6.9.0).

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

Чтобы установить её, используйте: ansible-galaxy collection install hetzner.hcloud. Для работы с этим модулем требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: hetzner.hcloud.network_info.

Краткое описание
Требования
Параметры
См. также
Примеры
Возвращаемые значения

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

Сбор информации о сетях Hetzner Cloud.

Псевдонимы: hcloud_network_info

Требования

Следующие компоненты должны быть установлены на узле, на котором выполняется этот модуль.

python-dateutil >= 2.7.5
requests >=2.20

Параметры

Параметр	Комментарии
api_endpoint псевдонимы: endpoint string	Конечная точка API Hetzner Cloud. Эту настройку также можно задать с помощью переменной среды `HCLOUD_ENDPOINT`. По умолчанию: `"https://api.hetzner.cloud/v1"`
api_endpoint_hetzner string	Конечная точка API Hetzner. Эту настройку также можно задать с помощью переменной среды `HETZNER_ENDPOINT`. По умолчанию: `"https://api.hetzner.com/v1"`
api_token string / обязательный	Токен API Hetzner Cloud. Эту настройку также можно задать с помощью переменной среды `HCLOUD_TOKEN`.
id integer	Идентификатор сети, которую нужно получить. Модуль завершится с ошибкой, если указанный идентификатор недействителен.
label_selector string	Селектор меток для сети, которую нужно получить.
name string	Имя сети, которую нужно получить.

См. также

Документация по API Hetzner: Полный справочник по API Hetzner.

Примеры

- name: Gather hcloud network info
  local_action:
    module: hcloud_network_info

- name: Print the gathered info
  debug:
    var: hcloud_network_info

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
hcloud_network_info list / elements=string	Информация о сети в виде списка Возвращается: всегда
delete_protection boolean добавлено в hetzner.hcloud 0.1.0	Значение True, если сеть защищена от удаления Возвращается: всегда
expose_routes_to_vswitch boolean	Указывает, следует ли предоставлять маршруты из этой сети для подключения vSwitch. Возвращается: всегда Пример: `false`
id integer	Числовой идентификатор сети Возвращается: всегда Пример: `1937415`
ip_range string	Диапазон IP-адресов сети Возвращается: всегда Пример: `"10.0.0.0/16"`
labels dictionary	Метки сети Возвращается: всегда
name string	Имя сети Возвращается: всегда Пример: `"awesome-network"`
routes list / elements=string	Маршруты, относящиеся к сети Возвращается: всегда
gateway string	Шлюз этого маршрута Возвращается: всегда Пример: `"10.0.0.1"`
ip_range string	Целевая сеть или узел этого маршрута. Возвращается: всегда Пример: `"10.0.0.0/16"`
servers list / elements=string	Серверы, подключённые к сети Возвращается: всегда
backup_window boolean	Период времени (UTC), в течение которого будет выполняться резервное копирование, или null, если резервное копирование не включено Возвращается: всегда Пример: `"22-02"`
datacenter string	Название дата-центра сервера Устарело: Значение `hcloud_network_info[].servers[].datacenter` устарело и будет удалено после 1 июля 2026 года. Вместо него используйте значение `hcloud_network_info[].servers[].location`. См. https://docs.hetzner.cloud/changelog#2025-12-16-phasing-out-datacenters. Возвращается: всегда Пример: `"fsn1-dc14"`
id integer	Числовой идентификатор сервера Возвращается: всегда Пример: `1937415`
ipv4_address string	Публичный IPv4-адрес сервера; отсутствует, если он не задан Возвращается: всегда Пример: `"116.203.104.109"`
ipv6 string	Сеть IPv6 сервера; отсутствует, если она не задана Возвращается: всегда Пример: `"2a01:4f8:1c1c:c140::/64"`
labels dictionary	Метки, заданные пользователем (пары ключ-значение) Возвращается: всегда
location string	Название местоположения сервера Возвращается: всегда Пример: `"fsn1"`
name string	Имя сервера Возвращается: всегда Пример: `"my-server"`
rescue_enabled boolean	Значение True, если включён режим восстановления; при следующей перезагрузке сервер загрузится в систему восстановления Возвращается: всегда Пример: `false`
server_type string	Название типа сервера Возвращается: всегда Пример: `"cpx22"`
status string	Состояние сервера Возвращается: всегда Пример: `"running"`
subnetworks list / elements=string	Подсети, относящиеся к сети Возвращается: всегда
gateway string	Шлюз этой подсети Возвращается: всегда Пример: `"10.0.0.1"`
ip_range string	Диапазон IP-адресов подсети Возвращается: всегда Пример: `"10.0.0.0/24"`
network_zone string	Сеть, к которой относится подсеть. Возвращается: всегда Пример: `"eu-central"`
type string	Тип подсети. Возвращается: всегда Пример: `"cloud"`

Авторы

Christopher Schmitt (@cschmitt-hcloud)

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

© 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/hetzner/hcloud/network_info_module.html