From 4c1e980515ba746bc3fe3421f7d661e599a2ab91 Mon Sep 17 00:00:00 2001 From: loskutovanl Date: Fri, 24 Nov 2023 14:39:42 +0300 Subject: [PATCH] update image data sources --- ...нформации-об-образах.md | 111 +++++++++++++++++ ...нформации-об-образах.md | 77 ------------ ...-информации-об-образе.md | 86 +++++++++++++ ...-информации-об-образе.md | 73 ----------- ...тупных-для-образа-stacks.md | 116 ++++++++++++++++++ ...тупных-для-образа-stacks.md | 49 -------- Home.md | 6 +- 7 files changed, 316 insertions(+), 202 deletions(-) create mode 100644 06.02.06-Data-функция-decort_cb_image_list-получение-информации-об-образах.md delete mode 100644 06.02.06-Data-функция-decort_image_list-получение-информации-об-образах.md create mode 100644 06.02.07-Data-функция-decort_cb_image-получение-информации-об-образе.md delete mode 100644 06.02.07-Data-функция-decort_image-получение-информации-об-образе.md create mode 100644 06.02.08-Data-функция-decort_cb_image_list_stacks-получение-информации-о-доступных-для-образа-stacks.md delete mode 100644 06.02.08-Data-функция-decort_image_list_stacks-получение-информации-о-доступных-для-образа-stacks.md diff --git a/06.02.06-Data-функция-decort_cb_image_list-получение-информации-об-образах.md b/06.02.06-Data-функция-decort_cb_image_list-получение-информации-об-образах.md new file mode 100644 index 0000000..13654dd --- /dev/null +++ b/06.02.06-Data-функция-decort_cb_image_list-получение-информации-об-образах.md @@ -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` будут сохранены возвращаемые значения. diff --git a/06.02.06-Data-функция-decort_image_list-получение-информации-об-образах.md b/06.02.06-Data-функция-decort_image_list-получение-информации-об-образах.md deleted file mode 100644 index e4c2c86..0000000 --- a/06.02.06-Data-функция-decort_image_list-получение-информации-об-образах.md +++ /dev/null @@ -1,77 +0,0 @@ -Функция доступна в провайдере версии 3.0 и выше. - -_Data source_ функция **decort_image_list** служит для получения информации об имеющихся в облачной платформе образах. Образы это дисковые ресурсы, уже содержащие некоторые данные, для которых реализован механизм быстрого клонирования/копирования в новый диск. - -Основной сценарий использования таких ресурсов это создание каталогов образов операционных систем (ОС), на базе которых создаются загрузочные диски для _compute_. Также с их помощью можно хранить эталонную информацию, требующуюся для работы приложений, например, файлы баз данных. - -Образ ОС является основной для создания новых виртуальных серверов, так как из него формируется загрузочный диск сервера. Как следствие, для создания виртуального сервера помимо других параметров требуется указать идентификатор нужного образа ОС. Для получения всех доступных идентификаторов можно воспользоваться _data source_ функцией **decort_image_list**. - -## Аргументы -_Data source_ функция **decort_image_list** принимает следующие аргументы: - -| Аргумент | Тип | Обязательный | Описание | -| --- | --- | --- | --- | -| page | int | :x: | Номер страниц | -| size | int | :x: | Размер страницы | -| sep_id | int | :x: | Фильтр результата по storage endpoint provider ID | -| shared_with | int | :x: |Фильтр результата по доступности образа различным аккаунтам | - -## Возвращаемые значения -В случае успешного выполнения _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_ функции **decort_image_list**: -```terraform -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://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_image_list** в переменной `data.decort_image_list.il` будут сохранены возвращаемые значения. diff --git a/06.02.07-Data-функция-decort_cb_image-получение-информации-об-образе.md b/06.02.07-Data-функция-decort_cb_image-получение-информации-об-образе.md new file mode 100644 index 0000000..f5c6c93 --- /dev/null +++ b/06.02.07-Data-функция-decort_cb_image-получение-информации-об-образе.md @@ -0,0 +1,86 @@ +Функция доступна в провайдере версии 3.0 и выше. + +_Data source_ функция **decort_cb_image** служит для получения информации об имеющихся в облачной платформе образах. Образы это дисковые ресурсы, уже содержащие некоторые данные ("golden image"), для которых реализован механизм быстрого клонирования/копирования в новый диск. + +Основной сценарий использования таких ресурсов это создание каталогов образов операционных систем (ОС), на базе которых создаются загрузочные диски для _compute_. Также с их помощью можно хранить эталонную информацию, требующуюся для работы приложений, например, файлы баз данных. + +Образ ОС является основной для создания новых виртуальных серверов, так как из него формируется загрузочный диск сервера. Как следствие, для создания виртуального сервера помимо других параметров требуется указать идентификатор нужного образа ОС. Для получения такого идентификатора можно воспользоваться _data source_ функцией **decort_cb_image**. + +## Аргументы +_Data source_ функция **decort_cb_image** принимает следующие аргументы: + +| Аргумент | Тип | Обязательный | Описание | +| --- | --- | --- | --- | +| image_id | int | :heavy_check_mark: | ID образа, информацию по которому требуется получить. | + +ID необходимого образа можно взять вызвав [decort_cb_image_list](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/06.02.06-Data-функция-decort_cb_image_list-получение-информации-об-образах) + +## Возвращаемые значения +В случае успешного выполнения _data source_ функция **decort_cb_image** возвращает в указанную при вызове переменную следующие значения: + +| Параметр | Тип | Описание | +| --- |-----------------------------------------------|----------------------------------------------------------| +| 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 | Версия | + +### Описание структуры acl +| Параметр | Тип | Описание | +| --- | --- | --- | +| explicit | bool | Явно ли указан доступ | +| guid | string | guid Ресурса | +| right | string | Права на ресурс | +| status | string | Статус ресурса | +| type | string | Тип ресурса | +| user_group_id | string | ID user group | + +## Пример использования +Пример вызова _data source_ функции **decort_cb_image**: +```terraform +data "decort_cb_image" "my_img" { + image_id = 1234 +} +# once the above directive completes, image name will be accessible +# as data.decort_cb_image.my_img.name +``` + +Данный пример подразумевает, что ранее по тексту 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** в переменной `data.decort_cb_image.my_img` будут сохранены возвращаемые значения. В частности, для получения идентификатора образа следует использовать конструкцию `data.decort_cb_image.my_img.name` diff --git a/06.02.07-Data-функция-decort_image-получение-информации-об-образе.md b/06.02.07-Data-функция-decort_image-получение-информации-об-образе.md deleted file mode 100644 index 962d15c..0000000 --- a/06.02.07-Data-функция-decort_image-получение-информации-об-образе.md +++ /dev/null @@ -1,73 +0,0 @@ -Функция доступна в провайдере версии 3.0 и выше. - -_Data source_ функция **decort_image** служит для получения информации об имеющихся в облачной платформе образах. Образы это дисковые ресурсы, уже содержащие некоторые данные ("golden image"), для которых реализован механизм быстрого клонирования/копирования в новый диск. - -Основной сценарий использования таких ресурсов это создание каталогов образов операционных систем (ОС), на базе которых создаются загрузочные диски для _compute_. Также с их помощью можно хранить эталонную информацию, требующуюся для работы приложений, например, файлы баз данных. - -Образ ОС является основной для создания новых виртуальных серверов, так как из него формируется загрузочный диск сервера. Как следствие, для создания виртуального сервера помимо других параметров требуется указать идентификатор нужного образа ОС. Для получения такого идентификатора можно воспользоваться _data source_ функцией **decort_image**. - -## Аргументы -_Data source_ функция **decort_image** принимает следующие аргументы: - -| Аргумент | Тип | Обязательный | Описание | -| --- | --- | --- | --- | -| image_id | int | :heavy_check_mark: | ID образа, информацию по которому требуется получить. | - -ID необходимо образа можно взять вызвав [decort_image_list](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/06.6-Data-функция-decort_image_list:-получение-информации-об-образах) - -## Возвращаемые значения -В случае успешного выполнения _data source_ функция **decort_image** возвращает в указанную при вызове переменную следующие значения: - -| Параметр | Тип | Описание | -| --- | --- | --- | -| 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_ функции **decort_image**: -```terraform -data "decort_image" "my_img" { - image_id = 1234 -} -# once the above directive completes, image ID will be accessible -# as data.decort_image.my_img.id -``` - -Данный пример подразумевает, что ранее по тексту 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_image** в переменной `data.decort_image.my_img` будут сохранены возвращаемые значения. В частности, для получения идентификатора образа следует использовать конструкцию `data.decort_image.my_img.id` diff --git a/06.02.08-Data-функция-decort_cb_image_list_stacks-получение-информации-о-доступных-для-образа-stacks.md b/06.02.08-Data-функция-decort_cb_image_list_stacks-получение-информации-о-доступных-для-образа-stacks.md new file mode 100644 index 0000000..51b7017 --- /dev/null +++ b/06.02.08-Data-функция-decort_cb_image_list_stacks-получение-информации-о-доступных-для-образа-stacks.md @@ -0,0 +1,116 @@ +Функция доступна в провайдере версии 3.0 и выше. + +_Data source_ функция **decort_cb_image_list_stacks** служит для получения информации об имеющихся в облачной платформе доступных образу stacks. Образы это дисковые ресурсы, уже содержащие некоторые данные, для которых реализован механизм быстрого клонирования/копирования в новый диск. Stacks - единица платформы, в которой хранятся в том числе и образы. Из других stacks к образу доступа нет. + +## Аргументы +_Data source_ функция **decort_cb_image_list_stacks** принимает следующие аргументы: + +| Аргумент | Тип | Обязательный | Описание | +| --- | --- | --- |---------------------------| +| image_id | int | :heavy_check_mark: | ID образа | +| name | string | :x: | Фильтр по названию образа | +| status | string | :x: | Фильтр по статусу образа | +| type | string | :x: | Фильтр по типу образа | +| page | int | :x: | Номер страницы | +| size | int | :x: | Размер страницы | + +## Возвращаемые значения +В случае успешного выполнения _data source_ функция **decort_cb_image_list_stacks** возвращает в указанную при вызове переменную, в поле _items_, массив, каждый элемент которого состоит из следующих параметров: + +| Параметр | Тип | Описание | +|----------------|---------------------------------------------------|------------------------------------------| +| ckey | string | CKey | +| meta | []string | Мета информация о stack | +| api_url | string | Адрес api | +| api_key | string | Ключ api | +| app_id | string | ID приложения | +| cpu_allocation_ratio | float | Отношение выделения CPU | +| desc | string | Описание | +| descr | string | Описание | +| drivers | []string | Список используемых драйверов | +| eco | string | Системные ошибки | +| error | int | Ошибка | +| gid | int | Идентификатор площадки (grid id) | +| guid | int | ID ресурса | +| id | int | ID вычислительного узла (stack) | +| images | []int | Список доступных образов на stack | +| login | string | Логин | +| mem_allocation_ratio | float | Коэффициент выделения оперативной памяти | +| name | string | Наименование stack | +| packages | []Struct [см. ниже](#описание-структуры-packages) | Информация о пакетах | +| passwd | string | Пароль | +| reference_id | string | ID ссылки | +| status | string | Статус stack | +| type | string | Тип stack | + +### Описание структуры packages +| Параметр | Тип | Описание | +|--------------------|-------------------------------------------------------------|----------------------------------------| +| libvirt_bin | []Struct [см. ниже](#описание-структуры-libvirt_bin) | Информация о пакете libvirt_bin | +| libvirt_daemon | []Struct [см. ниже](#описание-структуры-libvirt_daemon) | Информация о пакете libvirt_daemon | +| lvm2_lockd | []Struct [см. ниже](#описание-структуры-lvm2_lockd) | Информация о пакете lvm2_lockd | +| openvswitch_common | []Struct [см. ниже](#описание-структуры-openvswitch_common) | Информация о пакете openvswitch_common | +| openvswitch_switch | []Struct [см. ниже](#описание-структуры-openvswitch_switch) | Информация о пакете openvswitch_switch | +| qemu_system_x86 | []Struct [см. ниже](#описание-структуры-qemu_system_x86) | Информация о пакете qemu_system_x86 | +| sanlock | []Struct [см. ниже](#описание-структуры-sanlock) | Информация о пакете sanlock | + +### Описание структуры libvirt_bin +| Параметр | Тип | Описание | +|----------------|--------|----------| +| installed_size | string | Размер | +| ver | string | Версия | + +### Описание структуры libvirt_daemon +| Параметр | Тип | Описание | +|----------------|--------|----------| +| installed_size | string | Размер | +| ver | string | Версия | + +### Описание структуры lvm2_lockd +| Параметр | Тип | Описание | +|----------------|--------|----------| +| installed_size | string | Размер | +| ver | string | Версия | + +### Описание структуры openvswitch_common +| Параметр | Тип | Описание | +|----------------|--------|----------| +| installed_size | string | Размер | +| ver | string | Версия | + +### Описание структуры openvswitch_switch +| Параметр | Тип | Описание | +|----------------|--------|----------| +| installed_size | string | Размер | +| ver | string | Версия | + +### Описание структуры qemu_system_x86 +| Параметр | Тип | Описание | +|----------------|--------|----------| +| installed_size | string | Размер | +| ver | string | Версия | + +### Описание структуры sanlock +| Параметр | Тип | Описание | +|----------------|--------|----------| +| installed_size | string | Размер | +| ver | string | Версия | + +## Пример использования +Пример вызова _data source_ функции **decort_cb_image_list_stacks**: +```terraform +data "decort_cb_image_list_stacks" "ils" { + image_id = 6040 + #name = "test" + #status = "ENABLED" + #type_image = "cdrom" + #page = 2 + #size = 3 +} +# once the above directive completes, image stacks will be accessible +# as data.decort_cb_image_list_stacks.ils.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_stacks** в переменной `data.decort_cb_image_list_stacks.ils.items` будут сохранены возвращаемые значения. diff --git a/06.02.08-Data-функция-decort_image_list_stacks-получение-информации-о-доступных-для-образа-stacks.md b/06.02.08-Data-функция-decort_image_list_stacks-получение-информации-о-доступных-для-образа-stacks.md deleted file mode 100644 index 9efd6b3..0000000 --- a/06.02.08-Data-функция-decort_image_list_stacks-получение-информации-о-доступных-для-образа-stacks.md +++ /dev/null @@ -1,49 +0,0 @@ -Функция доступна в провайдере версии 3.0 и выше. - -_Data source_ функция **decort_image_list_stacks** служит для получения информации об имеющихся в облачной платформе доступных образу stacks. Образы это дисковые ресурсы, уже содержащие некоторые данные, для которых реализован механизм быстрого клонирования/копирования в новый диск. Stacks - единица платформы, в которой хранятся в том числе и образы. Из других stacks к образу доступа нет. - -## Аргументы -_Data source_ функция **decort_image_list_stacks** принимает следующие аргументы: - -| Аргумент | Тип | Обязательный | Описание | -| --- | --- | --- | --- | -| image_id | int | :heavy_check_mark: | ID образа | -| page | int | :x: | Номер страницы | -| size | int | :x: | Размер страницы | - - -## Возвращаемые значения -В случае успешного выполнения _data source_ функция **decort_image_list_stacks** возвращает в указанную при вызове переменную, в поле _items_, массив, каждый элемент которого состоит из следующих параметров: -| Параметр | Тип | Описание | -| --- | --- | --- | -| api_key | string | Ключ api | -| api_url | string | Адрес api | -| app_id | string | ID приложения | -| desc | string | Описание | -| drivers | []string | Список драйверов | -| error | int | Номер ошибки | -| guid | int | Внутренний id | -| id | int | ID | -| images | []int | Список доступных образов на stack | -| login | string | Логин пользователя | -| name | string | Наименование stacks | -| passwd | string | Пароль | -| reference_id | string | ID ссылки | -| status | string | Статус | -| type | string | Тип | - -## Пример использования -Пример вызова _data source_ функции **decort_image_list_stacks**: -```terraform -data "decort_image_list_stacks" "ils" { - image_id = 1234 - #page = 2 - #size = 3 -} -# once the above directive completes, will be accessible -# as data.decort_image_list_stacks.ils.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_image_list_stacks** в переменной `data.decort_image_list_stacks.ils` будут сохранены возвращаемые значения. diff --git a/Home.md b/Home.md index d4c6d29..f6bd8ff 100644 --- a/Home.md +++ b/Home.md @@ -120,9 +120,9 @@ Terraform провайдер для платформы DECORT с API верси - [**decort_cb_disk**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/06.02.03-Data-функция-decort_cb_disk-получение-информации-о-диске) - получение информации о ресурсе хранения ("disk") - [**decort_cb_vins**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/06.02.04-Data-функция-decort_cb_vins-получение-информации-о-ViNS) - получение информации о виртуальном сетевом сегменте (Virtual Network Segment, "ViNS") - [**decort_account**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/06.02.05-Data-функция-decort_account-получение-информации-об-аккаунте) - получение информации об аккаунте - - [**decort_image_list**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/06.02.06-Data-функция-decort_image_list-получение-информации-об-образах) - получение информации об образах (_image_) - - [**decort_image**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/06.02.07-Data-функция-decort_image-получение-информации-об-образе) - получение информации об образе (_image_) - - [**decort_image_list_stacks**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/06.02.08-Data-функция-decort_image_list_stacks-получение-информации-о-доступных-для-образа-stacks) - получение информации о доступном stacks по id образа + - [**decort_cb_image_list**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/06.02.06-Data-функция-decort_cb_image_list-получение-информации-об-образах) - получение информации об образах (_image_) + - [**decort_cb_image**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/06.02.07-Data-функция-decort_cb_image-получение-информации-об-образе) - получение информации об образе (_image_) + - [**decort_cb_image_list_stacks**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/06.02.08-Data-функция-decort_cb_image_list_stacks-получение-информации-о-доступных-для-образа-stacks) - получение информации о доступном stacks по id образа - [**decort_cb_grid_list**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/06.02.09-Data-функция-decort_cb_grid_list-получение-списков-доступных-платформ) - получение списка с информацией о доступных платформах, _необходимы права администратора_ - [**decort_cb_grid**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/06.02.10-Data-функция-decort_cb_grid-получение-информации-о-grid) - получение информации о доступной платформе, _необходимы права администратора_ - [**decort_cb_pcidevice_list**](https://repository.basistech.ru/BASIS/terraform-provider-decort/wiki/06.02.11-Data-функция-decort_cb_pcidevice_list-получение-информации-о-всех-pcidevice) - получение информации о всех доступных pcidevice