Introduce Quota resource statement API by winterhazel · Pull Request #13236 · apache/cloudstack · GitHub

Description

This PR introduces the quotaResourceStatement API to the Quota plugin. This API allows viewing the Quota consumption associated with a specific resource. It will be used by the Quota UI rework in a separate PR.

In addition, some adjustments were made in the quotaStatement API in order to allow including the consumption of subdomains in the resulting statement.

Types of changes

Breaking change (fix or feature that would cause existing functionality to change)
New feature (non-breaking change which adds functionality)
Bug fix (non-breaking change which fixes an issue)
Enhancement (improves an existing feature and functionality)
Cleanup (Code refactoring and cleanup, that may add test cases)
Build/CI
Test (unit or integration test code)

Feature/Enhancement Scale or Bug Severity

Feature/Enhancement Scale

Major
Minor

How Has This Been Tested?

I tested the API by fuzzing its parameters for root admin, domain admin, and user accounts. In the tests, I validated that the API returned the expected response while performing correct permission checking.

Environment configuration

My environment had two domains: ROOT and d1.

MariaDB [cloud]> select uuid,name,path,parent from domain;
+--------------------------------------+------+------+--------+
| uuid                                 | name | path | parent |
+--------------------------------------+------+------+--------+
| de3f3dfb-f84b-11f0-8ace-32e0826870ba | ROOT | /    |   NULL |
| dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d | d1   | /d1/ |      1 |
+--------------------------------------+------+------+--------+

Each domain had a domain admin (dr for ROOT and d1 for d1) and a user account (ur for ROOT and u1 for d1). ROOT also had a project and the root admin.

MariaDB [cloud]> select uuid,account_name,domain_id,role_id from account;
+--------------------------------------+--------------------------+-----------+---------+
| uuid                                 | account_name             | domain_id | role_id |
+--------------------------------------+--------------------------+-----------+---------+
| f684aae8-f84b-11f0-8ace-32e0826870ba | system                   |         1 |       1 |
| f684da1a-f84b-11f0-8ace-32e0826870ba | admin                    |         1 |       1 |
| 17dfdcce-fd02-46d0-85ae-7de91fda634c | baremetal-system-account |         1 |       4 |
| aaba75a0-a575-41be-80e1-dbea14c10e51 | dr                       |         1 |       3 |
| feaffae2-7ba4-45dc-b46f-20ae86192685 | d1                       |         2 |       3 |
| 2f49212d-d6d5-437b-800d-a7bb4a8def4b | u1                       |         2 |       4 |
| b029e8b8-e539-4d1a-906d-3d4f2fb36b82 | ur                       |         1 |       4 |
| b14100c6-d9f6-450e-87a2-0833bb45e5f8 | PrjAcct-aa-1             |         1 |    NULL |
+--------------------------------------+--------------------------+-----------+---------+

Test 1 (user accounts)

id: returns the statement scoped to the owning account when the caller has access to it, and an error when it does not.

 (u1) 🐱 > quota resourcestatement id=53c791d2-ac8f-4acb-9246-3a2b9eb354ea startdate=2026-01-01 enddate=2027-01-01 usagetype=1
 {
   "quotaresourcestatement": {
     "items": [
       {
 	"accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
 	"enddate": "2026-05-24T20:59:59-0300",
 	"quotaconsumed": 2.46531524,
 	"startdate": "2026-05-23T21:00:00-0300",
 	"tariffid": "2b9671f8-a0ec-4127-bcc8-69413375c3c6",
 	"tariffname": "RUNNING_VM"
       },
       ...
     ],
     "totalquota": 5.69112164,
     "unit": "Compute*Month",
     "usagename": "RUNNING_VM"
   }
 }

 (u1) 🐱 > quota resourcestatement id=e4e91818-cbb5-401a-bb42-35d976ea4e01 startdate=2026-01-01 enddate=2027-01-01 usagetype=1
 🙈 Error: (HTTP 531, error code 4365) Caller does not have permission to operate with provided resource.

