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

_Data source_ функция **decort_cb_trunk_list** служит для получения информации о доступных транковых портах

## Аргументы

_Data source_ функция **decort_cb_trunk_list** принимает следующие аргументы:

| Аргумент | Тип | Обязательный | Описание |
| --- | --- | --- | --- |
| trunk_ids | []int | :x: | Фильтр по ID транковых портов |
| account_ids | []int | :x: | Фильтр по ID аккаунтов, имеющих доступ к транковому порту |
| trunk_tags | string | :x: | Фильтр по тэгам транковых портов |
| status | string | :x: | Фильтр по статусу |
| sort_by | string | :x: | Фильтр по значениям поля. Формат +/-(field) |
| page | int | :x: | Номер страницы для вывода |
| size | int | :x: | Размер страницы для вывода |


## Возвращаемые значения

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

| Параметр | Тип | Описание |
| --- | --- | --- |
| account_ids | []int | ID аккаунтов, имеющих доступ к транковому порту. |
| created_at | int | Когда создан транковый порт. |
| created_by | string | Кем создан транковый порт. |
| deleted_at | int | Когда удалён транковый порт. |
| deleted_by | string | Кем удалён транковый порт. |
| description | string | Текстовое описание транка. |
| guid | int | GUID. |
| id | string | Уникальный идентификатор транка. |
| mac | string | MAC адрес транка. |
| name | string | Название транка. |
| native_vlan_id | int | ID VLAN. |
| ovs_bridge | string | OVS Bridge |
| mtu | int | Максимальная единица передачи информации. |
| status | string | Статус доступности транка. |
| trunk_tags | string | Тэг транка. |
| updated_at | int | Когда обновлён транковый порт. |
| updated_by | string | Кем обновлён транковый порт. |


## Пример использования

Пример вызова _data source_ функции **decort_cb_trunk_list**:

```terraform
data "decort_cb_trunk_list" "name" {
   #фильтр по id транка
   #опциональный параметр
   #тип - массив целых чисел
   #trunk_ids = [10,11]     

   #фильтр по id учетных записей с доступом к транку
   #опциональный параметр 
   #тип - массив целых чисел    
   #account_ids = [10,11]        

   #фильтр по тегам транка (значение от 1 до 4095)     
   #опциональный параметр 
   #тип - строка     
   #trunk_tags = "4095"

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

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

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

   #размер страницы 
   #опциональный параметр 
   #если не задан - выводятся все доступные данные 
   #тип - целое число 
   #size = 1 
}
```

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

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