Creating a reserved instance pool

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

The folder used by default is the one specified when creating the CLI profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also specify a different folder for any command using --folder-name or --folder-id. If you access a resource by its name, the search will be limited to the default folder. If you access a resource by its ID, the search will be global, i.e., through all folders based on access permissions.

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_amount> \
     --gpus <number_of_GPUs> \
     --gpu-cluster-id <GPU_cluster_ID> \
     --allow-oversubscription
   

   Where:

   • --name: Name of the new pool. The naming requirements are as follows:

     • 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 setting.

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

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

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

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

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

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

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

   • --allow-oversubscription: Parameter enabling the oversubscription mode for the pool. In this mode, you can attach stopped VMs in a quantity that exceeds the pool's capacity. This is an optional setting. 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.