Creating a non-replicated disk

Written by

Yandex Cloud

Improved by

Danila N.

Updated at May 5, 2025

Creating a stand-alone non-replicated disk
Creating a non-replicated disk in a placement group

You can create a stand-alone non-replicated disk or add such a disk to a disk placement group.

The disk size must be a multiple of 93 GB.

Creating a stand-alone non-replicated disk

Management console

CLI

Terraform

API

In the management console, select the folder where you want to create a disk.
Select Compute Cloud.
In the left-hand panel, select Disks.
Click Create disk.
Enter a name for the disk. The naming requirements are as follows:
- It must be from 2 to 63 characters long.
- It may contain lowercase Latin letters, numbers, and hyphens.
- It must start with a letter and cannot end with a hyphen.
Add a description for the disk, if required.
Select the availability zone the disk will reside in.
Select Non-replicated SSD as the disk type.
Select the required block size.
Specify the required disk size.
Optionally, under Encryption:
- Select Encrypted disk.
- In the KMS key field, select the key you created earlier. To create a new key, click Create.
To create an encrypted disk, you need the kms.keys.user role or higher.

Warning

You can specify encryption settings only when creating a disk. You cannot disable or change disk encryption. You also cannot enable encryption for an existing disk.

If you deactivate the key used to encrypt a disk, image, or snapshot, access to the data will be suspended until you reactivate the key.

Alert

If you destroy the key or its version used to encrypt a disk, image, or snapshot, access to the data will be irrevocably lost. For details, see Destroying key versions.
Select or set up a schedule for automatically creating disk snapshots, if required. For more information about setting up schedules, see this guide.

When creating a disk, you can only select a single snapshot schedule. After the disk is created, you can add a few more schedules, if required, by following this guide.
Click Create disk.

The folder specified when creating the CLI profile is used by default. To change the default folder, use the yc config set folder-id <folder_ID> command. You can specify a different folder using the --folder-name or --folder-id parameter.

See the description of the CLI command for creating disks:
```
yc compute disk create --help
```
To create a non-replicated disk named nr-disk, run this command:
```
yc compute disk create \
  --name nr-disk \
  --type network-ssd-nonreplicated \
  --size 93 \
  --kms-key-id <key_ID>
```
Where:
- --name: Disk name.
- --type: Disk type.
- --size: Disk size.
- --kms-key-id: ID of the KMS symmetric key to create en encrypted disk. This is an optional parameter.
  
  To create an encrypted disk, you need the kms.keys.user role or higher.
  
  Warning
  
  You can specify encryption settings only when creating a disk. You cannot disable or change disk encryption. You also cannot enable encryption for an existing disk.
  
  If you deactivate the key used to encrypt a disk, image, or snapshot, access to the data will be suspended until you reactivate the key.
  
  Alert
  
  If you destroy the key or its version used to encrypt a disk, image, or snapshot, access to the data will be irrevocably lost. For details, see Destroying key versions.
Result:
```
done (1s)
id: epdb2517b970********
folder_id: b1g7gvsi89m3********
...
block_size: "4096"
status: READY
disk_placement_policy: {}
hardware_generation:
  legacy_features:
    pci_topology: PCI_TOPOLOGY_V1
kms_key:
  key_id: abjbaqdga6hs********
  version_id: abj295dgqnlp********
```

With Terraform, you can quickly create a cloud infrastructure in Yandex Cloud and manage it using configuration files. These files store the infrastructure description written in HashiCorp Configuration Language (HCL). If you change the configuration files, Terraform automatically detects which part of your configuration is already deployed, and what should be added or removed.

Terraform is distributed under the Business Source License. The Yandex Cloud provider for Terraform is distributed under the MPL-2.0 license.

For more information about the provider resources, see the documentation on the Terraform website or mirror website.

If you do not have Terraform yet, install it and configure its Yandex Cloud provider.

In the configuration file, define the non-replicated disk parameters:
```
resource "yandex_compute_disk" "nr" {
  name       = "<non-replicated_disk_name>"
  size       = <non-replicated_disk_size>
  block_size = <block_size>
  type       = "network-ssd-nonreplicated"
  zone       = "<availability_zone>"
}
```
Where:
- name: Non-replicated disk name. The naming requirements are as follows:
  - It must be from 2 to 63 characters long.
  - It may contain lowercase Latin letters, numbers, and hyphens.
  - It must start with a letter and cannot end with a hyphen.
- size: Non-replicated disk size, which must be a multiple of 93 GB.
- block_size: Block size in bytes (minimum storage unit on the disk). The maximum disk size depends on the specified block size. By default, the block size is 4 KB for all new disks; however, this is insufficient for disks larger than 8 TB. For more information, see Creating an empty disk with a large block.
- type: Disk type. Specify network-ssd-nonreplicated to create a non-replicated disk.
- zone: Availability zone.
For more information about the yandex_compute_disk resource parameters in Terraform, see the relevant provider documentation.
Make sure the configuration files are correct.
1. In the command line, go to the directory where you created the configuration file.
2. Run a check using this command:
```
terraform plan
```
If you described the configuration correctly, the terminal will display a list of the resources being created and their parameters. If the configuration contains any errors, Terraform will point them out.
Deploy the cloud resources.
1. If the configuration does not contain any errors, run this command:
```
terraform apply
```
2. Confirm resource creation by typing yes in the terminal and pressing Enter.
  
  This will create all the resources you need in the specified folder. You can check the new resources and their settings using the management console or this CLI command:
```
yc compute disk list
```

Use the create REST API method for the Disk resource or the DiskService/Create gRPC API call.