accountid: returns the statement scoped to the provided account if accessible, or an empty list otherwise.

 (u1) 🐱 > quota resourcestatement id=53c791d2-ac8f-4acb-9246-3a2b9eb354ea startdate=2026-01-01 enddate=2027-01-01 usagetype=1 accountid=2f49212d-d6d5-437b-800d-a7bb4a8def4b (u1)
 {
   "quotaresourcestatement": {
     "items": [
       {
 	"accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
 	"enddate": "2026-05-24T20:59:59-0300",
 	"quotaconsumed": 2.46531524,
 	"startdate": "2026-05-23T21:00:00-0300",
 	"tariffid": "2b9671f8-a0ec-4127-bcc8-69413375c3c6",
 	"tariffname": "RUNNING_VM"
       },
       ...
     ],
     "totalquota": 5.69112164,
     "unit": "Compute*Month",
     "usagename": "RUNNING_VM"
   }
 }

 (u1) 🐱 > quota resourcestatement id=e4e91818-cbb5-401a-bb42-35d976ea4e01 startdate=2026-01-01 enddate=2027-01-01 usagetype=1 accountid=2f49212d-d6d5-437b-800d-a7bb4a8def4b (u1)
 {
   "quotaresourcestatement": {
     "items": [],
     "totalquota": 0,
     "unit": "Compute*Month",
     "usagename": "RUNNING_VM"
   }
 }

projectid: returns the statement scoped to the provided project if accessible, or an exception otherwise.

 (u1) 🐱 > quota resourcestatement id=6d7b3c73-7f06-4f23-9210-3af5889790d1 startdate=2026-01-01 enddate=2027-01-01 usagetype=1 projectid=c1ce41c4-7b01-4386-8264-479db5ace0bc
 🙈 Error: (HTTP 432, error code 9999) The API [quotaResourceStatement] does not exist or is not available for this account/user in project [c1ce41c4-7b01-4386-8264-479db5ace0bc].

 (ur) 🐱 > quota resourcestatement id=6d7b3c73-7f06-4f23-9210-3af5889790d1 startdate=2026-01-01 enddate=2027-01-01 usagetype=1 projectid=c1ce41c4-7b01-4386-8264-479db5ace0bc
 {
   "quotaresourcestatement": {
     "items": [
       {
 	"accountid": "b14100c6-d9f6-450e-87a2-0833bb45e5f8",
 	"enddate": "2026-05-21T20:59:59-0300",
 	"quotaconsumed": 1.42573923,
 	"startdate": "2026-05-20T21:00:00-0300",
 	"tariffid": "2b9671f8-a0ec-4127-bcc8-69413375c3c6",
 	"tariffname": "RUNNING_VM"
       },
       ...
     ],
     "totalquota": 22.20631686,
     "unit": "Compute*Month",
     "usagename": "RUNNING_VM"
   }
 }

isrecursive: ignored for user accounts.

 (ur) 🐱 > quota resourcestatement id=db0db635-df4d-42bb-9aca-19cc3d986ca0 startdate=2026-01-01 enddate=2027-01-01 usagetype=1 isrecursive=true
 {
   "quotaresourcestatement": {
     "items": [
       {
 	"accountid": "b029e8b8-e539-4d1a-906d-3d4f2fb36b82",
 	"enddate": "2026-05-24T20:59:59-0300",
 	"quotaconsumed": 2.46247754,
 	"startdate": "2026-05-23T21:00:00-0300",
 	"tariffid": "2b9671f8-a0ec-4127-bcc8-69413375c3c6",
 	"tariffname": "RUNNING_VM"
       },
       ...
     ],
     "totalquota": 18.9019186,
     "unit": "Compute*Month",
     "usagename": "RUNNING_VM"
   }
 }
 (ur) 🐱 > quota resourcestatement id=db0db635-df4d-42bb-9aca-19cc3d986ca0 startdate=2026-01-01 enddate=2027-01-01 usagetype=1 isrecursive=false
 {
   "quotaresourcestatement": {
     "items": [
       {
 	"accountid": "b029e8b8-e539-4d1a-906d-3d4f2fb36b82",
 	"enddate": "2026-05-24T20:59:59-0300",
 	"quotaconsumed": 2.46247754,
 	"startdate": "2026-05-23T21:00:00-0300",
 	"tariffid": "2b9671f8-a0ec-4127-bcc8-69413375c3c6",
 	"tariffname": "RUNNING_VM"
       },
       ...
     ],
     "totalquota": 18.9019186,
     "unit": "Compute*Month",
     "usagename": "RUNNING_VM"
   }
 }

Test 2 (domain admins)

