Yandex Cloud
Search
Contact UsTry it for free
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
  • Marketplace
    • Featured
    • Infrastructure & Network
    • Data Platform
    • AI for business
    • Security
    • DevOps tools
    • Serverless
    • Monitoring & Resources
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
    • Price calculator
    • Pricing plans
  • Customer Stories
  • Documentation
  • Blog
© 2026 Direct Cursus Technology L.L.C.
Yandex Compute Cloud
    • All guides
      • Creating a fixed-size instance group
      • Creating a fixed-size instance group with a network load balancer
      • Creating a fixed-size instance group with an L7 load balancer
      • Creating an instance group with autoscaling
      • Creating an instance group with Container Optimized Image
      • Creating an instance group based on a YAML specification
      • Creating an instance group attached to a reserved instance pool
      • Creating an instance group in a placement group
      • Creating a group of instances with fixed IP addresses
      • Creating an instance group connected to a file storage
      • Creating an instance group connected to Object Storage
    • Viewing service resource operations
    • Viewing metrics in Monitoring
    • NVIDIA driver update guide
  • Yandex Container Solution
  • Access management
  • Pricing policy
  • Terraform reference
  • Monitoring metrics
  • Audit Trails events
  • Release notes
  1. Step-by-step guides
  2. Creating an instance group
  3. Creating an instance group based on a YAML specification

Creating an instance group based on a YAML specification

Written by
Yandex Cloud
Updated at May 5, 2026

In Instance Groups, all operations are performed under a service account. If you don't have a service account, create one.

To be able to create, update, and delete VM instances in the instance group, assign the compute.editor role to the service account.

If you want to integrate an instance group with a Yandex Network Load Balancer, you also need to assign the load-balancer.editor role to the service account.

To integrate an instance group with an L7 load balancer from Yandex Application Load Balancer, assign the alb.editor role to the service account.

To create an instance group based on a YAML specification:

CLI
API

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

The folder used by default is the one specified when creating 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.

Run this command:

yc compute instance-group create --file specification.yaml

For more information about the yc compute instance-group create command, see the CLI reference.

Use the InstanceGroupService/CreateFromYaml gRPC API call or the createFromYaml method of the REST API InstanceGroup resource.

Was the article helpful?

Previous
Creating an instance group with Container Optimized Image
Next
Creating an instance group attached to a reserved instance pool
© 2026 Direct Cursus Technology L.L.C.