Изменить политику резервного копирования

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

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

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

   yc backup policy update --help
   

2. Опишите конфигурацию политики резервного копирования в формате JSON.

   Пример файла конфигурации

   {
     "compression": "NORMAL",
     "format": "AUTO",
     "multiVolumeSnapshottingEnabled": true,
     "preserveFileSecuritySettings": true,
     "reattempts": {
       "enabled": true,
       "interval": {
         "type": "SECONDS",
         "count": "30"
       },
       "maxAttempts": "30"
     },
     "silentModeEnabled": true,
     "splitting": {
       "size": "1099511627776"
     },
     "vmSnapshotReattempts": {
       "enabled": true,
       "interval": {
         "type": "MINUTES",
         "count": "5"
       },
       "maxAttempts": "3"
     },
     "vss": {
       "enabled": true,
       "provider": "TARGET_SYSTEM_DEFINED"
     },
     "archive": {
       "name": "'[Machine Name]-[Plan ID]-[Unique ID]A'"
     },
     "performanceWindow": {
     },
     "retention": {
       "rules": [
         {
           "maxCount": "10"
         }
       ],
       "beforeBackup": true
     },
     "scheduling": {
       "backupSets": [
         {
           "time": {
             "weekdays": [
               "MONDAY"
             ],
             "repeatAt": [
               {
                 "minute": "5"
               }
             ],
             "type": "WEEKLY"
           }
         }
       ],
       "enabled": true,
       "maxParallelBackups": "2",
       "randMaxDelay": {
         "type": "MINUTES",
         "count": "30"
       },
       "scheme": "ALWAYS_INCREMENTAL",
       "weeklyBackupDay": "MONDAY"
     },
     "cbt": "ENABLE_AND_USE",
     "fastBackupEnabled": true,
     "quiesceSnapshottingEnabled": true,
     "prePostCommands": [
       {
         "cmd": "/usr/bin/myapp",
         "args": "-d -rw",
         "enabled": true,
         "stopOnError": true,
         "type": "PRE_COMMAND",
         "wait": true,
         "workdir": "/etc/myapp/"
       }
     ]
   }
   

   В примере приведена конфигурация политики резервного копирования, которая будет создавать инкрементальные резервные копии для защищаемого ресурса каждый понедельник в 00:05 (UTC+0). При этом храниться будут только десять последних копий.

   Полная спецификация описана в разделе Спецификация политики резервного копирования.

3. Узнайте идентификатор политики резервного копирования, которую нужно изменить:

   yc backup policy list
   

   Результат:

   +----------------------+----------------------+---------+---------+---------------------+---------------------+
   |          ID          |      FOLDER ID       |  NAME   | ENABLED |     CREATED AT      |     UPDATED AT      |
   +----------------------+----------------------+---------+---------+---------------------+---------------------+
   | abc7n3wln123******** | ghi681qpe789******** | policy1 | true    | 2023-07-03 09:12:02 | 2023-07-03 09:12:43 |
   | deflqbiwc456******** | ghi681qpe789******** | policy2 | true    | 2023-07-07 14:58:23 | 2023-07-07 14:58:23 |
   +----------------------+----------------------+---------+---------+---------------------+---------------------+
   

4. Измените политику резервного копирования, указав ее идентификатор:

   yc backup policy update <идентификатор_политики_резервного_копирования> \
     --settings-from-file <путь_к_файлу_конфигурации>
   

   Где --settings-from-file — путь к файлу с конфигурацией политики резервного копирования в формате JSON.

   Результат:

   id: cdgkoivuvtey********
   name: sample-backup-policy
   created_at: "2025-10-06T19:09:31Z"
   updated_at: "2025-10-06T19:09:31Z"
   enabled: true
   settings:
     compression: NORMAL
     format: AUTO
     multi_volume_snapshotting_enabled: true
     reattempts:
       enabled: true
       interval:
         type: SECONDS
         count: "30"
       max_attempts: "30"
     silent_mode_enabled: true
     splitting:
       size: "1099511627776"
     vm_snapshot_reattempts:
       enabled: true
       interval:
         type: MINUTES
         count: "5"
       max_attempts: "3"
     vss:
       enabled: true
       provider: TARGET_SYSTEM_DEFINED
     archive:
       name: '''[Machine Name]-[Plan ID]-[Unique ID]A'''
     performance_window: {}
     retention:
       rules:
         - max_count: "10"
       before_backup: true
     scheduling:
       backup_sets:
         - time:
             weekdays:
               - MONDAY
             repeat_at:
               - minute: "5"
             type: WEEKLY
           type: TYPE_AUTO
       enabled: true
       max_parallel_backups: "2"
       rand_max_delay:
         type: MINUTES
         count: "30"
       scheme: ALWAYS_INCREMENTAL
       weekly_backup_day: MONDAY
     cbt: ENABLE_AND_USE
     fast_backup_enabled: true
     file_filters: {}
     pre_post_commands:
       - cmd: /usr/bin/myapp
         args: -d -rw
         enabled: true
         stop_on_error: true
         type: PRE_COMMAND
         wait: true
         workdir: /etc/myapp/
   folder_id: b1gt6g8ht345********
   

   Подробнее о команде в справочнике CLI.