id: returns the statement scoped to the caller's domain.

 (d1) 🐱 > quota resourcestatement id=53c791d2-ac8f-4acb-9246-3a2b9eb354ea startdate=2026-01-01 enddate=2027-01-01 usagetype=1
 {
   "quotaresourcestatement": {
     "items": [
       {
 	"accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
 	"enddate": "2026-05-24T20:59:59-0300",
 	"quotaconsumed": 2.46531524,
 	"startdate": "2026-05-23T21:00:00-0300",
 	"tariffid": "2b9671f8-a0ec-4127-bcc8-69413375c3c6",
 	"tariffname": "RUNNING_VM"
       },
       ...
     ],
     "totalquota": 14.60737768,
     "unit": "Compute*Month",
     "usagename": "RUNNING_VM"
   }
 }

 (d1) 🐱 > quota resourcestatement id=db0db635-df4d-42bb-9aca-19cc3d986ca0 startdate=2026-01-01 enddate=2027-01-01 usagetype=1
 {
   "quotaresourcestatement": {
     "items": [
       {
 	"accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
 	"enddate": "2026-05-21T20:59:59-0300",
 	"quotaconsumed": 1.42775528,
 	"startdate": "2026-05-20T21:00:00-0300",
 	"tariffid": "2b9671f8-a0ec-4127-bcc8-69413375c3c6",
 	"tariffname": "RUNNING_VM"
       },
       ...
     ],
     "totalquota": 25.15400928,
     "unit": "Compute*Month",
     "usagename": "RUNNING_VM"
   }
 }

 (d1) 🐱 > quota resourcestatement id=6d7b3c73-7f06-4f23-9210-3af5889790d1 startdate=2026-01-01 enddate=2027-01-01 usagetype=1
 {
   "quotaresourcestatement": {
     "items": [],
     "totalquota": 0,
     "unit": "Compute*Month",
     "usagename": "RUNNING_VM"
   }
 }

accountid: returns the statement scoped to the provided account if accessible, or an exception otherwise.

 (d1) 🐱 > quota resourcestatement id=53c791d2-ac8f-4acb-9246-3a2b9eb354ea startdate=2026-01-01 enddate=2027-01-01 usagetype=1 accountid=2f49212d-d6d5-437b-800d-a7bb4a8def4b
 {
   "quotaresourcestatement": {
     "items": [
       {
 	"accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
 	"enddate": "2026-05-24T20:59:59-0300",
 	"quotaconsumed": 2.46531524,
 	"startdate": "2026-05-23T21:00:00-0300",
 	"tariffid": "2b9671f8-a0ec-4127-bcc8-69413375c3c6",
 	"tariffname": "RUNNING_VM"
       },
       ...
     ],
     "totalquota": 11.44631141,
     "unit": "Compute*Month",
     "usagename": "RUNNING_VM"
   }
 }

 (d1) 🐱 > quota resourcestatement id=53c791d2-ac8f-4acb-9246-3a2b9eb354ea startdate=2026-01-01 enddate=2027-01-01 usagetype=1 accountid=feaffae2-7ba4-45dc-b46f-20ae86192685 
 {
   "quotaresourcestatement": {
     "items": [
       {
 	"accountid": "feaffae2-7ba4-45dc-b46f-20ae86192685",
 	"enddate": "2026-05-26T20:59:59-0300",
 	"quotaconsumed": 3.16106627,
 	"startdate": "2026-05-25T21:00:00-0300",
 	"tariffid": "2b9671f8-a0ec-4127-bcc8-69413375c3c6",
 	"tariffname": "RUNNING_VM"
       }
     ],
     "totalquota": 3.16106627,
     "unit": "Compute*Month",
     "usagename": "RUNNING_VM"
   }
 }

 (d1) 🐱 > quota resourcestatement id=53c791d2-ac8f-4acb-9246-3a2b9eb354ea startdate=2026-01-01 enddate=2027-01-01 usagetype=1 accountid=f684da1a-f84b-11f0-8ace-32e0826870ba
 🙈 Error: (HTTP 531, error code 4365) Caller does not have permission to operate with provided resource.

