[Yandex Cloud documentation](../../../index.md) > [Yandex Compute Cloud](../../index.md) > [Step-by-step guides](../index.md) > Managing an instance group > Updating an instance group

# Updating an instance group

After creating an instance group, you can:

* [Change the name and description](#change-name).
* [Change computing resources](#change-compute-resources).
* [Increase the disk size](#change-disk-size).

## Changing the name and description {#change-name}

To change the name and description of an instance group:

{% list tabs group=instructions %}

- Management console {#console}

  1. In the [management console](https://console.yandex.cloud), open the folder containing the instance group in question.
  1. Navigate to **Compute Cloud**.
  1. In the left-hand panel, select ![image](../../../_assets/console-icons/layers-3-diagonal.svg) **Instance groups**.
  1. Select the group to update.
  1. In the top-right corner of the page, click **Edit**.
  1. Fill in the **Name** and **Description** fields.
  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 CLI command for updating a group:

     ```bash
     yc compute instance-group update --help
     ```

  1. Get a list of instance groups in the default folder:

      ```bash
      yc compute instance-group list
      ```
      
      Result:
      
      ```text
      +----------------------+----------------------+--------+------+
      |          ID          |          NAME        | STATUS | SIZE |
      +----------------------+----------------------+--------+------+
      | cl15b3mrkk88******** | first-instance-group | ACTIVE |    3 |
      +----------------------+----------------------+--------+------+
      ```

  1. Select `ID` of the instance group in question.
  1. Specify the name and description you need in the YAML file that was used to create the group, e.g., `specification.yaml`. If this YAML file is missing, [get info](get-info.md) on the instance group and create a new file. For more information, see [Creating a fixed-size instance group](create-fixed-group.md).
  1. Update the instance group in the default folder:

      ```bash
      yc compute instance-group update --id <instance_group_ID> --file specification.yaml
      ```

     Instance Groups will initiate an instance group update.

- API {#api}

  To change the name and description of an instance group, use the [update](../../instancegroup/api-ref/InstanceGroup/update.md) REST API method for the [InstanceGroup](../../instancegroup/api-ref/InstanceGroup/index.md) resource or the [InstanceGroupService/Update](../../instancegroup/api-ref/grpc/InstanceGroup/update.md) gRPC API call.

  To request a list of available instance groups, use the [listInstances](../../instancegroup/api-ref/InstanceGroup/listInstances.md) REST API method or the [InstanceGroupService/ListInstances](../../instancegroup/api-ref/grpc/InstanceGroup/listInstances.md) gRPC API call.

{% endlist %}

## Changing computing resources {#change-compute-resources}

After creating an instance group, you can change:

* Guaranteed vCPU share.
* Number of vCPUs and amount of RAM.

{% note warning %}

If the instance group is stopping or is already stopped, updates are applied only when the group starts again.

{% endnote %}

To change computing resources of an instance group:

{% list tabs group=instructions %}

- Management console {#console}

  1. In the [management console](https://console.yandex.cloud), open the folder containing the instance group in question.
  1. Navigate to **Compute Cloud**.
  1. In the left-hand panel, select ![image](../../../_assets/console-icons/layers-3-diagonal.svg) **Instance groups**.
  1. Select the group to update.
  1. In the top-right corner of the page, click **Edit**.
  1. Under **Instance template**:
     * Click ![image](../../../_assets/console-icons/ellipsis.svg) in the top-right corner and select **Delete** to delete the current instance template.
     * Click **Define** to create a new template with required instance parameters.
     * Click **Save**.
  1. Click **Save** on the **Changing an instance group** page.

- 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 CLI command for updating a group:

     ```bash
     yc compute instance-group update --help
     ```

  1. Get a list of instance groups in the default folder:

      ```bash
      yc compute instance-group list
      ```
      
      Result:
      
      ```text
      +----------------------+----------------------+--------+------+
      |          ID          |          NAME        | STATUS | SIZE |
      +----------------------+----------------------+--------+------+
      | cl15b3mrkk88******** | first-instance-group | ACTIVE |    3 |
      +----------------------+----------------------+--------+------+
      ```

  1. Select `ID` of the instance group in question.
  1. Specify the required instance parameters in the `resources_spec` key in the YAML file that was used to create the group, e.g., `specification.yaml`. If this YAML file is missing, [get info](get-info.md) on the instance group and create a new file. For more information, see [Creating a fixed-size instance group](create-fixed-group.md).
  1. Update the instance group in the default folder:

      ```bash
      yc compute instance-group update --id <instance_group_ID> --file specification.yaml
      ```

     Instance Groups will initiate an instance group update.

- API {#api}

  To change computing resources, use the [update](../../instancegroup/api-ref/InstanceGroup/update.md) REST API method for the [InstanceGroup](../../instancegroup/api-ref/InstanceGroup/index.md) resource or the [InstanceGroupService/Update](../../instancegroup/api-ref/grpc/InstanceGroup/update.md) gRPC API call.

  To request a list of available instance groups, use the [listInstances](../../instancegroup/api-ref/InstanceGroup/listInstances.md) REST API method or the [InstanceGroupService/ListInstances](../../instancegroup/api-ref/grpc/InstanceGroup/listInstances.md) gRPC API call.

{% endlist %}

## Increasing the disk size {#change-disk-size}

{% note warning %}

If the instance group is stopping or is already stopped, updates are applied only when the group starts again.

{% endnote %}

To increase the disk size of an instance group:

{% list tabs group=instructions %}

- Management console {#console}

  1. In the [management console](https://console.yandex.cloud), open the folder containing the instance group in question.
  1. Navigate to **Compute Cloud**.
  1. In the left-hand panel, select ![image](../../../_assets/console-icons/layers-3-diagonal.svg) **Instance groups**.
  1. Select the group to update.
  1. In the top-right corner of the page, click **Edit**.
  1. In the top-right corner of the **Instance template** section, click ![image](../../../_assets/console-icons/ellipsis.svg) and select **Edit**.
  1. Under **Disks and file storages**, specify the disk size.
  1. Click **Save**.
  1. Click **Save** on the **Changing an instance group** page.

- 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 CLI command for updating a group:

     ```bash
     yc compute instance-group update --help
     ```

  1. Get a list of instance groups in the default folder:

      ```bash
      yc compute instance-group list
      ```
      
      Result:
      
      ```text
      +----------------------+----------------------+--------+------+
      |          ID          |          NAME        | STATUS | SIZE |
      +----------------------+----------------------+--------+------+
      | cl15b3mrkk88******** | first-instance-group | ACTIVE |    3 |
      +----------------------+----------------------+--------+------+
      ```

  1. Select `ID` of the instance group in question.
  1. Specify the required storage size in the `boot_disk_spec` key in the YAML file that was used to create the group, e.g., `specification.yaml`. If this YAML file is missing, [get info](get-info.md) on the instance group and create a new file. For more information, see [Creating a fixed-size instance group](create-fixed-group.md).
  1. Update the instance group in the default folder:

      ```bash
      yc compute instance-group update --id <instance_group_ID> --file specification.yaml
      ```

     Instance Groups will initiate an instance group update.

- API {#api}

  To change the disk size, use the [update](../../instancegroup/api-ref/InstanceGroup/update.md) REST API method for the [InstanceGroup](../../instancegroup/api-ref/InstanceGroup/index.md) resource or the [InstanceGroupService/Update](../../instancegroup/api-ref/grpc/InstanceGroup/update.md) gRPC API call.

  To request a list of available instance groups, use the [listInstances](../../instancegroup/api-ref/InstanceGroup/listInstances.md) REST API method or the [InstanceGroupService/ListInstances](../../instancegroup/api-ref/grpc/InstanceGroup/listInstances.md) gRPC API call.

{% endlist %}