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

_Data source_ функция **decort_sdn_access_group** служит для получения информации об уже существующей группе доступа (access group).

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

| Аргумент | Тип | Обязательный | Описание |
| --- | --- | --- | --- |
| access_group_id | string | :heavy_check_mark: | Идентификатор группы доступа |

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

| Параметр | Тип | Описание |
| --- | --- | --- | 
| 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** извлекается информация об уже существующей на платформе группе доступа:

```terraform
data "decort_sdn_access_group" "name" {
  #идентификатор группы доступа
  #обязательный параметр
  #тип - строка
  access_group_id = "a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8"
}
```

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

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

