[Yandex Cloud documentation](../../../index.md) > [Yandex Compute Cloud](../../index.md) > [Step-by-step guides](../index.md) > Reserved instance pools > Updating a reserved instance pool

# Updating a reserved instance pool

{% note warning %}

Reserved instance pools are billable: you pay for the whole unused volume of reserved computing resources of VMs, GPU clusters, and software accelerated networks according to the [Yandex Compute Cloud pricing policy](../../pricing.md). For more information, see [Using reserved instance pools](../../pricing.md#pool).

{% endnote %}

_The reserved instance pool feature is at the [Preview stage](../../../overview/concepts/launch-stages.md)._

{% note info %}

You cannot reconfigure the pool's VMs.

{% endnote %}

To [update a reserved instance pool](../../concepts/reserved-pools.md):

{% list tabs group=instructions %}

- Management console {#console}

  1. In the [management console](https://console.yandex.cloud), select the [folder](../../../resource-manager/concepts/resources-hierarchy.md#folder) the reserved instance pool is in.
  1. Navigate to **Compute Cloud**.
  1. In the left-hand panel, select ![image](../../../_assets/console-icons/folder-lock.svg) **VM reserve pools**.
  1. In the pool row, click ![image](../../../_assets/console-icons/ellipsis.svg) and select ![image](../../../_assets/console-icons/pencil.svg) **Edit**.
  1. Edit the VM parameters:

       * Pool type.
       * Pool size.
       * If you need to expand the pool even when there are not enough free resources in the availability zone, enable **When resources are absent**. For more information, see [Pending slots](../../concepts/reserved-pools.md#pending-slots).
       * Under **General information about the pool**, change the name and description of the pool, add or delete the pool's [labels](../../../resource-manager/concepts/labels.md).

  1. Click **Save**.

- CLI {#cli}

  If you do not have the Yandex Cloud CLI yet, [install and initialize it](../../../cli/quickstart.md#install).

  The folder used by default is the one specified when [creating](../../../cli/operations/profile/profile-create.md) 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](../../../cli/index.md) command for updating a reserved instance pool:

      ```bash
      yc compute reserved-instance-pool update --help
      ```
  1. Get a list of reserved instance pools in the default folder:
     
     ```bash
     yc compute reserved-instance-pool list
     ```
     
     Result:
     
     ```text
     +----------------------+------------+---------------+------+
     |          ID          |    NAME    |    ZONE ID    | SIZE |
     +----------------------+------------+---------------+------+
     | fv48qa9iiq19******** | test-pool1 | ru-central1-a |    1 |
     | fv42fbsrso94******** | test-pool2 | ru-central1-a |    1 |
     +----------------------+------------+---------------+------+
     ```
  1. Get detailed information about a reserved instance pool in the default folder by specifying pool name or ID:

      ```bash
      yc compute reserved-instance-pool get <pool_name_or_ID>
      ```

      Result:

      ```text
      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"
      ```
  1. Update a reserved instance pool in the default folder by specifying pool name or ID:

      ```bash
      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 setting. 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`: Pool description. This is an optional setting.
      * `--size`: New number of slots per pool. This is an optional setting.
      * `--allow-oversubscription`: Parameter enabling or disabling the [oversubscription mode](../../concepts/reserved-pools.md#oversubscription) for the pool. In this mode, you can attach VMs beyond the pool capacity. This is an optional setting.

          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](../../concepts/reserved-pools.md#pending-slots) when modifying pool size. This is an optional setting. By default, when you change a pool’s size, the pending slots setting is disabled.

      Result:

      ```text
      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](../../../cli/cli-ref/compute/cli-ref/reserved-instance-pool/update.md).

- API {#api}

  Use the [update](../../api-ref/ReservedInstancePool/update.md) REST API method for the [ReservedInstancePool](../../api-ref/ReservedInstancePool/index.md) resource or the [ReservedInstancePoolService/Update](../../api-ref/grpc/ReservedInstancePool/update.md) gRPC API call.

{% endlist %}

#### See also {#see-also}

* [Managing VMs in a reserved instance pool](manage-pool-vms.md)
* [Reserved instance pools in Compute Cloud](../../concepts/reserved-pools.md)