Terraform позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

Terraform распространяется под лицензией Business Source License, а провайдер Yandex Cloud для Terraform — под лицензией MPL-2.0.

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

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

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

Чтобы изменить основные параметры в политике резервного копирования:

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

   Пример описания ресурса yandex_backup_policy в конфигурации Terraform

   resource "yandex_backup_policy" "my_policy" {
       archive_name                      = "[<имя_защищаемого_ресурса>]-[<идентификатор_плана>]-[<уникальный_идентификатор>]"
       cbt                               = "USE_IF_ENABLED"
       compression                       = "NORMAL"
       fast_backup_enabled               = true
       format                            = "AUTO"
       multi_volume_snapshotting_enabled = true
       name                              = "<имя_политики_резервного_копирования>"
       performance_window_enabled        = true
       silent_mode_enabled               = true
       splitting_bytes                   = "9223372036854775807"
       vss_provider                      = "NATIVE"
   
       reattempts {
           enabled      = true
           interval     = "1m"
           max_attempts = 10
       }
   
       retention {
           after_backup = false
   
           rules {
               max_age       = "365d"
               repeat_period = []
           }
       }
   
       scheduling {
           enabled              = false
           max_parallel_backups = 0
           random_max_delay     = "30m"
           scheme               = "ALWAYS_INCREMENTAL"
           weekly_backup_day    = "MONDAY"
   
           backup_sets {
               execute_by_time {
                   type                      = "MONTHLY"
                   include_last_day_of_month = true
                   monthdays                 = []
                   months                    = [1,2,3,4,5,6,7,8,9,10,11,12]
                   repeat_at                 = ["04:10"]
                   repeat_every              = "30m"
                   weekdays                  = []
               }
           }
       }
   
       vm_snapshot_reattempts {
           enabled      = true
           interval     = "1m"
           max_attempts = 10
       }
   }
   

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

2. Примените изменения:

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

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

      terraform validate
      

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

      Success! The configuration is valid.
      

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

      terraform plan
      

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

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

      terraform apply
      

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

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

   yc backup policy get <идентификатор_политики_резервного_копирования>
   

Чтобы изменить основные параметры политики резервного копирования, воспользуйтесь методом REST API update для ресурса Policy или вызовом gRPC API PolicyService/Update.

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

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

1. Узнайте идентификатор политики резервного копирования, в которой нужно изменить список защищаемых ресурсов:

   yc backup policy list
   

   Результат:

   +----------------------+----------------------+---------+---------+---------------------+---------------------+
   |          ID          |      FOLDER ID       |  NAME   | ENABLED |     CREATED AT      |     UPDATED AT      |
   +----------------------+----------------------+---------+---------+---------------------+---------------------+
   | abc7n3wln123******** | ghi681qpe789******** | policy1 | true    | 2023-07-03 09:12:02 | 2023-07-03 09:12:43 |
   | deflqbiwc456******** | ghi681qpe789******** | policy2 | true    | 2023-07-07 14:58:23 | 2023-07-07 14:58:23 |
   +----------------------+----------------------+---------+---------+---------------------+---------------------+
   

