wiki-terraform-provider-decort/4.5.2/07.01.09-Resource_decort_image.md

Функция доступна в провайдере версии 2.0 и выше.

Resource функция decort_image служит для управления образом.

Изменения в версии 3.4.0

• В возвращаемые значения добавлено поле present_to

Аргументы

Resource функция decort_image для создания образа принимает следующие аргументы:

Аргумент	Тип	Обязательный	Описание
name	string	✔️	Имя образа При изменении - изменяет название образа
url	string	✔️	Адрес образа
gid	int	✔️	Grid id образа
boot_type	string	✔️	Тип загрузки образа, возможные варианты: "bios" или "uefi"
type	string	✔️	Тип образа, возможные варианты - "linux", "windows"
drivers	[]string	✔️	Драйвера, возможные варианты - ["KVM_X86", "SVA_KVM_X86"], ["KVM_X86"], ["SVA_KVM_X86"]
account_id	int	❌	ID аккаунта владельца образа, может быть использован как при создании, так и редактировании образа
username	string	❌	Имя пользователя, может быть использован как при создании, так и редактировании образа
password	string	❌	Пароль пользователя, может быть использован как при создании, так и редактировании образа
username_dl	string	❌	Имя пользователя для загрузки бинарных данных, может быть использован как при создании, так и редактировании образа
password_dl	string	❌	Пароль пользователя для загрузки бинарных данных, может быть использован как при создании, так и редактировании образа
sync	bool	❌	Синхронное создание образа, используется при создании
sep_id	int	❌	ID storage endpoint
pool_name	string	❌	Пул для создания образа
architecture	string	❌	Используется при создании, архитектура системы образа доступные значения: "X86_64" по-умолчанию "X86_64"
enabled	bool	❌	Доступность образа, используется при редактировании ресурса
shared_with	[]int	❌	Настройка доступа образа аккаунтам используется на уже созданном ресурсе, пустой маасив - удаление всех доступов, если они были
computeci_id	int	❌	Установка computeci, используется на уже созданном ресурсе, чтобы сбросить, необходимо передать 0
enabled_stacks	[]string	❌	Доступные стаки, используется на уже созданном ресурсе для удаления всех доступных стаков, необходимо передать пустой массив
permanently	bool	❌	Мгновенное удаление можно использовать перед удалением
reason	string	❌	Причина удаления можно использовать перед удалением

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

В случае успешного выполнения resource функция decort_image возвращает в указанную при вызове переменную следующие значения:

Параметр	Тип	Описание
account_id	int	accountId привязки образа
architecture	string	Архитектура образа, возможен вариант X86_64 или PPC64_LE
boot_type	string	Тип запуска ОС - bios или uefi
bootable	bool	Является ли образ загрузочным
computeci_id	int	ID вычислительного ресурса
desc	string	Описание образа
drivers	[]string	Список используемых драйверов
enabled	bool	Доступность образа
gid	int	ID платформы, где образ будет создан
guid	int	Внутренний id образа, совпадает с image_id
history	object{id: int, guid: int, timestamp: int}	История обновлений образа
hot_resize	bool	Использует ли машина горячее изменение размера образа
image_type	string	Тип образа: linux, windows или другой
last_modified	int	Дата последнего изменения
link_to	int	Привязка к образу, используется в виртуальных образах
meta	[]string	Мета информация об образе
milestones	int	Вехи
name	string	Название образа
password	string	Пароль для образа
password_dl	string	Пароль для загрузки двоичных файлов
permanently	bool	Удаление образа: мгновенное или нет
pool_name	string	Пул, в котором был создан образ
provider_name	string	Наименование провайдера
purge_attempts	int	Попытки
present_to	[]int	Список ID ресурсов для который предоставлен образ
reference_id	string	ID ссылки
res_id	string	ID ресурса
res_name	string	Наименование ресурса
rescuecd	bool	cd или нет
sep_id	int	storage endpoint provider ID
size	int	Размер образа
status	string	Статус образа
tech_status	string	Технический статус
unc_path	string	unc path
url	string	Адрес, которого осуществлялась загрузка образа
username	string	Имя пользователя образа
username_dl	string	Имя пользователя для загрузки двоичных файлов
version	string	Версия

Пример использования

Пример вызова resource функции decort_image:

resource "decort_image" "my_image" {
  # Наименование образа
  # Обязательный параметр
  # string
  name = "image_name"

  # grid ID платформы
  # Обязательный параметр
  # int
  gid = 2002

  # Драйверы компьютов, подходящие для данного образа
  # Обязательный параметр
  # []string
  drivers = ["KVM_X86"]

  # Тип образа (linux, windows и др.)
  # Обязательный параметр
  # string
  type = "linux"

  # Прямая ссылка на образ
  # Обязательный параметр
  # string
  url = "https://dl-cdn.alpinelinux.org/alpine/v3.17/releases/x86_64/alpine-virt-3.17.3-x86_64.iso"

  # Тип загрузчика (bios/uefi)
  # Обязательный параметр
  # string
  boot_type = "bios"

  # ID аккаунта
  # Опциональный параметр
  # int
  account_id = 138

  # Поддержка hot resize
  # Опциональный параметр
  # bool
  hot_resize = true

  # Юзернейм для образа
  # Опциональный параметр
  # string
  username = "userx"

  # Пароль для образа
  # Опциональный параметр
  # string
  password = "passx"

  # Юзернейм для загрузки binary media
  # Опциональный параметр
  # string
  username_dl = "userxdl"

  # Пароль для загрузки binary media
  # Опциональный параметр
  # string
  password_dl = "passxdl"

  # Storage endpoint provider ID
  # Опциональный параметр
  # int
  sep_id = 1

  # Pool для образа
  # Опциональный параметр
  # string
  pool_name = "pool"

  # Архитектура обраща (X86_64 / PPC64_LE)
  # Опциональный параметр
  # string
  architecture = "PPC64_LE"
}

# once the above directive completes,  will be accessible
# as decort_image.my_image

После успешного завершения такого вызова decort_image в переменной decort_image.my_image будут сохранены возвращаемые значения.