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

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --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"
   

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

   Требования к имени диска:

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

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
   - 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********
   

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

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

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

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

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

   Где:

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

     • длина — от 3 до 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.