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

_Data source_ функция **decort_sdn_access_group_user_list** служит для получения списка пользователей группы доступа (access group).

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

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

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

| Параметр | Тип | Описание |
| --- | --- | --- |
| id | string | Уникальный идентификатор пользователя |
| display_name | string | Отображаемое имя пользователя |
| role_id | string | Идентификатор роли пользователя |
| login | string | Логин пользователя |

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

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

  #фильтр по глобальной роли
  #опциональный параметр
  #тип - строка
  #global_role = "global_role"

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

  #фильтр по включению
  #опциональный параметр
  #тип - булев
  #enabled = false

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

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

  #фильтр по логину пользователя
  #опциональный параметр
  #тип - строка
  #login = "login"

  #кто создал пользователя
  #опциональный параметр
  #тип - строка
  #created_by = "name"

  #кто обновил пользователя
  #опциональный параметр
  #тип - строка
  #updated_by = "name"

  #кто удалил пользователя
  #опциональный параметр
  #тип - строка
  #deleted_by = "name"

  #кто отключил пользователя
  #опциональный параметр
  #тип - строка
  #disabled_by = "name"

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

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

  #сортировка по одному из поддерживаемых полей
  #опциональный параметр
  #тип - строка
  #возможные значения - display_name, email, phone, created_at, updated_at, deleted_at
  #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.10.1/04.02-Инициализация-Terraform-провайдера-DECORT.md)).

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

