Creating a reserved instance pool

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

By default, the CLI uses the folder specified when creating the profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also set a different folder for any specific command using the --folder-name or --folder-id parameter.

1. See the description of the Yandex Cloud CLI command for creating a reserved instance pool:

   yc compute reserved-instance-pool create --help
   

2. Create a reserved instance pool in the default folder:

   yc compute reserved-instance-pool create \
     --name <pool_name> \
     --description <pool_description> \
     --zone-id <availability_zone_ID> \
     --size <pool_size> \
     --platform <platform_ID> \
     --cores <number_of_vCPUs> \
     --memory <RAM_size> \
     --gpus <number_of_GPUs> \
     --gpu-cluster-id <GPU_cluster_ID> \
     --allow-oversubscription
   

   Where:

   • --name: Name of the new pool. Follow these naming requirements:

     • Length: between 3 and 63 characters.
     • It can only contain lowercase Latin letters, numbers, and hyphens.
     • It must start with a letter and cannot end with a hyphen.

   • --description: Description of the new pool. This is an optional parameter.

   • --zone-id: ID of the availability zone to reserve computing resources in.

   • --size: Number of slots per pool. This is an optional parameter. The default value is 0.

   • --platform: Platform where the computing resources are reserved. This is an optional parameter. The default value is standard-v2 (Intel Cascade Lake).

   • --cores: Number of vCPUs for VMs in the new pool. This is an optional parameter. The default value is 2.

   • --memory: Amount of RAM for VMs in the new pool. This is an optional parameter. The default value is 2 GB.

   • --gpus: Number of GPUs for VMs in the new pool. This is an optional parameter. This parameter is only available if you select a platform with GPU support.

   • --gpu-cluster-id: GPU cluster ID. This is an optional parameter.

   • --allow-oversubscription: Parameter enabling the oversubscription mode for the pool. In this mode, you can attach VMs beyond the pool capacity. This is an optional parameter. The oversubscription mode is off by default.

   Result:

   done (8s)
   id: fv4vnl1ncbja********
   zone_id: ru-central1-a
   cloud_id: b1gia87mbaom********
   folder_id: b1gt6g8ht345********
   name: test-pool
   description: sample description
   created_at: "2025-08-12T07:58:57Z"
   platform_id: standard-v2
   resources_spec:
     memory: "2147483648"
     cores: "2"
     core_fraction: "100"
   gpu_settings: {}
   network_settings:
     type: STANDARD
   size: "2"
   committed_size: "2"
   slot_stats:
     total: "2"
     unavailable: "2"
   instance_stats: {}
   

   For more information about the yc compute reserved-instance-pool create command, see the Yandex Cloud CLI reference.

Use the create REST API method for the ReservedInstancePool resource or the ReservedInstancePoolService/Create gRPC API call.