You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

169 lines
8.5 KiB

4 weeks ago
_Resource_ функция **dynamix_image_from_platform_disk** служит для управления образом, созданным из платформенного диска.
## Аргументы
_Resource_ функция **dynamix_image_from_platform_disk** для создания образа принимает следующие аргументы:
| Аргумент | Тип | Обязательный | Описание |
| --- | --- | --- | --- |
| disk_id | int | :heavy_check_mark: | ID платформенного диска, из которого будет создан образ |
| name | string | :heavy_check_mark: | Имя образа<br/>При изменении - изменяет название образа |
| boot_type | string | :heavy_check_mark: | Тип загрузки образа,<br/>возможные варианты: "bios" или "uefi" |
| type | string | :heavy_check_mark: | Тип образа,<br />возможные варианты - "linux", "windows" |
| architecture | string | :heavy_check_mark: | Архитектура образа,<br />возможные варианты - "X86_64" |
| account_id | int | :x: | ID аккаунта владельца образа |
| username | string | :x: | Имя пользователя |
| password | string | :x: | Пароль пользователя |
| sep_id | int | :x: | ID storage endpoint |
| drivers | []string | :x: | Драйвера,<br/>возможные варианты - ["KVM_X86", "SVA_KVM_X86"] | |
| pool_name | string | :x: | Пул для создания образа |
| bootable | bool | :x: | Является ли образ загрузочным. Значение по умолчанию: true. |
| hot_resize | bool | :x: | Использует ли машина горячее изменение размера образа |
| async_mode | bool | :x: | Синхронное создание образа, используется при создании. Значение по умолчанию: false. |
| permanently | bool | :x: | Мгновенное удаление<br/>можно использовать перед удалением |
## Возвращаемые значения
В случае успешного выполнения _resource_ функция **dynamix_image_from_platform_disk** возвращает в указанную при вызове переменную следующие значения:
| Параметр | Тип | Описание |
| --- | --- | --- |
| account_id | int | accountId привязки образа |
| ckey | string | Ckey |
| acl | string | Информация об аккаунте |
| architecture | string | Архитектура образа, возможен вариант X86_64 |
| boot_type | string | Тип запуска ОС - bios или uefi |
| bootable | bool | Является ли образ загрузочным |
| compute_ci_id | int | ID вычислительного ресурса |
| cd_presented_to | string | Подключение образа |
| deleted_time | int | Время удаления ресурса |
| 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 | Использует ли машина горячее изменение размера образа |
| type | string | Тип образа: linux, windows или другой |
| last_modified | int | Дата последнего изменения |
| link_to | int | Привязка к образу, используется в виртуальных образах |
| milestones | int | Вехи |
| image_name | string | Название образа |
| network_interface_naming | string | Название сетевого интерфейса |
| permanently | bool | Удаление образа: мгновенное или нет |
| pool_name | string | Пул, в котором был создан образ |
| provider_name | string | Наименование провайдера |
| purge_attempts | int | Попытки |
| present_to | []int | Список ID ресурсов для который предоставлен образ |
| res_id | string | ID ресурса |
| rescuecd | bool | cd или нет |
| sep_id | int | storage endpoint provider ID |
| shared_with | []int | Список ресурсов, имеющих доступ к образу |
| size | int | Размер образа |
| status | string | Статус образа |
| tech_status | string | Технический статус |
| unc_path | string | unc path |
| version | string | Версия |
## Пример использования
Пример вызова _resource_ функции **dynamix_image_from_platform_disk**:
```terraform
resource "dynamix_image_from_platform_disk" "img" {
#id диска
#используется для создания образа
#обязательный параметр
#тип - целое число
disk_id = 1234
#наименование образа
#используется для создания и обновления образа
#обязательный параметр
#тип - строка
name = "image_name"
#тип загрузчика
#используется для создания образа
#обязательный параметр
#возможные значения - bios, uefi
#тип - строка
boot_type = "bios"
#тип образа (linux, windows и др.)
#используется для создания образа
#обязательный параметр
#тип - строка
type = "linux"
#архитектура образа
#используется для создания образа
#обязательный параметр
#возможные значения - X86_64
#тип - строка
architecture = "X86_64"
#имя пользователя для образа
#используется для создания образа
#опциональный параметр
#тип - строка
#username = "userx"
#пароль для образа
#используется для создания образа
#опциональный параметр
#тип - строка
#password = "passx"
#id аккаунта
#используется для создания образа
#опциональный параметр
#тип - целое число
#account_id = 138
#id сепа для образа
#используется для создания образа
#опциональный параметр
#тип - целое число
#sep_id = 1
#pool для образа
#используется для создания образа
#опциональный параметр
#тип - строка
#pool_name = "pool"
#драйверы компьютов, подходящие для данного образа
#используется для создания образа
#опциональный параметр
#тип - массив строк
#drivers = ["KVM_X86"]
#поддержка hot resize
#используется для создания образа
#опциональный параметр
#тип - булев
#hot_resize = true
#флаг загрузочного образа
#используется для создания образа
#опциональный параметр
#по умолчанию - true
#тип - булев
#bootable = true
#флаг для создания образа в асинхронном режиме
#опциональный параметр
#по умолчанию - false
#тип - булев
#async_mode = true
#флаг окончательного удаления
#опциональный параметр
#тип - булев
#permanently = true
}
```
После успешного завершения такого вызова **dynamix_image_from_platform_disk** в переменной `dynamix_image_from_platform_disk.img` будут сохранены возвращаемые значения.