Функция доступна в провайдере версии 2.3 и выше.

_Data source_ функция **decort_extnet_list** служит для получения информации об имеющихся доступных внешних сетях.

## Аргументы
_Data source_ функция **decort_extnet_list** принимает следующие аргументы:
| Аргумент | Тип | Обязательный | Описание |
| --- | --- | --- | --- | 
| by_id | int | :x: | Фильтр по extnet ID |
| name | string | :x: | Фильтр по имени extnet |
| network | string | :x: | Фильтр по сети |
| vlan_id | int | :x: | Фильтр по VLAN ID |
| vnfdev_id | int | :x: | Фильтр по VnfDEV ID |
| status | string | :x: | Фильтр по статусу |
| account_id | int | :x: | ID аккаунта для фильтрации результата поиска |
| sort_by | string | :x: | Фильтр по одному из поддерживаемых полей, формат: +или- название поля |
| page | int | :x: | Номер страниц |
| size | int | :x: | Размер страницы |
| ovs_bridge | string | :x: | Фильтр по OVS Bridge |
| zone_id | int | :x: | ID зоны |


## Возвращаемые значения
В случае успешного выполнения _data source_ функция **decort_extnet_list** возвращает в указанную при вызове переменную, в поле _items_ массив, каждый элемент которого состоит из следующих параметров:

| Параметр | Тип | Описание |
| --- | --- | --- |
| net_id | int | ID сети |
| ipcidr | string | Маска сети |
| name | string | Название сети |
| status | string | Статус сети |

## Пример использования
Пример вызова _data source_ функции **decort_extnet_list**:
```terraform
data "decort_extnet_list" "el" {
  #id аккаунта для фильтрации результата
  #опциональный параметр
  #тип - целое число
  #account_id = 1111111

  #фильтр по id внешней сети
  #опциональный параметр
  #тип - целое число
  #by_id = 100

  #фильтр по имени внешней сети
  #опциональный параметр
  #тип - строка
  #name = "test"

  #фильтр по IP внешней сети
  #опциональный параметр
  #тип - строка
  #network = "test"

  #фильтр по id vlan
  #опциональный параметр
  #тип - целое число
  #vlan_id = 100

  #фильтр по id vnfDevices
  #опциональный параметр
  #тип - целое число
  #vnfdev_id = 100

  #фильтр по статусу
  #опциональный параметр
  #тип - строка
  #status = "ENABLED"

  #сортировка по одному из поддерживаемых полей
  #опциональный параметр
  #тип - строка
  #формат - "+поле" по возрастанию / "-поле" по убыванию
  #sort_by = "+name"

  #номер страницы для отображения
  #опциональный параметр
  #тип - целое число
  #page = 1

  #размер страницы
  #опциональный параметр
  #тип - целое число
  #size = 1

  #имя моста openVswitch  
  #опциональный параметр
  #тип - строка   
  #ovs_bridge = "key"

  #id зоны 
  #опциональный параметр 
  #тип - целое число 
  #значение по умолчанию - 0 
  #zone_id = 11  
}
```

Данный пример подразумевает, что ранее по тексту tf-файла выполнена корректная инициализация провайдера (подробнее об инициализации Terraform провайдера DECORT см. соответствующий [раздел](https://repository.basistech.ru/BASIS/wiki-terraform-provider-decort/src/branch/main/4.10.5/04.02-Инициализация-Terraform-провайдера-DECORT.md)). 

После успешного завершения такого вызова **decort_extnet_list** в переменной `data.decort_extnet_list.el` будут сохранены возвращаемые значения.