projectid: returns the statement scoped to the provided project if accessible, or an exception otherwise.

 (d1) 🐱 > quota resourcestatement id=6d7b3c73-7f06-4f23-9210-3af5889790d1 startdate=2026-01-01 enddate=2027-01-01 usagetype=1 projectid=c1ce41c4-7b01-4386-8264-479db5ace0bc
 🙈 Error: (HTTP 531, error code 4365) Account Account [{"accountName":"d1","id":5,"uuid":"feaffae2-7ba4-45dc-b46f-20ae86192685"}] does not have permission to operate within domain id=de3f3dfb-f84b-11f0-8ace-32e0826870ba

 (dr) 🐱 > quota resourcestatement id=6d7b3c73-7f06-4f23-9210-3af5889790d1 startdate=2026-01-01 enddate=2027-01-01 usagetype=1 projectid=c1ce41c4-7b01-4386-8264-479db5ace0bc
 {
   "quotaresourcestatement": {
     "items": [
       {
 	"accountid": "b14100c6-d9f6-450e-87a2-0833bb45e5f8",
 	"enddate": "2026-05-21T20:59:59-0300",
 	"quotaconsumed": 1.42573923,
 	"startdate": "2026-05-20T21:00:00-0300",
 	"tariffid": "2b9671f8-a0ec-4127-bcc8-69413375c3c6",
 	"tariffname": "RUNNING_VM"
       },
       ...
     ],
     "totalquota": 39.76108809,
     "unit": "Compute*Month",
     "usagename": "RUNNING_VM"
   }
 }

isrecursive: allows domain admins to generate the statement including usage records of subdomains.

 (dr) 🐱 > quota resourcestatement id=e4e91818-cbb5-401a-bb42-35d976ea4e01 startdate=2026-01-01 enddate=2027-01-01 usagetype=1 isrecursive=true
 {
   "quotaresourcestatement": {
     "items": [
       {
 	"accountid": "f684da1a-f84b-11f0-8ace-32e0826870ba",
 	"enddate": "2026-05-21T20:59:59-0300",
 	"quotaconsumed": 1.42880073,
 	"startdate": "2026-05-20T21:00:00-0300",
 	"tariffid": "2b9671f8-a0ec-4127-bcc8-69413375c3c6",
 	"tariffname": "RUNNING_VM"
       },
       ...
     ],
     "totalquota": 52.70616739,
     "unit": "Compute*Month",
     "usagename": "RUNNING_VM"
   }
 }
 (dr) 🐱 > quota resourcestatement id=e4e91818-cbb5-401a-bb42-35d976ea4e01 startdate=2026-01-01 enddate=2027-01-01 usagetype=1 isrecursive=false
 {
   "quotaresourcestatement": {
     "items": [
       {
 	"accountid": "f684da1a-f84b-11f0-8ace-32e0826870ba",
 	"enddate": "2026-05-21T20:59:59-0300",
 	"quotaconsumed": 1.42880073,
 	"startdate": "2026-05-20T21:00:00-0300",
 	"tariffid": "2b9671f8-a0ec-4127-bcc8-69413375c3c6",
 	"tariffname": "RUNNING_VM"
       },
       ...
     ],
     "totalquota": 33.79573569,
     "unit": "Compute*Month",
     "usagename": "RUNNING_VM"
   }
 }

Test 3 (root admins)

id: returns the statement of any resource without limiting.

 (admin) 🐱 > quota resourcestatement id=e4e91818-cbb5-401a-bb42-35d976ea4e01 startdate=2026-01-01 enddate=2027-01-01 usagetype=1
 {
   "quotaresourcestatement": {
     "items": [
       {
 	"accountid": "f684da1a-f84b-11f0-8ace-32e0826870ba",
 	"enddate": "2026-05-21T20:59:59-0300",
 	"quotaconsumed": 1.42880073,
 	"startdate": "2026-05-20T21:00:00-0300",
 	"tariffid": "2b9671f8-a0ec-4127-bcc8-69413375c3c6",
 	"tariffname": "RUNNING_VM"
       },
       ...
     ],
     "totalquota": 39.76534465,
     "unit": "Compute*Month",
     "usagename": "RUNNING_VM"
   }
 }
 (admin) 🐱 > quota resourcestatement id=ab6b1ced-d36e-4436-aad2-e78e06005350 startdate=2026-01-01 enddate=2027-01-01 usagetype=1
 {
   "quotaresourcestatement": {
     "items": [
       {
 	"accountid": "feaffae2-7ba4-45dc-b46f-20ae86192685",
 	"enddate": "2026-05-21T20:59:59-0300",
 	"quotaconsumed": 1.42801677,
 	"startdate": "2026-05-20T21:00:00-0300",
 	"tariffid": "2b9671f8-a0ec-4127-bcc8-69413375c3c6",
 	"tariffname": "RUNNING_VM"
       },
       ...
     ],
     "totalquota": 39.76291791,
     "unit": "Compute*Month",
     "usagename": "RUNNING_VM"
   }
 }
 (admin) 🐱 > quota resourcestatement id=db0db635-df4d-42bb-9aca-19cc3d986ca0 startdate=2026-01-01 enddate=2027-01-01 usagetype=1
 {
   "quotaresourcestatement": {
     "items": [
       {
 	"accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
 	"enddate": "2026-05-21T20:59:59-0300",
 	"quotaconsumed": 1.42775528,
 	"startdate": "2026-05-20T21:00:00-0300",
 	"tariffid": "2b9671f8-a0ec-4127-bcc8-69413375c3c6",
 	"tariffname": "RUNNING_VM"
       },
       ...
     ],
     "totalquota": 39.75638356,
     "unit": "Compute*Month",
     "usagename": "RUNNING_VM"
   }
 }
 (admin) 🐱 > quota resourcestatement id=53c791d2-ac8f-4acb-9246-3a2b9eb354ea startdate=2026-01-01 enddate=2027-01-01 usagetype=1
 {
   "quotaresourcestatement": {
     "items": [
       {
 	"accountid": "b029e8b8-e539-4d1a-906d-3d4f2fb36b82",
 	"enddate": "2026-05-21T20:59:59-0300",
 	"quotaconsumed": 1.42670996,
 	"startdate": "2026-05-20T21:00:00-0300",
 	"tariffid": "2b9671f8-a0ec-4127-bcc8-69413375c3c6",
 	"tariffname": "RUNNING_VM"
       },
       ...
     ],
     "totalquota": 39.7583256,
     "unit": "Compute*Month",
     "usagename": "RUNNING_VM"
   }
 }

