Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
    • Yandex Cloud Partner program
  • Blog
  • Pricing
  • Documentation
© 2025 Direct Cursus Technology L.L.C.
Yandex Compute Cloud
  • Yandex Container Solution
    • Resource relationships
    • Graphics processing units (GPUs)
    • Images
      • Overview
      • Access
      • YAML specification
      • Instance template
      • Variables in an instance template
      • Scaling types
      • Instance health checks and automatic recovery
        • Overview
        • Allocating instances across zones
        • Deployment algorithm
        • Rules for updating instances
        • Updating secondary disks in an instance template
      • Integrating with network and L7 load balancers
      • Handling a stateful workload
      • Stopping and pausing an instance group
      • Sequentially restarting and recreating instances in a group
      • Statuses
    • Dedicated host
    • Encryption
    • Backups
    • Quotas and limits
  • Access management
  • Terraform reference
  • Monitoring metrics
  • Audit Trails events
  • Release notes

In this article:

  • Implications of changing settings of instance groups
  • Changes that don't affect instances
  • Changes that cause the restart or re-creation of instances
  • Changing the instance template
  • Changes that don't affect an instance
  • Parameters whose update leads to instance restart
  • Parameters whose update leads to instance recreation
  1. Concepts
  2. Instance groups
  3. Updating
  4. Rules for updating instances

Rules for updating instance groups

Written by
Yandex Cloud
Updated at July 3, 2024
  • Implications of changing settings of instance groups
    • Changes that don't affect instances
    • Changes that cause the restart or re-creation of instances
  • Changing the instance template
    • Changes that don't affect an instance
    • Parameters whose update leads to instance restart
    • Parameters whose update leads to instance recreation

Updating an instance group is performed to ensure minimum implications for the instances managed by the group.

In ascending order of risk, instance groups can perform the following actions:

  • Updating an instance without stopping.
  • Updating an instance with restart: stopping and then starting the instance.
  • Re-creating an instance: deleting an instance and creating a new one.
  • Deleting an instance.

You can also set the minimum action to perform for updating an instance group.

Alert

When an instance is deleted, all its associated resources are deleted, such as the boot disk, secondary disks, and dynamic IP addresses.

Implications of changing settings of instance groupsImplications of changing settings of instance groups

Changes to the settings of instance groups may affect instances in this group in different ways.

Changes that don't affect instancesChanges that don't affect instances

  • Changing the instance group metadata (name, description, labels, service_account_id).

  • Changing the group deployment policy (deploy_policy).

  • Changing the specification of health checks (health_checks_spec).

  • Changing of target group specifications for a network load balancer (load_balancer_spec) and L7 load balancer (application_load_balancer_spec), but not adding or deleting these specifications.

Changes that cause the restart or re-creation of instancesChanges that cause the restart or re-creation of instances

  • Changing the group scaling policy (scale_policy).

    If the user changed the group size in the parameter or enabled automatic scaling that changed the group size, then old instances may be deleted or new instances may be created.

  • Changing the allocation policy (allocation_policy).

    When you change the policy for allocation of instances between zones, instances may be permanently deleted. Instances may also be deleted from one zone and created in another zone, since it's impossible to move instances between zones.

  • Changing of target group specifications for a network load balancer (load_balancer_spec) and L7 load balancer (application_load_balancer_spec).

Changing the instance templateChanging the instance template

In some cases, changing the instance template (instance_template) causes the instance to restart or be re-created.

Changes that don't affect an instanceChanges that don't affect an instance

  • Changing the instance name, description, and labels (name, description, labels).
  • Changing the service account of an instance (not instance group) (service_account_id).
  • Changing the VM security groups (network_interface_specs.security_group_ids).

Parameters whose update leads to instance restartParameters whose update leads to instance restart

  • platform_id: Hardware platform.

  • resources_spec.{memory,cores,core_fraction,gpus}: RAM, CPU, guaranteed CPU %, number of GPUs.

  • boot_disk_spec: Boot disk.

  • metadata: Instance metadata.

  • Network interface parameters:

    • network_interface_specs.network_id: Network ID
    • network_interface_specs.subnet_ids: Subnet IDs
    • network_interface_specs.primary_v4_address_spec: Parameters of the public IPv4 address
    • network_interface_specs.primary_v6_address_spec: Parameters of the public IPv6 address

Parameters whose update leads to instance recreationParameters whose update leads to instance recreation

  • network_interface_specs: Only when adding or deleting network interfaces. Updating the parameters of the available interfaces does not lead to instance recreation.
  • secondary_disk_specs: You cannot update secondary disks without recreating the instance. Disks are retained whenever possible.
  • scheduling_policy: You cannot convert a regular instance to a preemptible instance or vice versa without recreating it.

Was the article helpful?

Previous
Deployment algorithm
Next
Updating secondary disks in an instance template
© 2025 Direct Cursus Technology L.L.C.