Custom IOPS not applied to root disk when deploying a VM from a template
@xujiantop-crypto is already working on this.
Since Sep 10, 2026.
- #14114 by @xujiantop-crypto — open
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 25/100
- Issue type
- Bug
- Clarity
- Clearly specified
- Activity status
- Stale
- Tech stack
- java
- Domain
- backend, infrastructure
Research direction
Start at CloudOrchestrator.createVirtualMachine() and trace how vm_instance_details values are read into DiskOfferingInfo. Compare the minIops/maxIops detail names with the API constants MIN_IOPS and MAX_IOPS, then verify that the ROOT volume receives both values during deployment. Confirm the fix with the linked pull request and a deployment test using custom IOPS.
Written by the indexing model from the issue text.
Description
problem
Description
When a user deploys a VM from a template with a Custom IOPS offering for the ROOT disk, the min IOPS and max IOPS entered in Deploy Instance are stored in VM details but not copied to the ROOT volume.
volumes.min_iops and volumes.max_iops stay empty. Vendor storage that reads IOPS from the volumes gets null for min IOPS and max IOPS instead of the values entered at deploy.
Root Cause
The UI sends custom IOPS as details[0].minIops and details[0].maxIops. CloudStack stores them in vm_instance_details with those same names (minIops / maxIops).
When the ROOT volume is created, CloudOrchestrator.createVirtualMachine() reads IOPS using the API constants MIN_IOPS and MAX_IOPS. Those constants are miniops and maxiops.
The names do not match, so the lookup finds nothing. DiskOfferingInfo is left with no IOPS, and VolumeOrchestrator creates the ROOT volume with empty min_iops / max_iops.
It is a regression from Apache CloudStack PR: https://github.com/apache/cloudstack/pull/8800 (April 2024).
Observations:
vm_instance_details has minIops / maxIops
ROOT volume min_iops / max_iops are NULL
versions
CloudStack: 4.20 and later, including 4.23.
The steps to reproduce the bug
- Go to Instances → Add Instance.
- Select a template (do not use ISO).
- In Compute offering, set Override root disk offering to true and select the Custom IOPS disk offering for the ROOT disk.
- Enter min IOPS and max IOPS (for example, 100 and 1000).
- Complete the wizard and deploy the VM.
- After the VM is created, check the ROOT volume and VM details
What to do about it?
Impact
- The VM deploys with no error even though min and max IOPS are not applied on the ROOT volume.
- Expected IOPS are not served because custom min/max IOPS are not set on the ROOT volume, so there is no IOPS guarantee.
Expected Behaviour
Custom IOPS from deploy-VM details must be applied to the root volume
- Dominant language
- Java
- Stars
- 3.1k
- Forks
- 1.4k
- Avg merge
- 6d 20h
- Merged PRs (30d)
- 27
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from apache/cloudstack
-
bug
Difficulty 1/5 Under an hour Newbie friendliness 90/100
apache/cloudstack#14222 ·
-
bug component:kubernetes
Difficulty 1/5 Under an hour Newbie friendliness 88/100
apache/cloudstack#14180 ·
-
bug component:projects component:UI
Difficulty 1/5 Under an hour Newbie friendliness 88/100
apache/cloudstack#14070 · 5 comments ·
-
component:backup
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
apache/cloudstack#14013 ·
-
KVM agent fails to connect to Ceph RBD storage pool after upgrading Ceph client to Tentacle 20.2.4 Openbug component:ceph
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
apache/cloudstack#13989 · 3 comments ·
All issues in apache/cloudstack
Similar issues
-
area/plugin
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
kestra-io/plugin-kestra#190 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
google-ai-edge/LiteRT-LM#3739 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
integra-team-red/meet-map#249 ·
-
[Studio][Bug] Cancelled create-user dialog keeps the password and admin switch for the next attempt Open
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
apache/rocketmq-dashboard#5064 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
wso2/dpdp-accelerator#287 ·