2. Узнайте идентификаторы защищаемых ресурсов, подключенных к Cloud Backup, которые нужно добавить или удалить:

   yc backup vm list
   

   Результат:

   +----------------------+--------------------------------------+--------+---------+--------+-----------------+----------------+---------------------+---------------------+--------+---------------------+---------------------+-------------+
   |     INSTANCE ID      |             RESOURCE ID              | ONLINE | ENABLED | STATUS | STATUS PROGRESS | STATUS DETAILS |  LAST BACKUP TIME   |  NEXT BACKUP TIME   | ACTIVE |     CREATED AT      |     UPDATED AT      |    TYPE     |
   +----------------------+--------------------------------------+--------+---------+--------+-----------------+----------------+---------------------+---------------------+--------+---------------------+---------------------+-------------+
   | ly5mzirn6xhd******** | 4fc0d855-b76c-****-99a4-bf01******** | true   | true    | IDLE   |               0 |                |                     |                     | true   | 2026-04-29 05:45:34 | 2026-04-29 05:54:21 | BMS         |
   | epd930eo5156******** | 6c58577d-409d-****-bc10-f464******** | true   | true    | IDLE   |               0 |                |                     |                     | true   | 2026-04-29 08:46:47 | 2026-04-29 08:54:00 | COMPUTE     |
   | cdgd246kiae3******** | d1fdd342-0ea8-****-9906-fa6c******** | false  | true    | IDLE   |               0 |                | 2026-04-27 13:07:05 | 2026-04-27 13:07:05 | true   | 2026-04-24 14:23:06 | 2026-04-29 08:54:33 | EXTERNAL_VM |
   +----------------------+--------------------------------------+--------+---------+--------+-----------------+----------------+---------------------+---------------------+--------+---------------------+---------------------+-------------+
   

3. Измените список защищаемых ресурсов в политике резервного копирования.

   • Чтобы привязать ресурс к политике резервного копирования:

     Посмотрите описание команды CLI:

     yc backup policy apply --help
     

     Привяжите ресурсы к политике резервного копирования, указав ее идентификатор:

     yc backup policy apply <идентификатор_политики_резервного_копирования> \
       --instance-ids <идентификаторы_защищаемых_ресурсов>
     

     Где --instance-ids — идентификаторы подключенных к Cloud Backup виртуальных машин Compute Cloud, серверов BareMetal или внешних ресурсов, которые нужно привязать к политике резервного копирования. Несколько идентификаторов указываются через запятую.

     Подробнее о команде читайте в справочнике CLI.

   • Чтобы отвязать защищаемые ресурсы от политики резервного копирования:

     Посмотрите описание команды CLI:

     yc backup policy revoke --help
     

     Отвяжите ресурсы от политики резервного копирования, указав ее идентификатор:

     yc backup policy revoke <идентификатор_политики_резервного_копирования> \
       --instance-ids <идентификаторы_защищаемых_ресурсов>
     

     Где --instance-ids — идентификаторы виртуальных машин Compute Cloud, серверов BareMetal или внешних ресурсов, которые нужно отвязать от политики резервного копирования. Несколько идентификаторов указываются через запятую.

     Подробнее о команде читайте в справочнике CLI.

Terraform позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

Terraform распространяется под лицензией Business Source License, а провайдер Yandex Cloud для Terraform — под лицензией MPL-2.0.

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

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

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

Чтобы изменить список защищаемых ресурсов, привязанных к политике резервного копирования:

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

   resource "yandex_backup_policy_bindings" "test_backup_binding_1" {
     instance_id = "<идентификатор_защищаемого_ресурса_1>"
     policy_id   = "<идентификатор_политики>"
   }
   
   resource "yandex_backup_policy_bindings" "test_backup_binding_2" {
     instance_id = "<идентификатор_защищаемого_ресурса_2>"
     policy_id   = "<идентификатор_политики>"
   }
   

   Где:

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

     Получить список идентификаторов, привязанных к сервису Cloud Backup ресурсов в каталоге по умолчанию, вы можете с помощью команды Yandex Cloud CLI yc backup vm list.

   • policy_id — идентификатор политики резервного копирования, к которой должны быть привязаны защищаемые ресурсы.

   Более подробную информацию о параметрах ресурса yandex_backup_policy_bindings см. в документации провайдера.

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

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

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

      terraform validate
      

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

      Success! The configuration is valid.
      

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

      terraform plan
      

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

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

      terraform apply
      

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

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

    yc backup policy list-applications
   

Чтобы изменить список защищаемых ресурсов, копии которых создаются согласно политике резервного копирования, воспользуйтесь методом REST API update для ресурса Policy или вызовом gRPC API PolicyService/Update.