Модуль hetzner.hcloud.image_info — сбор информации об образах Hetzner Cloud.

Примечание

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

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

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

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

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

Обзор

Сбор информации об образах Hetzner Cloud.

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

Требования

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

python-dateutil >= 2.7.5
requests >=2.20

Параметры

Параметр	Комментарии
api_endpoint псевдонимы: endpoint строка	Конечная точка API Hetzner Cloud. Это значение также можно задать с помощью переменной окружения `HCLOUD_ENDPOINT`. По умолчанию: `"https://api.hetzner.cloud/v1"`
api_endpoint_hetzner строка	Конечная точка API Hetzner. Это значение также можно задать с помощью переменной окружения `HETZNER_ENDPOINT`. По умолчанию: `"https://api.hetzner.com/v1"`
api_token строка / обязательный	Токен для API Hetzner Cloud. Это значение также можно задать с помощью переменной окружения `HCLOUD_TOKEN`.
architecture строка	Архитектура образов, которые требуется получить. Варианты: `"x86"` `"arm"`
id целое число	Идентификатор образа, который требуется получить. Если указанный идентификатор недействителен, модуль завершится с ошибкой.
label_selector строка	Селектор меток для образов, которые требуется получить.
name строка	Имя образа, который требуется получить.
type строка	Тип образов, которые требуется получить. Варианты: `"system"` ← (по умолчанию) `"snapshot"` `"backup"`

См. также

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

Примеры

- name: Gather hcloud image infos
  hetzner.hcloud.image_info:
  register: output

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

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

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

Ключ	Описание
hcloud_image_info список / элементы=строка	Информация об образах в виде списка Возвращается: всегда
architecture строка	Архитектура, с которой совместим образ Возвращается: всегда Пример: `"x86"`
description строка	Подробное описание образа Возвращается: всегда Пример: `"Ubuntu 18.04 Standard 64 bit"`
id целое число	Числовой идентификатор образа Возвращается: всегда Пример: `1937415`
labels словарь	Метки, заданные пользователем (пары ключ-значение) Возвращается: всегда
name строка	Имя образа Возвращается: всегда Пример: `"ubuntu-22.04"`
os_flavor строка	Разновидность ОС образа Возвращается: всегда Пример: `"ubuntu"`
os_version строка	Версия ОС образа Возвращается: всегда Пример: `"18.04"`
status строка	Статус образа Возвращается: всегда Пример: `"available"`
type строка	Тип образа Возвращается: всегда Пример: `"system"`

Авторы

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/image_info_module.html