Creating an image from a disk

If you do not have the Yandex Cloud CLI yet, install and initialize it.

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.

1. See the description of the CLI command for creating an image:

   yc compute image create --help
   

2. Get a list of disks in the default folder:

   yc compute disk list
   

   Result:

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

3. Select ID or NAME of the disk you need.

4. Create an image in the default folder:

   yc compute image create \
     --name first-image \
     --source-disk-name first-disk \
     --description "my first image via yc"
   

   This command will create an image named first-image described as my first image via yc from first-disk.

   To create an optimized image, use the --pooled flag:

   yc compute image create \
     --name first-image \
     --source-disk-name first-disk \
     --description "my first image via yc" \
     --pooled
   

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

1. Define the parameters of the yandex_compute_image resource in the configuration file.

   Here is an example of the configuration file structure:

   resource "yandex_compute_image" "image-1" {
     name        = "<image_name>"
     source_disk = "<disk_ID>"
   }
   

   For more information about the resources you can create with Terraform, see the relevant provider documentation.

2. 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 the configuration is correct, the terminal will display a list of resources to create and their parameters. If the configuration contains any errors, Terraform will point them out.

3. Deploy the cloud resources.

   1. Run this command:

      terraform apply
      

   2. Confirm creating the resources.

   All the resources you need will then be created in the specified folder. You can check the new resources and their settings using the management console.

1. Get a list of disks using the list REST API method for the Disk resource or the DiskService/List gRPC API call.
2. Create an image using the create REST API method for the Image resource or the ImageService/Create gRPC API call. Specify the disk ID in your request.