4.4 KiB
Data source функция decort_kvmvm_snapshot_usage служит для получения информации о использовании снапшотов.
Ресурсная группа в облачной платформе DECORT это способ группирования compute-ов (например, по функциональному признаку или принадлежности к одному и тому же проекту). Ресурсную группу можно рассматривать как небольшой персональный дата-центр, в котором размещаются один или несколько серверов и виртуальных сетевых сегментов (ViNS).
Экземпляры compute (виртуальные серверы) всегда создаются в принадлежности к какой-либо ресурсной группе. Как следствие, для создания экземпляра compute помимо других параметров требуется указать идентификатор целевой ресурсной группы. Для получения такого идентификатора можно воспользоваться рассматриваемой здесь data source функцией decort_kvmvm_snapshot_usage.
Аргументы
Data source функция decort_kvmvm_snapshot_usage принимает следующие аргументы:
| Аргумент | Тип | Обязательный | Описание |
|---|---|---|---|
| compute_id | ✔️ | int | Идентификатор компьюта |
| label | ❌ | string | Название снапшота |
Пользователь облачной платформы задается на стадии инициализации Terraform провайдера DECORT (см. подробности).
Возвращаемые значения
В случае успешного выполнения data source функция decort_kvmvm_snapshot_usage возвращает в указанную при вызове переменную, в поле items, массив, каждый элемент которого состоит из следующих параметров:
| Параметр | Тип | Описание |
|---|---|---|
| count | int | Количество компьютов, использующих снапшот |
| stored | float | Stored |
| label | string | Название снапшота |
| timestamp | int | Время снапшота |
Пример использования
Пример вызова data source функции decort_kvmvm_snapshot_usage:
data "decort_kvmvm_snapshot_usage" "snapshot_usage" {
#id виртуальной машины
#обязательный параметр
#тип - целое число
compute_id = 10154
#название снапшота
#опциональный параметр
#тип - строка
label = "label 1"
}
Данный пример подразумевает, что ранее по тексту tf-файла выполнена корректная инициализация провайдера (подробнее об инициализации Terraform провайдера DECORT см. соответствующий раздел и пример).
После успешного завершения такого вызова decort_kvmvm_snapshot_usage в переменной data.decort_kvmvm_snapshot_usage.snapshot_usage будут сохранены возвращаемые значения. В частности, для получения идентификатора ресурсной группы следует использовать конструкцию data.decort_kvmvm_snapshot_usage.snapshot_usage.id