Create data source decort_sep_list page

stSolo
2022-05-04 14:02:44 +03:00
parent 5107a64ad2
commit 5383b0de64

@@ -0,0 +1,51 @@
Функция доступна в провайдере версии 2.2 и выше.
**Внимание:** необходимы права администратора.
_Data source_ функция **decort_sep_list** служит для получения информации обо всех доступных пользователю storage endpoints. Storage endpoint (sep) - точка доступа к хранилищу данных. Sep бывает четырех типов:
- des
- hitachi
- dorado (huawei)
- tatlin
Каждый тип отличается возможной конфигурацией.
## Аргументы
_Data source_ функция **decort_sep_list** принимает следующие аргументы:
| Аргумент | Тип | Обязательный | Описание |
| --- | --- | --- | --- |
| page | int | :x: | Номер страницы для вывода |
| size | int | :x: | Размер страницы для вывода |
## Возвращаемые значения
В случае успешного выполнения _data source_ функция **decort_sep_list** возвращает в указанную при вызове переменную, в поле _items_, массив, каждый элемент которого состоит из следующих параметров:
| Параметр | Тип | Описание |
| --- | --- | --- |
| sep_id | int | id storage endpoint |
| meta | []string | Мета информация о sep |
| consumed_by | []int | Список node id, использующих sep |
| desc | string | Описание sep |
| gid | int | Grid id, к которому привязан sep |
| guid | int | Внутренний id sep |
| milestones | int | Вехи |
| name | string | Наименование sep |
| obj_status | string | Статус sep |
| provided_by | []int | Список provider id, использующих sep |
| tech_status | string | Технический статус sep |
| type | string | Тип sep |
| config | json string | конфигурация sep |
## Пример использования
Пример вызова _data source_ функции **decort_snapshot_list**:
```terraform
data "decort_sep_list" "sl" {
}
# once the above directive completes, sep will be accessible
# as data.decort_sep_list.sl.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_sep_list** в переменной `data.decort_sep_list.sl.items` будут сохранены возвращаемые значения.