Модуль hetzner.hcloud.server_info – сбор информации о серверах Hetzner Cloud.

Примечание

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

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

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

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

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

Обзор

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

Псевдонимы: hcloud_server_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 server infos
  hetzner.hcloud.server_info:
  register: output

- name: Print the gathered infos
  debug:
    var: output.hcloud_server_info

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

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

Ключ	Описание
hcloud_server_info list / elements=string	Сведения о сервере в виде списка Возвращается: всегда
backup_window boolean	Временной интервал (UTC), в течение которого будет выполняться резервное копирование, или null, если резервное копирование отключено Возвращается: всегда Пример: `"22-02"`
created string	Момент создания сервера (в формате ISO-8601) Возвращается: всегда Пример: `"2023-11-06T13:36:56+00:00"`
datacenter string	Название центра обработки данных, в котором находится сервер. Устарело: Значение `hcloud_server_info[].datacenter` устарело и будет удалено после 1 июля 2026 года. Вместо него используйте значение `hcloud_server_info[].location`. См. https://docs.hetzner.cloud/changelog#2025-12-16-phasing-out-datacenters. Возвращается: всегда Пример: `"fsn1-dc14"`
delete_protection boolean добавлено в hetzner.hcloud 0.1.0	True, если сервер защищён от удаления Возвращается: всегда Пример: `false`
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"`
placement_group string добавлено в hetzner.hcloud 1.5.0	Группа размещения сервера Возвращается: всегда Пример: `"4711"`
private_networks list / elements=string	Список частных сетей, к которым подключён сервер (имена) Возвращается: всегда Пример: `["my-network", "another-network"]`
private_networks_info list / elements=dictionary	Список частных сетей, к которым подключён сервер (словарь с именем и IP-адресом) Возвращается: всегда Пример: `[{"ip": "192.168.1.1", "name": "my-network"}, {"ip": "10.185.50.40", "name": "another-network"}]`
rebuild_protection boolean добавлено в hetzner.hcloud 0.1.0	True, если сервер защищён от пересоздания Возвращается: всегда Пример: `false`
rescue_enabled boolean	True, если включён режим восстановления; при следующей перезагрузке сервер загрузится в систему восстановления Возвращается: всегда Пример: `false`
server_type string	Название типа сервера Возвращается: всегда Пример: `"cpx22"`
status string	Состояние сервера Возвращается: всегда Пример: `"running"`

Авторы

Lukas Kaemmerling (@LKaemmerling)

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

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