|
|
|
|
@ -1,91 +0,0 @@
|
|
|
|
|
Функция доступна в провайдере версии 2.0 и выше.
|
|
|
|
|
|
|
|
|
|
**Внимание:** необходимы права администратора.
|
|
|
|
|
|
|
|
|
|
_Resource_ функция **decort_virtual_image** служит для управления виртуальным образом. Виртуальный образа создаются на основе уже созданных ранее образов, таким образом, они привязываются к уже созданным образам. Образ, на основе которого создан виртуальный диск, удалить невозможно - для этого необходимо удалить виртуальный образ, либо связать его с другим образом.
|
|
|
|
|
|
|
|
|
|
## Аргументы
|
|
|
|
|
_Resource_ функция **decort_virtual_image** для создания виртуального образа принимает следующие аргументы:
|
|
|
|
|
|
|
|
|
|
| Аргумент | Тип | Обязательный | Описание |
|
|
|
|
|
| --- | --- | --- | --- |
|
|
|
|
|
| name | string | :heavy_check_mark: | Имя виртуального образа |
|
|
|
|
|
| target_id | int | :heavy_check_mark: | ID образа, на основе котрого будет создан виртуальный |
|
|
|
|
|
| link_to | int | :x: | Используется при редактировании ресурса<br/>изменение связи виртуального образа |
|
|
|
|
|
| account_id | int | :x: | ID аккаунта владельца образа<br/>может быть использован при редактировании образа|
|
|
|
|
|
| username | string | :x: | Имя пользователя,<br/>может быть использован при редактировании образа |
|
|
|
|
|
| password | string | :x: | Пароль пользователя,<br/>может быть использован при редактировании образа |
|
|
|
|
|
| enabled | bool | :x: | Доступность образа,<br/>используется при редактировании ресурса |
|
|
|
|
|
| shared_with | []int | :x: | Настройка доступа образа аккаунтам<br/>используется на уже созданном ресурсе,<br/>пустой маасив - удаление всех доступов, если они были |
|
|
|
|
|
| computeci_id | int | :x: | Установка computeci,<br/>используется на уже созданном ресурсе,<br/>чтобы сбросить, необходимо передать 0 |
|
|
|
|
|
| enabled_stacks | []string | :x: | Доступные стаки,<br/>используется на уже созданном ресурсе<br/>для удаления всех доступных стаков, необходимо передать пустой массив |
|
|
|
|
|
| permanently | bool | :x: | Мгновенное удаление<br/>можно использовать перед удалением |
|
|
|
|
|
| reason | string | :x: | Причина удаления<br/>можно использовать перед удалением |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Возвращаемые значения
|
|
|
|
|
В случае успешного выполнения _resource_ функция **decort_virtual_image** возвращает в указанную при вызове переменную следующие значения:
|
|
|
|
|
|
|
|
|
|
| Параметр | Тип | Описание |
|
|
|
|
|
| --- | --- | --- |
|
|
|
|
|
| account_id | int | accountId привязки образа |
|
|
|
|
|
| architecture | string | Архитектура образа, возможен вариант X86_64 или PPC64_LE |
|
|
|
|
|
| computeci_id | int | ID вычислительного ресурса |
|
|
|
|
|
| desc | string | Описание образа |
|
|
|
|
|
| drivers | []string | Cписок используемых драйверов |
|
|
|
|
|
| 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 | Пароль для образа |
|
|
|
|
|
| permanently | bool | Удаление образа: мгновенное или нет |
|
|
|
|
|
| pool_name | string | Пул, в котором был создан образ |
|
|
|
|
|
| provider_name | string | Наименование провайдера |
|
|
|
|
|
| purge_attempts | int | Попытки |
|
|
|
|
|
| reference_id | string | ID ссылки |
|
|
|
|
|
| res_id | string | ID ресурса |
|
|
|
|
|
| res_name | string | Наименование ресурса |
|
|
|
|
|
| sep_id | int | storage endpoint provider ID |
|
|
|
|
|
| size | int | Размер образа |
|
|
|
|
|
| status | string | Статус образа |
|
|
|
|
|
| tech_status | string | Технический статус |
|
|
|
|
|
| unc_path | string | unc path |
|
|
|
|
|
| url | string | Адрес, которого осуществлялась загрузка образа |
|
|
|
|
|
| username | string | Имя пользователя образа |
|
|
|
|
|
| version | string | Версия |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Пример использования
|
|
|
|
|
Пример вызова _resource_ функции **decort_virtual_image**:
|
|
|
|
|
```terraform
|
|
|
|
|
resource "decort_virtual_image" "my_image" {
|
|
|
|
|
name = "test_vi_im_new_rename"
|
|
|
|
|
target_id = 2222
|
|
|
|
|
|
|
|
|
|
#link_to = 3333
|
|
|
|
|
#account_id = 78765
|
|
|
|
|
#username = "Valera"
|
|
|
|
|
#password = "123"
|
|
|
|
|
#enabled = false
|
|
|
|
|
#shared_with = [111222, 222333]
|
|
|
|
|
#computeci_id = 1
|
|
|
|
|
#enabled_stacks = ["9"]
|
|
|
|
|
#permanently = true
|
|
|
|
|
#reason = "test"
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
# once the above directive completes, will be accessible
|
|
|
|
|
# as decort_virtual_image.my_image
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Данный пример подразумевает, что ранее по тексту tf-файла выполнена корректная инициализация провайдера (подробнее об инициализации Terraform провайдера DECORT см. соответствующий [раздел](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/04.02-Инициализация-Terraform-провайдера-DECORT)).
|
|
|
|
|
|
|
|
|
|
После успешного завершения такого вызова **decort_virtual_image** в переменной `decort_virtual_image.my_image` будут сохранены возвращаемые значения.
|
