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

_Data source_ функция **decort_sdn_access_group_list** служит для получения списка существующих групп доступа (access groups).

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

| Аргумент | Тип | Обязательный | Описание |
| --- | --- | --- | --- |
| page | int | :x: | Номер страницы результата |
| per_page | int | :x: | Количество результатов на странице |
| sort_by | string | :x: | Сортировка по одному из поддерживаемых полей (display_name, created_at, updated_at, deleted_at, owner_login) |
| sort_order | string | :x: | Порядок сортировки (asc, desc) |
| enabled | bool | :x: | Фильтр по включенной/выключенной группе доступа |
| deleted | bool | :x: | Фильтр по удаленной/не удаленной группе доступа |
| display_name | string | :x: | Фильтр по отображаемому имени |
| created_from | string | :x: | Фильтр по нижней границе даты создания |
| created_to | string | :x: | Фильтр по верхней границе даты создания |

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

| Параметр | Тип | Описание |
| --- | --- | --- |
| id | string | Уникальный идентификатор группы доступа |
| display_name | string | Отображаемое имя группы доступа |
| comment | string | Комментарий к группе доступа |
| created_at | string | Время создания группы доступа |
| updated_at | string | Время последнего обновления группы доступа |
| net_object_access_group | []Struct [см. ниже](#описание-структуры-net_object_access_group) | Конфигурация сетевого объекта группы доступа |
| default_security_policy | []Struct [см. ниже](#описание-структуры-default_security_policy) | Конфигурация политики безопасности по умолчанию |

### Описание структуры net_object_access_group
| Параметр | Тип | Описание |
| --- | --- | --- |
| access_group_id | string | Идентификатор группы доступа |
| id | string | Уникальный идентификатор сетевого объекта |
| version_id | int | Идентификатор версии |

### Описание структуры default_security_policy
| Параметр | Тип | Описание |
| --- | --- | --- |
| display_name | string | Отображаемое имя политики безопасности |
| id | string | Уникальный идентификатор политики безопасности |
| description | string | Описание политики безопасности |
| version_id | int | Идентификатор версии политики безопасности |
| access_group_id | string | Идентификатор группы доступа, связанной с политикой |
| default_acl_drop | string | Действие по умолчанию для ACL drop |
| default_open_session_drop | bool | Флаг сброса открытых сессий по умолчанию |

## Пример использования
В нижеприведённом примере посредством вызова _data source_ функции **decort_sdn_access_group_list** извлекается список существующих на платформе групп доступа:

```terraform
data "decort_sdn_access_group_list" "name" {
  #фильтр по включенной\выключенной группе  
   #опциональный параметр
   #тип - булев 
   #enabled = false

   #фильтр по удаленной/не удаленной группе 
   #опциональный параметр 
   #тип - булев 
   #deleted = true      

   #фильтр по отображаемому имени
   #опциональный параметр 
   #тип - строка
   #display_name = "name"

   #номер страницы результата 
   #опциональный параметр 
   #тип - целое число 
   #page = 1
 
   #количество результатов на странице
   #опциональный параметр 
   #тип - целое число
   #per_page = 2

   #сортировка по одному из поддерживаемых полей 
   #опциональный параметр 
   #тип - строка 
   #возможные значения - display_name, created_at, updated_at, deleted_at, owner_login 
   #sort_by = "created_at"

   #порядок сортировки
   #опциональный параметр 
   #тип - строка 
   #возможные значения - asc, desc
   #sort_order = "asc"

   #фильтр по нижней границе даты создания
   #опциональный параметр 
   #тип - строка 
   #значение по умолчанию - null
   #created_from = "2023-01-01T00:00:00Z"

   #фильтр по верхней границе даты создания    
   #опциональный параметр 
   #тип - строка
   #значение по умолчанию - null    
   #created_to = "2023-01-01T00:00:00Z"
}
```

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

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

