Создать расписание, по которому будут создаваться снимки дисков

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

1. Посмотрите описание команд CLI для работы с расписаниями:

   yc compute snapshot-schedule --help
   yc compute snapshot-schedule create --help
   

2. Создайте расписание:

   yc compute snapshot-schedule create <имя_расписания> \
     --expression "<cron-выражение>" \
     --start-at "<дата_и_время_начала>" \
     --retention-period "<срок_хранения_снимков>" \
     --description "<описание_расписания>" \
     --labels "<метки_расписания>" \
     --snapshot-description "<описание_снимка>" \
     --snapshot-labels "<метки_снимка>"
   

   Где:

   • --expression — cron-выражение. Обязательный параметр.
   • --start-at — дата и время начала расписания в формате RFC3339.
   • --retention-period — срок хранения снимков. Указывается в формате длительности, например: 300ms, 1.5h или 2h45m. Используйте либо --retention-period, либо --snapshot-count.
   • --snapshot-count — максимальное количество снимков для каждого диска. Используйте либо --snapshot-count, либо --retention-period.
   • --description — описание расписания.
   • --labels — метки расписания в формате ключ=значение.
   • --snapshot-description — описание снимка.
   • --snapshot-labels — метки снимка в формате ключ=значение.

   Результат:

   id: fd8uhc5qcinv********
   folder_id: b1g681qpemb4********
   created_at: "2026-05-25T21:03:22Z"
   name: my-schedule
   description: for my disks
   status: ACTIVE
   schedule_policy:
     start_at: "2027-01-02T15:04:05Z"
     expression: 30 0 * * *
   retention_period: 3600s
   snapshot_spec:
     description: my snapshot
   

   Примечание

   Время создания снимка указывается в часовом поясе UTC±00:00.

   Подробнее о команде yc compute snapshot-schedule create в справочнике CLI.

3. Получите идентификаторы дисков, чтобы добавить их в расписание:

   yc compute disk list --format yaml
   

   Результат:

   - id: epdcq9g3co9s********
     folder_id: e1ea8s8l71li********
     created_at: "2022-10-13T14:37:44Z"
   ...
     instance_ids:
       - fhm1c7u23aiq********
     disk_placement_policy: {}
   

   Создавать можно снимки сетевых дисков HDD, SSD и нереплицируемых SSD, а также сверхбыстрых сетевых хранилищ с тремя репликами (SSD).

   Для нереплицируемых SSD и сверхбыстрых сетевых хранилищ с тремя репликами (SSD) момент времени, когда фиксируется содержимое диска, не детерминирован.

   Для снимков с локальных дисков на выделенных хостах используйте сервис Yandex Cloud Backup (поддерживает ОС Ubuntu, CentOS, CentOS Stream и Windows Server).

4. Добавьте диски в расписание:

   yc compute snapshot-schedule add-disks <имя_или_идентификатор_расписания> \
     --disk-id <идентификатор_диска_1>,<идентификатор_диска_2>
   

   Результат:

   done (3s)
   id: fc8e52mvchb2********
   folder_id: e1ea8s8l71li********
   ...
     expression: 36 14 */1 * *
   snapshot_count: "3"
   snapshot_spec: {}
   

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Чтобы управлять инфраструктурой с помощью Terraform от имени сервисного аккаунта или пользовательских аккаунтов: аккаунта на Яндексе, федеративного аккаунта и локального пользователя, аутентифицируйтесь соответствующим способом.

1. Опишите в конфигурационном файле Terraform параметры ресурса, который необходимо создать:

   resource "yandex_compute_snapshot_schedule" "default" {
     schedule_policy {
       expression = "<cron-выражение>"
       start_at   = "<дата_и_время_начала>"
     }
   
     retention_period = "<срок_хранения_снимков>"
     name             = "<название_расписания>"
     description      = "<описание_расписания>"
     labels           = {
       <ключ_метки_расписания> = "<значение_метки_расписания>"
     }
   
     snapshot_spec {
       description = "<описание_снимка>"
       labels      = {
         <ключ_метки_снимка> = "<значение_метки_снимка>"
       }
     }
   
     disk_ids = ["<идентификатор_диска_1>", "<идентификатор_диска_2>"]
   }
   

   Где:

   • schedule_policy — параметры расписания:

     • expression — cron-выражение. Обязательный параметр.
     • start_at — дата и время в формате RFC3339, с которого будет работать расписание.

   • retention_period — срок хранения снимков. Указывается в формате длительности, например: "300ms", "1.5h" или "2h45m". Остальные снимки, созданные по этому расписанию, будут удаляться автоматически. Используйте либо retention_period, либо snapshot_count.

   • snapshot_count — максимальное количество снимков для каждого диска. Используйте либо snapshot_count, либо retention_period.

     Примечание

     На количество и суммарный объем снимков в облаке действуют квоты.

   • name — имя расписания в формате:

     • длина — от 3 до 63 символов;
     • может содержать строчные буквы латинского алфавита, цифры и дефисы;
     • первый символ — буква, последний — не дефис.

   • description — описание расписания.

   • labels — метки расписания в формате <ключ> = "<значение>".

   • snapshot_spec — параметры снимков, которые будут созданы по этому расписанию:

     • description — описание снимка.
     • labels — метки снимка в формате <ключ> = "<значение>".

   • disk_ids — идентификаторы дисков, для которых будут создаваться снимки.

   Создавать можно снимки сетевых дисков HDD, SSD и нереплицируемых SSD, а также сверхбыстрых сетевых хранилищ с тремя репликами (SSD).

   Для нереплицируемых SSD и сверхбыстрых сетевых хранилищ с тремя репликами (SSD) момент времени, когда фиксируется содержимое диска, не детерминирован.

   Для снимков с локальных дисков на выделенных хостах используйте сервис Yandex Cloud Backup (поддерживает ОС Ubuntu, CentOS, CentOS Stream и Windows Server).

   Подробнее о параметрах ресурса yandex_compute_snapshot_schedule в документации провайдера Terraform.

2. Создайте ресурсы:

   1. В терминале перейдите в директорию с конфигурационным файлом.

   2. Проверьте корректность конфигурации с помощью команды:

      terraform validate
      

      Если конфигурация является корректной, появится сообщение:

      Success! The configuration is valid.
      

   3. Выполните команду:

      terraform plan
      

      В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.

   4. Примените изменения конфигурации:

      terraform apply
      

   5. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

После этого в указанном каталоге будет создано расписание. Проверить появление расписания и его настройки можно в консоли управления или с помощью команды CLI:

yc compute snapshot-schedule get <имя_расписания>

1. Получите список дисков с помощью метода REST API list для ресурса Disk или вызова gRPC API DiskService/List.

   Создавать можно снимки сетевых дисков HDD, SSD и нереплицируемых SSD, а также сверхбыстрых сетевых хранилищ с тремя репликами (SSD).

   Для нереплицируемых SSD и сверхбыстрых сетевых хранилищ с тремя репликами (SSD) момент времени, когда фиксируется содержимое диска, не детерминирован.

   Для снимков с локальных дисков на выделенных хостах используйте сервис Yandex Cloud Backup (поддерживает ОС Ubuntu, CentOS, CentOS Stream и Windows Server).

2. Создайте расписание снимков с помощью метода REST API create для ресурса SnapshotSchedule или вызова gRPC API SnapshotScheduleService/Create.