Contact UsGet started

Updating an instance group

Written by
Updated at February 12, 2025

After creating an instance group, you can:

Changing the name and description

To change the name and description of an instance group:

  1. In the management console, open the folder containing the instance group you need.
  2. Select Compute Cloud.
  3. In the left-hand panel, select Instance groups.
  4. Select the group to update.
  5. In the top-right corner of the page, click Edit.
  6. Fill in the Name and Description fields.
  7. Click Save.

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

The folder specified in the CLI profile is used by default. You can specify a different folder through the --folder-name or --folder-id parameter.

  1. See the description of the CLI command for updating an instance group:

    yc compute instance-group update --help

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

    yc compute instance-group list

    Result:

    +----------------------+-----------------------+------+
|          ID          |         NAME          | SIZE |
+----------------------+-----------------------+------+
| amc65sbgfqeq******** | first-instance-group  |    2 |
+----------------------+-----------------------+------+

  3. Select ID of the instance group in question.

  4. 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 on the instance group and create a new file. For more information, see Creating a fixed-size instance group.

  5. Update the instance group in the default folder:

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

    Instance Groups will initiate instance group updating.

To change the name and description of an instance group, use the update REST API method for the InstanceGroup resource or the InstanceGroupService/Update gRPC API call.

To request a list of available instance groups, use the listInstances REST API method or the InstanceGroupService/ListInstances gRPC API call.

Changing computing resources

After creating an instance group, you can change:

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

Warning

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

To change computing resources of an instance group:

  1. In the management console, open the folder containing the instance group you need.
  2. Select Compute Cloud.
  3. In the left-hand panel, select Instance groups.
  4. Select the group to update.
  5. In the top-right corner of the page, click Edit.
  6. Under Instance template:
    • Click 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.
  7. Click Save on the Changing an instance group page.

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

The folder specified in the CLI profile is used by default. You can specify a different folder through the --folder-name or --folder-id parameter.

  1. See the description of the CLI command for updating an instance group:

    yc compute instance-group update --help

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

    yc compute instance-group list

    Result:

    +----------------------+-----------------------+------+
|          ID          |         NAME          | SIZE |
+----------------------+-----------------------+------+
| amc65sbgfqeq******** | first-instance-group  |    2 |
+----------------------+-----------------------+------+

  3. Select ID of the instance group in question.

  4. 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 on the instance group and create a new file. For more information, see Creating a fixed-size instance group.

  5. Update the instance group in the default folder:

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

    Instance Groups will initiate instance group updating.

To change computing resources, use the update REST API method for the InstanceGroup resource or the InstanceGroupService/Update gRPC API call.

To request a list of available instance groups, use the listInstances REST API method or the InstanceGroupService/ListInstances gRPC API call.

Increasing the disk size

Warning

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

To increase the disk size of an instance group:

  1. In the management console, open the folder containing the instance group you need.
  2. Select Compute Cloud.
  3. In the left-hand panel, select Instance groups.
  4. Select the group to update.
  5. In the top-right corner of the page, click Edit.
  6. In the top-right corner of the Instance template section, click and select Edit.
  7. Under Disks and file storages, specify the disk size.
  8. Click Save.
  9. Click Save on the Changing an instance group page.

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

The folder specified in the CLI profile is used by default. You can specify a different folder through the --folder-name or --folder-id parameter.

  1. See the description of the CLI command for updating an instance group:

    yc compute instance-group update --help

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

    yc compute instance-group list

    Result:

    +----------------------+-----------------------+------+
|          ID          |         NAME          | SIZE |
+----------------------+-----------------------+------+
| amc65sbgfqeq******** | first-instance-group  |    2 |
+----------------------+-----------------------+------+

  3. Select ID of the instance group in question.

  4. 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 on the instance group and create a new file. For more information, see Creating a fixed-size instance group.

  5. Update the instance group in the default folder:

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

    Instance Groups will initiate instance group updating.

To change the disk size, use the update REST API method for the InstanceGroup resource or the InstanceGroupService/Update gRPC API call.

To request a list of available instance groups, use the listInstances REST API method or the InstanceGroupService/ListInstances gRPC API call.

Previous
Getting a list of instances in a group
Next
Updating an instance group based on a YAML specification