Updating 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 updating a reserved instance pool:

   yc compute reserved-instance-pool update --help
   

2. Get a list of reserved instance pools in the default folder:

   yc compute reserved-instance-pool list
   

   Result:

   +----------------------+------------+---------------+------+
   |          ID          |    NAME    |    ZONE ID    | SIZE |
   +----------------------+------------+---------------+------+
   | fv48qa9iiq19******** | test-pool1 | ru-central1-a |    1 |
   | fv42fbsrso94******** | test-pool2 | ru-central1-a |    1 |
   +----------------------+------------+---------------+------+
   

3. Get detailed information about a reserved instance pool in the default folder by specifying pool name or ID:

   yc compute reserved-instance-pool get <pool_name_or_ID>
   

   Result:

   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"
     used: "1"
     available: "1"
   instance_stats:
     total: "1"
   

4. Update a reserved instance pool in the default folder by specifying pool name or ID:

   Note

   You cannot reconfigure the pool's VMs.

   yc compute reserved-instance-pool update <pool_name_or_ID> \
     --new-name <new_pool_name> \
     --description <pool_description> \
     --size <pool_size> \
     --allow-oversubscription \
     --allow-pending-slots
   

   Where:

   • --new-name: New pool name. This is an optional parameter. Follow these naming requirements:

     • It must be from 2 to 63 characters long.
     • It can only contain lowercase Latin letters, numbers, and hyphens.
     • It must start with a letter and cannot end with a hyphen.

   • --description: Pool description. This is an optional parameter.

   • --size: New number of slots per pool. This is an optional parameter.

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

     To enable the overcommitment mode, provide the --allow-oversubscription parameter in the command.

     To disable overcommitment where previously enabled, provide the --allow-oversubscription=false parameter in the command.

   • --allow-pending-slots: Parameter to enable pending slots when modifying pool size. This is an optional parameter. By default, when you change a pool’s size, the pending slots setting is disabled.

   Result:

   done (8s)
   id: fv4vnl1ncbja********
   zone_id: ru-central1-a
   cloud_id: b1gia87mbaom********
   folder_id: b1gt6g8ht345********
   name: new-pool
   description: the new 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: "3"
   committed_size: "3"
   slot_stats:
     total: "3"
     used: "1"
     available: "2"
   instance_stats:
     total: "1"
   

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