Модуль hetzner.hcloud.iso_info — сбор информации о списке ISO-образов Hetzner Cloud.

Примечание

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

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

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

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

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

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

Сбор информации о списке ISO-образов Hetzner Cloud.

Псевдонимы: hcloud_iso_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 строка	Фильтровать ISO-образы по совместимой архитектуре. Допустимые значения: `"x86"` `"arm"`
id целое число	Идентификатор ISO-образа, сведения о котором нужно получить. Модуль завершится с ошибкой, если указанный идентификатор недействителен.
include_architecture_wildcard логический	Включать ISO-образы с любой архитектурой (значение архитектуры равно null). Работает только при указании фильтра архитектуры. Допустимые значения: `false` `true`
name строка	Имя ISO-образа, сведения о котором нужно получить.

См. также

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

Примеры

- name: Gather hcloud ISO type infos
  hetzner.hcloud.iso_info:
  register: output

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

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

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

Ключ	Описание
hcloud_iso_info список / элементы=строка	Сведения о типах ISO-образов в виде списка Возвращается: всегда
architecture строка	Тип архитектуры процессора, с которой совместим этот ISO-образ. Значение None означает отсутствие ограничений по архитектуре (любая архитектура). Возвращается: если поддерживается Пример: `"x86"`
deprecated строка	Временная метка устаревания в формате ISO 8601; значение None означает, что ISO-образ всё ещё доступен. После наступления даты устаревания подключить ISO-образ к серверам будет невозможно. Это поле устарело. Используйте `deprecation`. Возвращается: всегда Пример: `"2024-12-01T00:00:00+00:00"`
deprecation словарь	Описывает, устарел ли ресурс, когда и каким образом. Если значение этого поля равно None, ресурс не устарел. Если поле содержит значение, ресурс считается устаревшим. Возвращается: если ресурс устарел
announced строка	Дата объявления об устаревании. Возвращается: всегда Пример: `"2021-11-01T00:00:00+00:00"`
unavailable_after строка	После указанного здесь времени ресурс перестанет отображаться в общем списке ресурсов этого типа и не сможет использоваться в новых ресурсах. Например, если это образ, после указанной даты на его основе нельзя будет создавать новые серверы. Возвращается: всегда Пример: `"2021-12-01T00:00:00+00:00"`
description строка	Описание ISO-образа Возвращается: всегда Пример: `"Debian 12.0 (amd64/netinstall)"`
id целое число	Идентификатор ISO-образа Возвращается: всегда Пример: `22110`
name строка	Уникальный идентификатор ISO-образа. Задаётся только для общедоступных ISO-образов Возвращается: всегда Пример: `"debian-12.0.0-amd64-netinst.iso"`
type строка	Тип ISO-образа: `public` или `private`. Возвращается: всегда Пример: `"public"`

Авторы

Patrice Le Guyader (@patlegu)
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/iso_info_module.html