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

_Data source_ функция **decort_cb_kvmvm_audits** служит для получения аудитов компьюта.

## Deprecated

Данный datasource является **deprecated** и будет удалён в следующих версиях. Вместо него неоходимо использовать datasource **decort_cb_audit_list**.

## Аргументы

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

| Аргумент | Тип | Обязательный | Описание |
| --- | --- | --- | --- |
| compute_id | int | :heavy_check_mark: | ID компьюта |
| timestamp_to | int | :x: | Фильтр аудитов по начальной временной метке. |
| timestamp_at | int | :x: | Фильтр аудитов по конечной временной метке. |
| user | string | :x: | Фильтр по имени пользователя, выполнившего действие |
| call | string | :x: | Фильтр по endpoint API, к которому был выполнен запрос |
| sort_by | string | :x: | Сортировка результатов по поддерживаемым полям. Формат: `+` (по возрастанию) или `-` (по убыванию) с указанием названия поля (например: `+timestamp`, `-user`) |
| page | int | :x: | Номер страницы для пагинации (по умолчанию: 1) |
| size | int | :x: | Размер страницы для пагинации (по умолчанию: 100) |
| min_status_code  | int | :x: | Фильтр по минимальному HTTP статус-коду |
| max_status_code  | int | :x: | Фильтр по максимальному HTTP статус-коду |

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

| Параметр | Тип | Описание |
| --- | --- | --- |
| timestamp_to | int | Фильтр аудитов по начальной временной метке. |
| timestamp_at | int | Фильтр аудитов по конечной временной метке. |
| user | string | Фильтр по имени пользователя, выполнившего действие |
| call | string | Фильтр по endpoint API, к которому был выполнен запрос |
| sort_by | string | :x: | Сортировка результатов по поддерживаемым полям. Формат: `+` (по возрастанию) или `-` (по убыванию) с указанием названия поля (например: `+timestamp`, `-user`) |
| page | int | :x: | Номер страницы для пагинации (по умолчанию: 1) |
| size | int | :x: | Размер страницы для пагинации (по умолчанию: 100) |
| min_status_code  | int | :x: | Фильтр по минимальному HTTP статус-коду |
| max_status_code  | int | :x: | Фильтр по максимальному HTTP статус-коду |
| call | string | Какая команда была выполнена |
| responsetime | float | Время выполнения |
| statuscode | int | Статус выполнения |
| timestamp | float | Точное время исполнения |
| user | string | Кем была выполнена команда |

## Пример использования
```terraform
data "decort_cb_kvmvm_audits" "kvmvm_audits" {
  #id виртуальной машины
  #обязательный параметр
  #тип - целое число
  compute_id = 10154

  #найти все аудиты после определенного момента времени
  #опциональный параметр
  #тип - целое число
  #timestamp_to = 11

  #найти все аудиты до определенного момента времени 
  #опциональный параметр
  #тип - целое число
  #timestamp_at = 11

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

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

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

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

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

  #найти по минимальному коду статуса HTTP 
  #опциональный параметр
  #тип - целое число
  #min_status_code = 1

  #найти по максимальному коду статуса HTTP 
  #опциональный параметр
  #тип - целое число
  #max_status_code = 140
}
```

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

После успешного завершения такого вызова _data source_ функции **decort_cb_kvmvm_audits** в переменной `data.decort_cb_kvmvm_audits.kvmvm_audits` будут сохранены возвращаемые значения. 
