diff --git a/07.01.19-Resource-функция-decort_disk_snapshot-управление-снимком-диска.md b/07.01.19-Resource-функция-decort_disk_snapshot-управление-снимком-диска.md new file mode 100644 index 0000000..cffdbb2 --- /dev/null +++ b/07.01.19-Resource-функция-decort_disk_snapshot-управление-снимком-диска.md @@ -0,0 +1,53 @@ +Функция доступна в провайдере версии 3.2 и выше. + +_Resource_ функция **decort_disk_snapshot** служит для управления снимками данных диска. Функция позволяет: +- Получить снимок +- Удалить снимок +- Произвести "откат" диска к этому снимку + +## Аргументы +_Resource_ функция **decort_disk_snapshot** принимает следующие аргументы: + +| Аргумент | Тип | Обязательный | Описание | +| --- | --- | :---: | --- | +| disk_id | int | :heavy_check_mark: | ID диска, к которому принадлежит снимок | +| label | string | :heavy_check_mark: | ID снимка | +| rollback | bool | :x: | Откат диска. Происходит только при изменении с false на true. По умолчанию - false | +| timestamp | int | :x: | Время отката. Используется только при осуществлении отката | + +## Возвращаемые значения +В случае успешного выполнения _resource_ функция **decort_disk_snapshot** возвращает в указанную при вызове переменную элемент, который состоит из следующих параметров: + +| Параметр | Тип | Описание | +| --- | --- | --- | +| disk_id | int | ID диска, к которому принадлежит снимок | +| label | string | Наименование снимка | +| rollback | bool | Откат диска. Происходит только при изменении с false на true. По умолчанию - false | +| timestamp | int | Время отката. Используется только при осуществлении отката | +| guid | string | ID снимка | +| res_id | string | Ссылка на снимок | +| snap_set_guid | string | ID набора снимков, в котором лежит снимок состояния | +| snap_set_time | string | Время набора | + +## Пример использования +Пример вызова _resource_ функции **decort_disk_snapshot**: +```terraform +resource "decort_disk_snapshot" "ds" { + #Номер диска + #обязательный параметр + #тип - число + disk_id = 20100 + + #Ярлык диска + #обязательный параметр + #тип - строка + label = "label" + + #флаг отката + #опциональный параметр + #тип - bool + rollback = false +} +``` + +После успешного завершения такого вызова **decort_disk_snapshot** в переменной `decort_disk_snapshot.ds` будут сохранены возвращаемые значения. \ No newline at end of file