accountid: returns the statement scoped to the provided account.

 (admin) 🐱 > quota resourcestatement id=53c791d2-ac8f-4acb-9246-3a2b9eb354ea startdate=2026-01-01 enddate=2027-01-01 usagetype=1 accountid=2f49212d-d6d5-437b-800d-a7bb4a8def4b
 {
   "quotaresourcestatement": {
     "items": [
       {
 	"accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
 	"enddate": "2026-05-24T20:59:59-0300",
 	"quotaconsumed": 2.46531524,
 	"startdate": "2026-05-23T21:00:00-0300",
 	"tariffid": "2b9671f8-a0ec-4127-bcc8-69413375c3c6",
 	"tariffname": "RUNNING_VM"
       },
       ...
     ],
     "totalquota": 11.44631141,
     "unit": "Compute*Month",
     "usagename": "RUNNING_VM"
   }
 }

 (admin) 🐱 > quota resourcestatement id=53c791d2-ac8f-4acb-9246-3a2b9eb354ea startdate=2026-01-01 enddate=2027-01-01 usagetype=1 accountid=feaffae2-7ba4-45dc-b46f-20ae86192685
 {
   "quotaresourcestatement": {
     "items": [
       {
 	"accountid": "feaffae2-7ba4-45dc-b46f-20ae86192685",
 	"enddate": "2026-05-26T20:59:59-0300",
 	"quotaconsumed": 3.16106627,
 	"startdate": "2026-05-25T21:00:00-0300",
 	"tariffid": "2b9671f8-a0ec-4127-bcc8-69413375c3c6",
 	"tariffname": "RUNNING_VM"
       }
     ],
     "totalquota": 3.16106627,
     "unit": "Compute*Month",
     "usagename": "RUNNING_VM"
   }
 }

 (admin) 🐱 > quota resourcestatement id=53c791d2-ac8f-4acb-9246-3a2b9eb354ea startdate=2026-01-01 enddate=2027-01-01 usagetype=1 accountid=f684da1a-f84b-11f0-8ace-32e0826870ba
 {
   "quotaresourcestatement": {
     "items": [],
     "totalquota": 0,
     "unit": "Compute*Month",
     "usagename": "RUNNING_VM"
   }
 }

projectid: returns the statement scoped to the provided project.

 (admin) 🐱 > quota resourcestatement id=6d7b3c73-7f06-4f23-9210-3af5889790d1 startdate=2026-01-01 enddate=2027-01-01 usagetype=1 projectid=c1ce41c4-7b01-4386-8264-479db5ace0bc
 {
   "quotaresourcestatement": {
     "items": [
       {
 	"accountid": "b14100c6-d9f6-450e-87a2-0833bb45e5f8",
 	"enddate": "2026-05-21T20:59:59-0300",
 	"quotaconsumed": 1.42573923,
 	"startdate": "2026-05-20T21:00:00-0300",
 	"tariffid": "2b9671f8-a0ec-4127-bcc8-69413375c3c6",
 	"tariffname": "RUNNING_VM"
       },
       ...
     ],
     "totalquota": 39.76108809,
     "unit": "Compute*Month",
     "usagename": "RUNNING_VM"
   }
 }

