Создать пустой диск с блоком большого размера

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

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

   yc compute disk create --help
   

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

   yc compute disk create \
     --name big-disk \
     --block-size 8K \
     --size 40G \
     --description "my 8k blocksize disk via yc"
   

   Команда создаст диск размером 40 ГБ и размером блока 8 КБ, с именем big-disk и описанием my 8k blocksize disk via yc.

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

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

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

   yc compute disk list
   

   Результат:

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

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

   yc compute disk list --format yaml
   

   Результат:

   - id: fhmm0br99mig********
      folder_id: b1gb9jeqoior********
      created_at: "2021-01-11T09:35:05Z"
      name: big-disk
      description: 8k blocksize disk
      type_id: network-hdd
      zone_id: kz1-a
      size: "42949672960"
      block_size: "8192"
      status: READY
      disk_placement_policy: {}
   

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

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

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

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

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

   Где:

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

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

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

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

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

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

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

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

     Важно

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

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

     Внимание

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

   Более подробную информацию о ресурсе 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.