diff --git a/06.6-Data-функция-decort_image_list:-получение-информации-об-образах.md b/06.6-Data-функция-decort_image_list:-получение-информации-об-образах.md new file mode 100644 index 0000000..4554703 --- /dev/null +++ b/06.6-Data-функция-decort_image_list:-получение-информации-об-образах.md @@ -0,0 +1,75 @@ +_Data source_ функция **decort_image_list** служит для получения информации об имеющихся в облачной платформе образах. Образы это дисковые ресурсы, уже содержащие некоторые данные, для которых реализован механизм быстрого клонирования/копирования в новый диск. + +Основной сценарий использования таких ресурсов это создание каталогов образов операционных систем (ОС), на базе которых создаются загрузочные диски для _compute_. Также с их помощью можно хранить эталонную информацию, требующуюся для работы приложений, например, файлы баз данных. + +Образ ОС является основной для создания новых виртуальных серверов, так как из него формируется загрузочный диск сервера. Как следствие, для создания виртуального сервера помимо других параметров требуется указать идентификатор нужного образа ОС. Для получения такого идентификатора можно воспользоваться _data source_ функцией **decort_image**. + +## Аргументы +_Data source_ функция **decort_image_list** принимает следующие аргументы: + +| Аргумент | Тип | Описание | +| --- | --- | --- | +| page | int | опциональный параметр, номер страниц +| size | int | опциональный параметр, размер страницы +| sep_id | int | опциональный параметр, фильтр результата по storage endpoint provider ID +| shared_with | int | опциональный параметр, фильтр результата по доступности образа различным аккаунтам + +## Возвращаемые значения +В случае успешного выполнения _data source_ функция **decort_image_list** возвращает в указанную при вызове переменную, в поле _items_ массив, каждый элемент которого состоит из следующих параметров: + +| Параметр | Тип | Описание | +| --- | --- | --- | +| 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 | описание скоро будет +| 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 | версия + +## Пример использования +Пример вызова _data source_ функции **decs_image_list**: +``` +data "decort_image_list" "il" { + #page = 2 + #size = 3 + #sep_id = 123 + #shared_with = 123 +} +# once the above directive completes, images will be accessible +# as data.decort_image_list.il.items +``` + +Данный пример подразумевает, что ранее по тексту 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_image** в переменной `data.decort_image_list.il` будут сохранены возвращаемые значения. \ No newline at end of file diff --git a/06.7.md b/06.7.md deleted file mode 100644 index 4dc67b9..0000000 --- a/06.7.md +++ /dev/null @@ -1 +0,0 @@ -As \ No newline at end of file