# metalcloud-cli vm-instance-group create

Create a new VM instance group in an infrastructure

## Synopsis

Create a new VM instance group in an infrastructure.

This command creates a new VM instance group with the specified configuration.
The group will contain multiple VM instances of the same type and configuration,
making it easier to manage and scale similar workloads.

ARGUMENTS:
  infrastructure_id  The ID of the infrastructure where the group will be created
  vm_type_id         The VM type ID defining CPU, memory, and other hardware specs
  disk_size_gb       The disk size in GB for each VM instance in the group
  instance_count     The number of VM instances to create in the group
  os_template_id     Optional. The OS template ID for the VM instances

EXAMPLES:
  ## Create a VM instance group with 3 instances using a specific OS template
  metalcloud-cli vm-instance-group create 12345 vm-type-1 100 3 ubuntu-20.04
  
  ## Create a VM instance group without specifying OS template
  metalcloud-cli vmg new 12345 vm-type-small 50 2
  
  ## Create a larger group for high-performance workloads
  metalcloud-cli vm-group create 12345 vm-type-performance 500 10 centos-8

```
metalcloud-cli vm-instance-group create infrastructure_id vm_type_id disk_size_gb instance_count [os_template_id] [flags]
```

### Options

```
  -h, --help   help for create
```

### Options inherited from parent commands

```
  -k, --api_key string         MetalCloud API key
  -c, --config string          Config file path
  -d, --debug                  Set to enable debug logging
  -e, --endpoint string        MetalCloud API endpoint
  -f, --format string          Output format. Supported values are 'text','csv','md','json','yaml'. (default "text")
  -i, --insecure_skip_verify   Set to allow insecure transport
  -l, --log_file string        Log file path
  -v, --verbosity string       Log level verbosity (default "INFO")
```

### SEE ALSO

* [metalcloud-cli vm-instance-group](/content/configuration/cli/metalcloud-cli_vm-instance-group.md)	 - Manage VM instance groups within infrastructures

#### Auto generated by spf13/cobra on 11-Aug-2025