Skip to content

stratumctl instance-types

Manage the instance-type catalog

Terminal window
stratumctl instance-types [flags]

Aliases: instance-type, itype

Re-activate a deprecated instance type

Terminal window
stratumctl instance-types activate <name> [flags]
Terminal window
stratumctl instance-types activate m1.large

Create an instance type (operator-only)

Terminal window
stratumctl instance-types create <name> [flags]
Terminal window
stratumctl instance-types create m1.xlarge --vcpus 8 --memory-bytes 34359738368 --architecture amd64 --driver libvirt-kvm
stratumctl instance-types create m1.xlarge --vcpus 8 --memory-bytes 34359738368 --architecture amd64 --driver libvirt-kvm \
--display-name "m1.xlarge" --disk-iops 5000
Flag Type Default Description
--architecture string Architecture (amd64 | arm64)
--default-root-volume-bytes int64 0 Default root volume size in bytes
--description string Free-form description
--disk-iops int 0 Enforced per-instance disk IOPS ceiling (0 = unlimited)
--disk-throughput-mbps int 0 Enforced per-instance disk throughput ceiling in MB/s (0 = unlimited)
--display-name string Human-friendly display name
--driver string Hypervisor driver kind (libvirt-kvm | fake |…)
--memory-bytes int64 0 Memory in bytes
--network-performance string Human-readable network performance hint
--network-throughput-mbps int 0 Enforced per-NIC bandwidth ceiling in Mbit/s (0 = unlimited)
--vcpus int 0 vCPU count

Stop new launches (running instances keep running)

Terminal window
stratumctl instance-types deprecate <name> [flags]
Terminal window
stratumctl instance-types deprecate m1.large

Describe an instance type

Terminal window
stratumctl instance-types get <name> [flags]
Terminal window
stratumctl instance-types get m1.large
stratumctl instance-types get m1.large --output json

List instance types (defaults to state=active)

Terminal window
stratumctl instance-types list [flags]
Terminal window
stratumctl instance-types list
stratumctl instance-types list --state all --architecture amd64
Flag Type Default Description
--architecture string Filter by architecture (amd64 | arm64)
--driver string Filter by hypervisor driver
--state string Filter by state (active | deprecated | removed | all)

Mark an instance type removed (terminal; refused while live instances reference it)

Terminal window
stratumctl instance-types remove <name> [flags]
Terminal window
stratumctl instance-types remove m1.large