isrecursive: allows admins to generate the statement including usage records of subdomains.

 (admin) 🐱 > quota resourcestatement id=e4e91818-cbb5-401a-bb42-35d976ea4e01 startdate=2026-01-01 enddate=2027-01-01 usagetype=1
 {
   "quotaresourcestatement": {
     "items": [
       {
 	"accountid": "f684da1a-f84b-11f0-8ace-32e0826870ba",
 	"enddate": "2026-05-21T20:59:59-0300",
 	"quotaconsumed": 1.42880073,
 	"startdate": "2026-05-20T21:00:00-0300",
 	"tariffid": "2b9671f8-a0ec-4127-bcc8-69413375c3c6",
 	"tariffname": "RUNNING_VM"
       },
       ...
     ],
     "totalquota": 33.79573569,
     "unit": "Compute*Month",
     "usagename": "RUNNING_VM"
   }
 }
 (admin) 🐱 > quota resourcestatement id=e4e91818-cbb5-401a-bb42-35d976ea4e01 startdate=2026-01-01 enddate=2027-01-01 usagetype=1 isrecursive=true
 {
   "quotaresourcestatement": {
     "items": [
       {
 	"accountid": "f684da1a-f84b-11f0-8ace-32e0826870ba",
 	"enddate": "2026-05-21T20:59:59-0300",
 	"quotaconsumed": 1.42880073,
 	"startdate": "2026-05-20T21:00:00-0300",
 	"tariffid": "2b9671f8-a0ec-4127-bcc8-69413375c3c6",
 	"tariffname": "RUNNING_VM"
       },
       ...
     ],
     "totalquota": 52.70616739,
     "unit": "Compute*Month",
     "usagename": "RUNNING_VM"
   }
 }
 (admin) 🐱 > quota resourcestatement id=e4e91818-cbb5-401a-bb42-35d976ea4e01 startdate=2026-01-01 enddate=2027-01-01 usagetype=1 isrecursive=false
 {
   "quotaresourcestatement": {
     "items": [
       {
 	"accountid": "f684da1a-f84b-11f0-8ace-32e0826870ba",
 	"enddate": "2026-05-21T20:59:59-0300",
 	"quotaconsumed": 1.42880073,
 	"startdate": "2026-05-20T21:00:00-0300",
 	"tariffid": "2b9671f8-a0ec-4127-bcc8-69413375c3c6",
 	"tariffname": "RUNNING_VM"
       },
       ...
     ],
     "totalquota": 33.79573569,
     "unit": "Compute*Month",
     "usagename": "RUNNING_VM"
   }
 }

@blueorangutan package

Codecov Report

❌ Patch coverage is 37.96610% with 183 lines in your changes missing coverage. Please review.
✅ Project coverage is 18.77%. Comparing base (6bc83a3) to head (511d107).
⚠️ Report is 2 commits behind head on main.

Files with missing lines	Patch %	Lines
...udstack/api/response/QuotaResponseBuilderImpl.java	33.58%	86 Missing and 1 partial ⚠️
...udstack/api/command/QuotaResourceStatementCmd.java	0.00%	32 Missing ⚠️
...i/response/QuotaResourceStatementItemResponse.java	0.00%	21 Missing ⚠️
.../org/apache/cloudstack/quota/QuotaManagerImpl.java	66.00%	16 Missing and 1 partial ⚠️
...k/api/response/QuotaResourceStatementResponse.java	0.00%	15 Missing ⚠️
...he/cloudstack/quota/dao/QuotaUsageJoinDaoImpl.java	0.00%	4 Missing ⚠️
...g/apache/cloudstack/quota/constant/QuotaTypes.java	91.42%	3 Missing ⚠️
...ache/cloudstack/api/command/QuotaStatementCmd.java	0.00%	3 Missing ⚠️
.../org/apache/cloudstack/quota/QuotaServiceImpl.java	75.00%	1 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff              @@
##               main   #13236      +/-   ##
============================================
+ Coverage     18.75%   18.77%   +0.01%     
- Complexity    17966    17983      +17     
============================================
  Files          6160     6163       +3     
  Lines        552578   552779     +201     
  Branches      67348    67365      +17     
============================================
+ Hits         103660   103758      +98     
- Misses       437512   437611      +99     
- Partials      11406    11410       +4

