4.9.5

4.7.2/07.01.05-Resource_decort_snapshot.md

@@ -0,0 +1,57 @@
+Функция доступна в провайдере версии 2.1 и выше.
+
+_Resource_ функция **decort_snapshot** служит для управления снапшотами. Снапшот позволяет делать снимки данных с диска, а после этого их восстанавливать. Для успешного восстановления данных через снапшот, необходимо убедиться, что [compute](link will available soon) (вычислительные мощности) остановлен.
+
+## Аргументы
+_Resource_ функция **decort_snapshot** для создания снапшота принимает следующие аргументы:
+
+| Аргумент | Тип | Обязательный | Описание |
+| --- | --- | --- | --- |
+| compute_id | int | :heavy_check_mark: | ID вычислительной мощности |
+| label | string | :heavy_check_mark: | Наименование снапшота |
+| rollback | bool | :x: | Флаг отката<br/>по-умолчанию - false<br/>если флаг был изменен с false на true,<br/>то произойдет восстановление данных из снапшота<br/>Флаг используется после создания ресурса. |
+| snapshot_delete_async | bool | :x: | Флаг для удаления снапшотов в асинхронном режиме |
+
+## Возвращаемые значения
+В случае успешного выполнения _resource_ функция **decort_snapshot** возвращает в указанную при вызове переменную следующие значения:
+
+| Параметр | Тип | Описание |
+| --- | --- | --- |
+| guid | string | Guid снапшота |
+| label | string | Наименование снапшота |
+| timestamp | int | Время создания снапшота |
+| disks | []int | Диски снапшота |
+
+## Пример использования
+Пример вызова _resource_ функции **decort_snapshot**:
+```terraform
+resource "decort_snapshot" "s" {
+  #обязательный параметр
+  #id вычислительной мощности
+  #тип - целое число
+  compute_id = 24074
+
+  #обязательный параметр
+  #наименование snapshot
+  #тип - строка
+  label = "test_ssht_3"
+
+  #флаг отката
+  #опциональный параметр
+  #если флаг был измеен с false на true, то произойдет откат
+  #по-уолчанию - false
+  #тип - булев
+  #rollback = false
+
+  #флаг для удаление снапшота асинхронном режиме
+  #опциональный параметр
+  #по умолчанию - false
+  #тип - булев
+  delete_async_mode = true
+
+}
+```
+
+Данный пример подразумевает, что ранее по тексту tf-файла выполнена корректная инициализация провайдера (подробнее об инициализации Terraform провайдера DECORT см. соответствующий [раздел](https://repository.basistech.ru/BASIS/wiki-terraform-provider-decort/src/branch/main/4.7.2/04.02-Инициализация-Terraform-провайдера-DECORT.md)). 
+
+После успешного завершения такого вызова **decort_snapshot** в переменной `decort_snapshot.s` будут сохранены возвращаемые значения.