|
|
|
@ -0,0 +1,111 @@
|
|
|
|
|
|
|
|
Функция доступна в провайдере версии 3.0 и выше.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
_Data source_ функция **decort_cb_image_list** служит для получения информации об имеющихся в облачной платформе образах. Образы это дисковые ресурсы, уже содержащие некоторые данные, для которых реализован механизм быстрого клонирования/копирования в новый диск.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Основной сценарий использования таких ресурсов это создание каталогов образов операционных систем (ОС), на базе которых создаются загрузочные диски для _compute_. Также с их помощью можно хранить эталонную информацию, требующуюся для работы приложений, например, файлы баз данных.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Образ ОС является основной для создания новых виртуальных серверов, так как из него формируется загрузочный диск сервера. Как следствие, для создания виртуального сервера помимо других параметров требуется указать идентификатор нужного образа ОС. Для получения всех доступных идентификаторов можно воспользоваться _data source_ функцией **decort_cb_image_list**.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Аргументы
|
|
|
|
|
|
|
|
_Data source_ функция **decort_cb_image_list** принимает следующие аргументы:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| Аргумент | Тип | Обязательный | Описание |
|
|
|
|
|
|
|
|
| --- |--------| --- |-------------------------------------------------------------|
|
|
|
|
|
|
|
|
| sep_id | int | :x: | Фильтр результата по storage endpoint provider ID |
|
|
|
|
|
|
|
|
| by_id | int | :x: | Фильтр по ID образа |
|
|
|
|
|
|
|
|
| name | string | :x: | Фильтр по названию образа |
|
|
|
|
|
|
|
|
| status | string | :x: | Фильтр по статусу образа|
|
|
|
|
|
|
|
|
| architecture | string | :x: | Фильтр по архитектуре |
|
|
|
|
|
|
|
|
| type_image | string | :x: | Фильтр по типу образа|
|
|
|
|
|
|
|
|
| image_size | int | :x: | Фильтр по размеру образа |
|
|
|
|
|
|
|
|
| sep_name | string | :x: | Фильтр по имени SEP |
|
|
|
|
|
|
|
|
| pool | string | :x: | Фильтр по Pool |
|
|
|
|
|
|
|
|
| public | bool | :x: | Фильтр публичных/приватных образов |
|
|
|
|
|
|
|
|
| hot_resize | bool | :x: | Фильтр образов, разрешающих hot resize |
|
|
|
|
|
|
|
|
| bootable | bool | :x: | Фильтр загрузочных образов |
|
|
|
|
|
|
|
|
| page | int | :x: | Номер страниц |
|
|
|
|
|
|
|
|
| size | int | :x: | Размер страницы |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Возвращаемые значения
|
|
|
|
|
|
|
|
В случае успешного выполнения _data source_ функция **decort_cb_image_list** возвращает в указанную при вызове переменную, в поле _items_, массив, каждый элемент которого состоит из следующих параметров:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| Параметр | Тип | Описание |
|
|
|
|
|
|
|
|
| --- |-----------------------------------------------|----------------------------------------------------------|
|
|
|
|
|
|
|
|
| ckey | string | CKey |
|
|
|
|
|
|
|
|
| meta | []string | Мета информация об образе |
|
|
|
|
|
|
|
|
| account_id | int | accountId привязки образа |
|
|
|
|
|
|
|
|
| acl | []Struct [см. ниже](#описание-структуры-acl) | Cписок Acces Control |
|
|
|
|
|
|
|
|
| architecture | string | Архитектура образа, возможен вариант X86_64 или PPC64_LE |
|
|
|
|
|
|
|
|
| boot_type | string | Тип запуска ОС - bios или uefi |
|
|
|
|
|
|
|
|
| bootable | bool | Является ли образ загрузочным |
|
|
|
|
|
|
|
|
| computeci_id | int | ID вычислительного ресурса |
|
|
|
|
|
|
|
|
| deleted_time | int | Время удаления |
|
|
|
|
|
|
|
|
| desc | string | Описание образа |
|
|
|
|
|
|
|
|
| drivers | []string | Список используемых драйверов |
|
|
|
|
|
|
|
|
| enabled | bool | Доступность образа |
|
|
|
|
|
|
|
|
| gid | int | ID платформы, где образ будет создан |
|
|
|
|
|
|
|
|
| guid | int | Внутренний id образа, совпадает с image_id |
|
|
|
|
|
|
|
|
| history | object{id: int, guid: string, timestamp: int} | История обновлений образа |
|
|
|
|
|
|
|
|
| hot_resize | bool | Использует ли машина горячее изменение размера образа |
|
|
|
|
|
|
|
|
| image_id | int | ID образа |
|
|
|
|
|
|
|
|
| last_modified | int | Дата последнего изменения |
|
|
|
|
|
|
|
|
| link_to | int | Привязка к образу, используется в виртуальных образах |
|
|
|
|
|
|
|
|
| milestones | int | Вехи |
|
|
|
|
|
|
|
|
| name | string | Название образа |
|
|
|
|
|
|
|
|
| password | string | Пароль для образа |
|
|
|
|
|
|
|
|
| pool_name | string | Пул, в котором был создан образ |
|
|
|
|
|
|
|
|
| present_to | []int | Список ID ресурсов для который предоставлен образ |
|
|
|
|
|
|
|
|
| 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 |
|
|
|
|
|
|
|
|
| shared_with | []int | Список ресурсов, имеющих доступ к образу |
|
|
|
|
|
|
|
|
| size | int | Размер образа |
|
|
|
|
|
|
|
|
| status | string | Статус образа |
|
|
|
|
|
|
|
|
| tech_status | string | Технический статус |
|
|
|
|
|
|
|
|
| image_type | string | Тип образа: linux, windows или другой |
|
|
|
|
|
|
|
|
| unc_path | string | unc path |
|
|
|
|
|
|
|
|
| url | string | Адрес, которого осуществлялась загрузка образа |
|
|
|
|
|
|
|
|
| username | string | Имя пользователя образа |
|
|
|
|
|
|
|
|
| version | string | Версия |
|
|
|
|
|
|
|
|
| virtual| bool | Флаг, является ли образ виртуальным |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Описание структуры acl
|
|
|
|
|
|
|
|
| Параметр | Тип | Описание |
|
|
|
|
|
|
|
|
| --- | --- | --- |
|
|
|
|
|
|
|
|
| explicit | bool | Явно ли указан доступ |
|
|
|
|
|
|
|
|
| guid | string | guid Ресурса |
|
|
|
|
|
|
|
|
| right | string | Права на ресурс |
|
|
|
|
|
|
|
|
| status | string | Статус ресурса |
|
|
|
|
|
|
|
|
| type | string | Тип ресурса |
|
|
|
|
|
|
|
|
| user_group_id | string | ID user group |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Пример использования
|
|
|
|
|
|
|
|
Пример вызова _data source_ функции **decort_cb_image_list**:
|
|
|
|
|
|
|
|
```terraform
|
|
|
|
|
|
|
|
data "decort_cb_image_list" "il" {
|
|
|
|
|
|
|
|
#sep_id = 1
|
|
|
|
|
|
|
|
#by_id = 100
|
|
|
|
|
|
|
|
#name = "test"
|
|
|
|
|
|
|
|
#status = "ENABLED"
|
|
|
|
|
|
|
|
#architecture = "x86_64"
|
|
|
|
|
|
|
|
#type_image = "cdrom"
|
|
|
|
|
|
|
|
#image_size = 100
|
|
|
|
|
|
|
|
#sep_name = "test"
|
|
|
|
|
|
|
|
#pool = "test"
|
|
|
|
|
|
|
|
#public = "true"
|
|
|
|
|
|
|
|
#hot_resize = "true"
|
|
|
|
|
|
|
|
#bootable = "true"
|
|
|
|
|
|
|
|
#page = 2
|
|
|
|
|
|
|
|
#size = 3
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
# once the above directive completes, images will be accessible
|
|
|
|
|
|
|
|
# as data.decort_cb_image_list.il.items
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Данный пример подразумевает, что ранее по тексту tf-файла выполнена корректная инициализация провайдера (подробнее об инициализации Terraform провайдера DECORT см. соответствующий [раздел](https://repository.basistech.ru/BASIS/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_cb_image_list** в переменной `data.decort_cb_image_list.il.items` будут сохранены возвращаемые значения.
|