Flag	Coverage Δ
uitests	3.53% <ø> (ø)
unittests	19.96% <37.96%> (+0.01%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@blueorangutan package

@DaanHoogland a [SL] Jenkins job has been kicked to build packages. It will be bundled with no SystemVM templates. I'll keep you posted as I make progress.

Packaging result [SF]: ✔️ el8 ✔️ el9 ✔️ el10 ✔️ debian ✔️ suse15. SL-JID 18042

@blueorangutan test

@DaanHoogland a [SL] Trillian-Jenkins test job (ol8 mgmt + kvm-ol8) has been kicked to run smoke tests

[SF] Trillian test result (tid-16186)
Environment: kvm-ol8 (x2), zone: Advanced Networking with Mgmt server ol8
Total time taken: 55395 seconds
Marvin logs: https://github.com/blueorangutan/acs-prs/releases/download/trillian/pr13236-t16186-kvm-ol8.zip
Smoke tests completed. 151 look OK, 0 have errors, 0 did not run
Only failed and skipped tests results shown below:

Test	Result	Time (s)	Test File

@winterhazel , I can review, but you probably have someone more knowledgeable to look at this...

@winterhazel , I can review, but you probably have someone more knowledgeable to look at this...

@DaanHoogland I already asked some people that are familiar with Quota to review this one, but feel free to review as well if you want to. Your reviews would still be appreciated :)

@blueorangutan package

@winterhazel a [SL] Jenkins job has been kicked to build packages. It will be bundled with no SystemVM templates. I'll keep you posted as I make progress.

@blueorangutan package

@winterhazel a [SL] Jenkins job has been kicked to build packages. It will be bundled with no SystemVM templates. I'll keep you posted as I make progress.

Packaging result [SF]: ✔️ el8 ✔️ el9 ✔️ el10 ✔️ debian ✔️ suse15. SL-JID 18196

LGTM, but I haven't been able to test this version yet. I'll try doing it soon.

@DaanHoogland @weizhouapache @sureshanaparti @Pearl1594 can we run the CI here?

@blueorangutan test

@Pearl1594 a [SL] Trillian-Jenkins test job (ol8 mgmt + kvm-ol8) has been kicked to run smoke tests

CLGMT, will test it locally.

[SF] Trillian test result (tid-16283)
Environment: kvm-ol8 (x2), zone: Advanced Networking with Mgmt server ol8
Total time taken: 53597 seconds
Marvin logs: https://github.com/blueorangutan/acs-prs/releases/download/trillian/pr13236-t16283-kvm-ol8.zip
Smoke tests completed. 151 look OK, 0 have errors, 0 did not run
Only failed and skipped tests results shown below:

Test	Result	Time (s)	Test File

@blueorangutan package

@winterhazel a [SL] Jenkins job has been kicked to build packages. It will be bundled with no SystemVM templates. I'll keep you posted as I make progress.

LGTM. Everything works fine, simulated regular API usages, and did some fuzzing as well.

Packaging result [SF]: ✔️ el8 ✔️ el9 ✔️ el10 ✔️ debian ✔️ suse15. SL-JID 18229

@Pearl1594 also asking to run the CI here one last time before the merge :)

@blueorangutan test

@Pearl1594 a [SL] Trillian-Jenkins test job (ol8 mgmt + kvm-ol8) has been kicked to run smoke tests

code lgtm, did not test it

[SF] Trillian test result (tid-16289)
Environment: kvm-ol8 (x2), zone: Advanced Networking with Mgmt server ol8
Total time taken: 52925 seconds
Marvin logs: https://github.com/blueorangutan/acs-prs/releases/download/trillian/pr13236-t16289-kvm-ol8.zip
Smoke tests completed. 150 look OK, 1 have errors, 0 did not run
Only failed and skipped tests results shown below:

Test	Result	Time (s)	Test File
test_router_dhcphosts	Failure	21.20	test_router_dhcphosts.py

Test failures are unrelated, so merging

(cherry picked from commit 2fd83e1)

winterhazel added 2 commits May 25, 2026 14:49

Introduce Quota resource statement API

af17bc9

Merge remote-tracking branch 'origin/main' into quota-statement-details

12ef94b

boring-cyborg Bot added component:api component:quota labels May 25, 2026

winterhazel requested a review from bernardodemarco May 25, 2026 18:28

winterhazel assigned gp-santos, JoaoJandre and erikbocks May 25, 2026

