Создать пустой диск

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

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

   yc compute disk create --help
   

2. Создайте диск в каталоге по умолчанию:

   yc compute disk create \
     --name first-disk \
     --size 10 \
     --description "my first disk via yc" \
     --kms-key-id <идентификатор_ключа>
   

   Где:

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

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

   • --size — размер диска.

   • --description — описание диска.

   • --kms-key-id — идентификатор симметричного ключа KMS для создания зашифрованного диска. Необязательный параметр.

     Для создания зашифрованного диска нужна роль kms.keys.user или выше.

     Важно

     Задать настройки шифрования можно только при создании диска. Шифрование диска нельзя будет отключить или изменить. Также нельзя будет включить шифрование для уже созданного диска.

     Если деактивировать ключ, которым были зашифрованы диск, снимок или образ, доступ к данным будет приостановлен, пока ключ не будет снова активирован.

     Внимание

     Если удалить ключ или его версию, которыми были зашифрованы диск, снимок или образ, доступ к данным будет безвозвратно потерян. Подробнее см. Удаление версии ключа.

   Команда создаст диск размером 10 ГБ с именем first-disk и описанием my first disk via yc.

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

   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: fhm4aq4hvq5g********
       folder_id: b1gm3og7ei7a********
       created_at: "2018-10-29T07:43:06Z"
       name: first-disk
       description: my first disk via yc
       type_id: network-hdd
       zone_id: ru-central1-a
       size: "10737418240"
       status: READY
       disk_placement_policy: {}
       hardware_generation:
         legacy_features:
           pci_topology: PCI_TOPOLOGY_V1
       kms_key:
         key_id: abjbaqdga6hs********
         version_id: abj295dgqnlp********
   - id: fhmo6rdqg5fo********
       folder_id: b1gm3og7ei7a********
       created_at: "2018-10-29T07:33:04Z"
       name: second-disk
       description: my second disk via yc
       type_id: network-hdd
       zone_id: ru-central1-a
       size: "8589934592"
       product_ids:
       - f2en2dtd08b5********
       status: READY
       source_image_id: fdvk34al8k5n********
       instance_ids:
       - fhm5b617fjnj********
       disk_placement_policy: {}
       hardware_generation:
         legacy_features:
           pci_topology: PCI_TOPOLOGY_V1
       kms_key:
         key_id: abjbaqdga6hs********
         version_id: abj295dgqnlp********
   

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

Чтобы создать пустой диск:

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

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

   resource "yandex_compute_disk" "empty-disk" {
     name       = "empty-disk"
     type       = "network-hdd"
     zone       = "<зона_доступности>"
     size       = <размер_диска>
     block_size = <размер_блока>
   }
   

   Где:

   • name — имя диска. Формат имени:

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

   • type — тип создаваемого диска.

   • zone — зона доступности. Зона доступности для диска должна соответствовать зоне группы размещения, в которой вы хотите создать диск. Рекомендуется создавать диски в зонах доступности ru-central1-a или ru-central1-b.

   • size — размер диска в ГБ. Максимальный размер диска зависит от заданного размера блока.

   • block_size — размер блока в байтах (минимальный объем хранения информации на диске). По умолчанию размер блоков всех создаваемых дисков равен 4 КБ, однако для дисков больше 8 ТБ этого недостаточно. Подробнее см. в разделе Создать пустой диск с блоком большого размера.

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

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

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

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

      terraform plan
      

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

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

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

      terraform apply
      

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

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

   yc compute disk list
   

Воспользуйтесь методом REST API create для ресурса Disk или вызовом gRPC API DiskService/Create.