Create extnet_list page
48
06.24-Data-функция-decort_extnet_list-получение-информации-о-всех-доступных-внешних-сетях.md
Normal file
48
06.24-Data-функция-decort_extnet_list-получение-информации-о-всех-доступных-внешних-сетях.md
Normal file
@@ -0,0 +1,48 @@
|
|||||||
|
Функция доступна в провайдере версии 2.3 и выше.
|
||||||
|
|
||||||
|
_Data source_ функция **decort_extnet_list** служит для получения информации об имеющихся доступных внешних сетях.
|
||||||
|
|
||||||
|
## Аргументы
|
||||||
|
_Data source_ функция **decort_extnet_list** принимает следующие аргументы:
|
||||||
|
| Аргумент | Тип | Обязательный | Описание |
|
||||||
|
| --- | --- | --- | --- |
|
||||||
|
| account_id | int | :x: | ID аккаунта для фильтрации результата поиска |
|
||||||
|
| page | int | :x: | Номер страниц |
|
||||||
|
| size | int | :x: | Размер страницы |
|
||||||
|
|
||||||
|
|
||||||
|
## Возвращаемые значения
|
||||||
|
В случае успешного выполнения _data source_ функция **decort_extnet_list** возвращает в указанную при вызове переменную, в поле _items_ массив, каждый элемент которого состоит из следующих параметров:
|
||||||
|
|
||||||
|
| Параметр | Тип | Описание |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| net_id | int | ID сети |
|
||||||
|
| ipcidr | string | Маска сети |
|
||||||
|
| name | string | Название сети |
|
||||||
|
|
||||||
|
## Пример использования
|
||||||
|
Пример вызова _data source_ функции **decort_extnet_list**:
|
||||||
|
```terraform
|
||||||
|
data "decort_extnet_list" "el" {
|
||||||
|
#id аккаунта для фильтрации результата
|
||||||
|
#необязательный параметр
|
||||||
|
#тип - число
|
||||||
|
#account_id = 1111111
|
||||||
|
|
||||||
|
#кол-во страниц для вывода
|
||||||
|
#опицональный параметр
|
||||||
|
#тип - число
|
||||||
|
#page = 1
|
||||||
|
|
||||||
|
#размер страницы
|
||||||
|
#опицональный параметр
|
||||||
|
#тип - число
|
||||||
|
#size = 1
|
||||||
|
}
|
||||||
|
# once the above directive completes, extnet list will be accessible
|
||||||
|
# as data.decort_extnet_list.el.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_extnet_list** в переменной `data.decort_extnet_list.el` будут сохранены возвращаемые значения.
|
||||||
Reference in New Issue
Block a user