winterhazel unassigned gp-santos, JoaoJandre and erikbocks May 25, 2026

winterhazel requested review from JoaoJandre, erikbocks and gp-santos May 25, 2026 18:29

Fix pre-commit

b0ba9a1

Add additional unit tests

d6e7a9f

GaOrtiga reviewed May 27, 2026

View reviewed changes

Comment thread framework/quota/src/main/java/org/apache/cloudstack/quota/QuotaManagerImpl.java Resolved

Persist all Quota usage related entries inside the same transaction

f3feb29

github-actions Bot mentioned this pull request Jun 8, 2026

[repo-status] Daily Status Report – June 8, 2026 #13381

Closed

gp-santos reviewed Jun 10, 2026

View reviewed changes

erikbocks reviewed Jun 11, 2026

View reviewed changes

Comment thread ...atabase/quota/src/main/java/org/apache/cloudstack/api/response/QuotaResponseBuilderImpl.java Resolved

Convert if to else

511d107

erikbocks approved these changes Jun 11, 2026

View reviewed changes

github-actions Bot mentioned this pull request Jun 11, 2026

[repo-status] Daily Status Report — June 11, 2026 #13405

Closed

bernardodemarco approved these changes Jun 11, 2026

View reviewed changes

winterhazel merged commit 2fd83e1 into apache:main Jun 12, 2026
25 of 27 checks passed

winterhazel mentioned this pull request Jun 18, 2026

Quota UI rework #13449

Merged

5 of 9 tasks

winterhazel mentioned this pull request Jul 16, 2026

Add new Quota Plugin documentation apache/cloudstack-documentation#668

Merged

dhslove pushed a commit to ablecloud-team/ablestack-cloud that referenced this pull request Sep 10, 2026

Introduce Quota resource statement API (apache#13236 )

6a8e765

(cherry picked from commit 2fd83e1)

Introduce Quota resource statement API by winterhazel · Pull Request #13236 · apache/cloudstack · GitHub

Repository navigation

Introduce Quota resource statement API - #13236

Introduce Quota resource statement API#13236winterhazel merged 8 commits intoapache:mainapache/cloudstack:mainfrom scclouds:quota-statement-detailsscclouds/cloudstack:quota-statement-detailsCopy head branch name to clipboard

Conversation

winterhazel commented May 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Types of changes

Feature/Enhancement Scale or Bug Severity

Feature/Enhancement Scale

How Has This Been Tested?

Environment configuration

Test 1 (user accounts)

Test 2 (domain admins)

Test 3 (root admins)

Uh oh!

winterhazel commented May 25, 2026

Uh oh!

codecov Bot commented May 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

DaanHoogland commented May 26, 2026

Uh oh!

blueorangutan commented May 26, 2026

Uh oh!

blueorangutan commented May 26, 2026

Uh oh!

DaanHoogland commented May 26, 2026

Uh oh!

blueorangutan commented May 26, 2026

Uh oh!

blueorangutan commented May 27, 2026

Uh oh!

DaanHoogland commented May 27, 2026

Uh oh!

winterhazel commented May 27, 2026

Uh oh!

Uh oh!

winterhazel commented May 27, 2026

Uh oh!

blueorangutan commented May 27, 2026

Uh oh!

winterhazel commented Jun 8, 2026

Uh oh!

blueorangutan commented Jun 8, 2026

Uh oh!

blueorangutan commented Jun 8, 2026

Uh oh!

gp-santos left a comment

Choose a reason for hiding this comment

Uh oh!

winterhazel commented Jun 10, 2026

Uh oh!

Pearl1594 commented Jun 10, 2026

Uh oh!

blueorangutan commented Jun 10, 2026

Uh oh!

erikbocks left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

blueorangutan commented Jun 11, 2026

Uh oh!

winterhazel commented Jun 11, 2026

Uh oh!

blueorangutan commented Jun 11, 2026

Uh oh!

erikbocks left a comment

Choose a reason for hiding this comment

Uh oh!

blueorangutan commented Jun 11, 2026

Uh oh!

winterhazel commented Jun 11, 2026

Uh oh!

Pearl1594 commented Jun 11, 2026

Uh oh!

blueorangutan commented Jun 11, 2026

Uh oh!

Introduce Quota resource statement API#13236
winterhazel merged 8 commits into
apache:mainfrom
scclouds:quota-statement-details

winterhazel commented May 25, 2026 •
edited
Loading

codecov Bot commented May 25, 2026 •
edited
Loading