Восстановить диск с помощью снимка

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

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

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

   yc compute disk create --help
   

2. Получите список снимков в каталоге по умолчанию:

   yc compute snapshot list
   

   Результат:

   +----------------------+----------------------+----------------------+----------+
   |          ID          |         NAME         |     PRODUCT IDS      |  STATUS  |
   +----------------------+----------------------+----------------------+----------+
   | fd84hanhvjql******** | disk-1-1668075122980 | f2ef3frbftr2******** | READY    |
   | fd85mc22cosp******** | disk-2-1669114692462 | f2ef3frbftr2******** | READY    |
   +----------------------+----------------------+----------------------+----------+
   

3. Выберите идентификатор (ID) или имя (NAME) нужного снимка.

4. Создайте диск из выбранного снимка:

   yc compute disk create \
     --name <имя_диска> \
     --source-snapshot-name <имя_снимка-источника> \
     --zone <зона_доступности> \
     --description <текстовое_описание_диска> \
     --hardware-generation-id <поколение_оборудования> \
     --hardware-features pci_topology=<топология_PCI>
   

   Где:

   • --name — имя создаваемого диска. Требования к имени:

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

   • --source-snapshot-name — имя снимка-источника. Вместо имени вы можете передать в команду идентификатор снимка-источника в параметре --source-snapshot-id.

   • --zone — зона доступности, в которой создается диск.

   • --description — текстовое описание создаваемого диска. Необязательный параметр.

   • --hardware-generation-id — поколение оборудования, закрепляемое за диском. Необязательный параметр. Возможные значения:

     • legacy — поколение Gen 1. При выборе этого поколения вы также можете задать топологию PCI в параметре --hardware-features.

     Если параметр не задан, за диском будет закреплено то же поколение оборудования, которое закреплено за снимком-источником.

   • --hardware-features — дополнительные настройки для поколения Gen 1. Необязательный параметр. Возможные значения:

     • pci_topology=v1 — выбор топологии PCI_TOPOLOGY_V1.
     • pci_topology=v2 — выбор топологии PCI_TOPOLOGY_V2.

     Если за снимком-источником закреплено поколение Gen 1, по умолчанию у создаваемого диска для параметра --hardware-features будет задано то же значение, что и у снимка-источника.

   Результат:

   done (44s)
   id: epdbnjirsai9********
   folder_id: b1gt6g8ht345********
   created_at: "2025-06-23T14:46:22Z"
   name: second-disk
   description: my second disk via yc
   type_id: network-hdd
   zone_id: ru-central1-a
   size: "21474836480"
   block_size: "4096"
   product_ids:
     - f2evcrm9ti79********
   status: READY
   source_snapshot_id: fd81qi89ldop********
   disk_placement_policy: {}
   hardware_generation:
     legacy_features:
       pci_topology: PCI_TOPOLOGY_V2
   

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

5. Получите список дисков в каталоге по умолчанию:

   yc compute disk list
   

   Результат:

   +----------------------+--------------+-------------+-------------------+--------+----------------------+-----------------+-------------+
   |          ID          |     NAME     |    SIZE     |       ZONE        | STATUS |     INSTANCE IDS     | PLACEMENT GROUP | DESCRIPTION |
   +----------------------+--------------+-------------+-------------------+--------+----------------------+-----------------+-------------+
   | a7lqgbt0bb9s******** | first-disk   | 20401094656 |   ru-central1-a   | READY  | a7lcvu28njbh******** |                 |             |
   | a7lv5j5hm1p1******** | second-disk  | 21474836480 |   ru-central1-a   | READY  |                      |                 |             |
   +----------------------+--------------+-------------+-------------------+--------+----------------------+-----------------+-------------+
   

   Получите тот же список с большим количеством деталей в формате YAML:

   yc compute disk list --format yaml
   

   Результат:

   - id: epd73ra2mrd4********
     folder_id: b1gt6g8ht345********
     created_at: "2025-06-23T16:57:01Z"
     name: first-disk
     description: my first disk
     type_id: network-hdd
     zone_id: ru-central1-a
     size: "21474836480"
     block_size: "4096"
     product_ids:
       - f2evcrm9ti79********
     status: READY
     source_snapshot_id: fd81qi89ldop********
     disk_placement_policy: {}
     hardware_generation:
       legacy_features:
         pci_topology: PCI_TOPOLOGY_V1
   - id: epd8lmcncidv********
     folder_id: b1gt6g8ht345********
     created_at: "2025-06-23T06:32:26Z"
     name: second-disk
     type_id: network-ssd
     zone_id: ru-central1-a
     size: "21474836480"
     block_size: "4096"
     product_ids:
       - f2evcrm9ti79********
     status: READY
     source_image_id: fd80j21lmqar********
     instance_ids:
       - epdm2ene322e********
     disk_placement_policy: {}
     hardware_generation:
       legacy_features:
         pci_topology: PCI_TOPOLOGY_V1
   

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

1. Опишите в конфигурационном файле параметры ресурса yandex_compute_disk.

   Пример структуры конфигурационного файла:

   resource "yandex_compute_disk" "my-disk" {
     name           = "<имя_диска>"
     zone           = "<зона_доступности>"
     snapshot_id    = "<идентификатор_снимка>"
     hardware_generation {
       legacy_features {
         pci_topology = "<топология_PCI>"
       }
     }
   }
   

   Где:

   • name — имя создаваемого диска. Требования к имени:

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

   • zone — зона доступности, в которой создается диск.

   • snapshot_id — идентификатор снимка, на основе которого вы создаете диск.

   • hardware_generation — блок настроек с описанием поколения оборудования, закрепляемого за диском. Необязательный параметр. Включает в себя следующие блоки настроек:

     • legacy_features — блок настроек с описанием параметров при выборе поколения Gen 1:

       • pci_topology — выбор топологии PCI. Возможные значения:

         • PCI_TOPOLOGY_V1 — выбор топологии PCI_TOPOLOGY_V1.
         • PCI_TOPOLOGY_V2 — выбор топологии PCI_TOPOLOGY_V2.

       Использование блока legacy_features делает невозможным использование блока generation2_features.

     Примечание

     Если блок hardware_generation не задан, за диском будет закреплено то же поколение оборудования, которое закреплено за снимком-источником.

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

2. Проверьте корректность конфигурационных файлов.

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

   2. Выполните проверку с помощью команды:

      terraform plan
      

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

3. Разверните облачные ресурсы.

   1. Если в конфигурации нет ошибок, выполните команду:

      terraform apply
      

   2. Подтвердите создание ресурсов.

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

1. Получите список снимков с помощью метода REST API list для ресурса Snapshot или вызова gRPC API SnapshotService/List.
2. Создайте диск с помощью метода REST API create для ресурса Disk или вызова gRPC API DiskService/Create. В запросе укажите идентификатор снимка-источника, а также при необходимости задайте нужное поколение оборудования в объекте hardwareGeneration (hardware_generation при использовании gRPC API).