Create resource decort_cdrom_image, add a description

07.10-Resource-функция-decort_cdrom_image:-управление-cdrom-образом..md

@@ -0,0 +1,102 @@
+**Внимание:** необходимы права администратора.
+
+_Resource_ функция **decort_cdrom_image** служит для управления cdrom - образом.
+
+## Аргументы
+_Resource_ функция **decort_cdrom_image** для создания cdrom - образа принимает следующие аргументы:
+
+| Аргумент | Тип | Описание |
+| --- | --- | --- |
+| name | string | Обязательный параметр, имя образа<br/>При изменении - изменяет название образа|  
+| url | string | Обязательный параметр, адрес образа |
+| gid | int | Обязательный параметр, grid id образа |
+| drivers | []string | Обязательный параметр, драйвера,<br/>возможные варианты - ["KVM_X86", "SVA_KVM_X86"], ["KVM_X86"], ["SVA_KVM_X86"] |
+| account_id | int | Опциональный параметр,<br/>id аккаунта владельца образа,<br/>может быть использован как при создании, так и редактировании образа |
+| username | string | Опциональный параметр, имя пользователя,<br/>может быть использован как при создании, так и редактировании образа |
+| password | string | Опциональный параметр, пароль пользователя,<br/>может быть использован как при создании, так и редактировании образа |
+| username_dl | string | Опциональный параметр,<br/>имя пользователя для загрузки бинарных данных,<br/>может быть использован как при создании, так и редактировании образа |
+| password_dl | string | Опциональный параметр,<br/>пароль пользователя для загрузки бинарных данных,<br/>может быть использован как при создании, так и редактировании образа |
+| sep_id | int | Опциональный параметр, id storage endpoint |
+| pool_name | string | Опциональный параметр, пул для создания образа |
+| architecture | string | Опциональный параметр, используется при создании, <br/>архитектура системы образа<br/>доступные значения: "X86_64"<br/>по-умолчанию "X86_64" |
+| enabled | bool | Опциональный параметр,<br/>доступность образа,<br/>используется при редактировании ресурса |
+| shared_with | []int | Опциональный параметр,<br/>настройка доступа образа аккаунтам<br/>используется на уже созданном ресурсе,<br/>пустой маасив - удаление всех доступов, если они были |
+| computeci_id | int | Опциональный параметр,<br/>установка computeci,<br/>используется на уже созданном ресурсе,<br/>чтобы сбросить, необходимо передать 0 |
+| enabled_stacks | []string | Опциональный параметр,<br/>доступные стаки,<br/>используется на уже созданном ресурсе<br/>для удаления всех доступных стаков, необходимо передать пустой массив |
+| permanently | bool | Опциональный параметр,<br/>мгновенное удаление<br/>можно использовать перед удалением |
+
+## Возвращаемые значения
+В случае успешного выполнения _resource_ функция **decort_image** возвращает в указанную при вызове переменную следующие значения:
+
+| Параметр | Тип | Описание |
+| --- | --- | --- |
+| account_id | int | accountId привязки образа |
+| architecture | string | архитектура образа, возможен вариант X86_64 или PPC64_LE |
+| 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 | описание скоро будет |
+| 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_cdrom_image**:
+```terraform
+resource "decort_cdrom_image" "my_image" {
+  name = "test_image_rename"
+  url = "https://colba.decs.online/index.php/s/G3H7AREngzeKGw2/download"
+  gid = 212
+  drivers = ["KVM_X86", "SVA_KVM_X86"]
+  #account_id = 57252
+
+  #username = "Valera"
+  #password = "123"
+  #username_dl = "Valera1"
+  #password_dl = "1231"
+  #sep_id = 1206
+  #pool_name = "vmstor"
+  #architecture = "X86_64"
+  #enabled = true
+  #shared_with = [28096, 57121]
+  #computeci_id = 1
+  #enabled_stacks = ["9"]
+  #permanently = true
+
+}
+
+# once the above directive completes,  will be accessible 
+# as decort_cdrom_image.my_image
+```
+
+Данный пример подразумевает, что ранее по тексту tf-файла выполнена корректная инициализация провайдера (подробнее об инициализации Terraform провайдера DECORT см. соответствующий [раздел](https://github.com/rudecs/terraform-provider-decort/wiki/05.-%D0%98%D0%BD%D0%B8%D1%86%D0%B8%D0%B0%D0%BB%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F-Terraform-%D0%BF%D1%80%D0%BE%D0%B2%D0%B0%D0%B9%D0%B4%D0%B5%D1%80%D0%B0-DECORT.)). 
+
+После успешного завершения такого вызова **decort_cdrom_image** в переменной `decort_cdrom_image.my_image` будут сохранены возвращаемые значения.