Skip to content

Improve Quota Statement - #10506

Merged
winterhazel merged 13 commits into
apache:mainfrom
scclouds:improve-quota-statement
Apr 30, 2026
Merged

Improve Quota Statement#10506
winterhazel merged 13 commits into
apache:mainfrom
scclouds:improve-quota-statement

Conversation

@julien-vaz

Copy link
Copy Markdown
Contributor

Description

In the current version, the quotaStatement API is returning the internal ID for account and domain, which is not useful for users, since all APIs use/return the UUID. Also, when the usage_type parameter is informed, the API shows dummy records.

To address those problems:

  • the API was modified so it returns the resources' UUID;
  • the dummy records bug was fixed;
  • a new parameter showresources was added to display more information to the user about each usage type;
  • a new quotaStatementDetails API was created to list more details about each usage type;

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?

On CloudMonkey the quotaStatement API was called and:

  • the resources' UUID was returned instead of the internal ID;
  • when specified a usage_type no dummy records were showed;
  • the showresources parameter is properly working;

The quotaStatementDetails API was called successfully as well.

@julien-vaz

Copy link
Copy Markdown
ContributorAuthor

@blueorangutan package

@blueorangutan

Copy link
Copy Markdown

@julien-vaz a [SL] Jenkins job has been kicked to build packages. It will be bundled with KVM, XenServer and VMware SystemVM templates. I'll keep you posted as I make progress.

@blueorangutan

Copy link
Copy Markdown

Packaging result [SF]: ✖️ el8 ✖️ el9 ✖️ debian ✖️ suse15. SL-JID 12669

@codecov

codecovBot commented Mar 5, 2025

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 21.37592% with 320 lines in your changes missing coverage. Please review.
✅ Project coverage is 18.02%. Comparing base (3166e64) to head (1f39686).
⚠️ Report is 9 commits behind head on main.

Files with missing linesPatch %Lines
...udstack/api/response/QuotaResponseBuilderImpl.java31.61%105 Missing and 1 partial ⚠️
...g/apache/cloudstack/quota/vo/QuotaUsageJoinVO.java27.90%62 Missing ⚠️
...he/cloudstack/quota/dao/QuotaUsageJoinDaoImpl.java0.00%37 Missing ⚠️
...apache/cloudstack/quota/vo/QuotaTariffUsageVO.java0.00%31 Missing ⚠️
...ache/cloudstack/quota/vo/QuotaUsageResourceVO.java0.00%27 Missing ⚠️
...ache/cloudstack/api/command/QuotaStatementCmd.java15.78%16 Missing ⚠️
.../cloudstack/quota/dao/QuotaTariffUsageDaoImpl.java0.00%15 Missing ⚠️
...i/response/QuotaStatementItemResourceResponse.java0.00%13 Missing ⚠️
...loudstack/api/response/QuotaStatementResponse.java36.36%7 Missing ⚠️
...c/main/java/com/cloud/utils/db/SearchCriteria.java0.00%4 Missing ⚠️
... and 1 more
Additional details and impacted files
@@ Coverage Diff @@## main #10506 +/- ##
============================================
+ Coverage 18.01% 18.02% +0.01% - Complexity 16607 16628 +21 
============================================
Files 6029 6035 +6 Lines 542160 542444 +284 Branches 66451 66473 +22 ============================================
+ Hits 97682 97790 +108 - Misses 433461 433642 +181 + Partials 11017 11012 -5 
FlagCoverage Δ
uitests3.52% <ø> (ø)
unittests19.18% <21.37%> (+0.01%)⬆️

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

☔ View full report in Codecov by Sentry.
📢 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.

@winterhazel
winterhazel self-requested a review March 6, 2025 13:06
@julien-vaz

Copy link
Copy Markdown
ContributorAuthor

@blueorangutan package

@blueorangutan

Copy link
Copy Markdown

@julien-vaz a [SL] Jenkins job has been kicked to build packages. It will be bundled with KVM, XenServer and VMware SystemVM templates. I'll keep you posted as I make progress.

@blueorangutan

Copy link
Copy Markdown

Packaging result [SF]: ✖️ el8 ✖️ el9 ✖️ debian ✖️ suse15. SL-JID 12689

@julien-vaz

Copy link
Copy Markdown
ContributorAuthor

I've just successfully builded the packages locally with -Dnoredist. Therefore, I'm requesting the package building again

@julien-vaz

Copy link
Copy Markdown
ContributorAuthor

@blueorangutan package

@blueorangutan

Copy link
Copy Markdown

@julien-vaz a [SL] Jenkins job has been kicked to build packages. It will be bundled with KVM, XenServer and VMware SystemVM templates. I'll keep you posted as I make progress.

@blueorangutan

Copy link
Copy Markdown

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

@lucas-a-martinslucas-a-martins left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

CLGTM

@DaanHooglandDaanHoogland left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

clgtm

@bernardodemarco
bernardodemarco self-requested a review June 4, 2025 17:38
@sureshanaparti

Copy link
Copy Markdown
Contributor

@blueorangutan package

@blueorangutan

Copy link
Copy Markdown

@sureshanaparti a [SL] Jenkins job has been kicked to build packages. It will be bundled with KVM, XenServer and VMware SystemVM templates. I'll keep you posted as I make progress.

@github-actions

Copy link
Copy Markdown

This pull request has merge conflicts. Dear author, please fix the conflicts and sync your branch with the base branch.

@DaanHoogland

Copy link
Copy Markdown
Contributor

@blueorangutan package

@blueorangutan

Copy link
Copy Markdown

@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.

@blueorangutan

Copy link
Copy Markdown

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

@winterhazel

Copy link
Copy Markdown
Member

@blueorangutan package

@winterhazelwinterhazel left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tested the API's parameters (account, accountid, domainid, enddate, projectid, showresources, startdate, type) 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. The same environment from #10505 (comment) was used.


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)

  • startdate and enddate only: returns only the user account's own statement.

     (u1) 🐱 > quota statement startdate=2025-03-01 enddate=2027-03-02
    {
    "statement": {
    "account": "u1",
    "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
    "currency": "$",
    "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 1.1714893,
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 23.43302496,
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2025-03-01T00:00:00-0300",
    "totalquota": 24.60451426
    }
    }
  • account: allows generating their own statement, but not the statement of other accounts.

     (u1) 🐱 > quota statement account=u1 domainid=dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d startdate=2026-03-01 enddate=2027-03-02
    {
    "statement": {
    "account": "u1",
    "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
    "currency": "$",
    "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 1.1714893,
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 23.43302496,
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 24.60451426
    }
    }
    (u1) 🐱 > quota statement account=d1 domainid=dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d startdate=2026-03-01 enddate=2027-03-02
    🙈 Error: (HTTP 531, error code 4365) Caller does not have permission to operate with provided resource.
  • accountid: allows generating their own statement, but not the statement of other accounts.

     (u1) 🐱 > quota statement accountid=2f49212d-d6d5-437b-800d-a7bb4a8def4b startdate=2026-03-01 enddate=2027-03-02
    {
    "statement": {
    "account": "u1",
    "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
    "currency": "$",
    "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 1.1714893,
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 23.43302496,
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 24.60451426
    }
    }
    (u1) 🐱 > quota statement accountid=aaba75a0-a575-41be-80e1-dbea14c10e51 startdate=2026-03-01 enddate=2027-03-02
    🙈 Error: (HTTP 531, error code 4365) Caller does not have permission to operate with provided resource.
  • domainid: only generates their own statement. Returns an error when specifying a domain they do not belong to.

     (u1) 🐱 > quota statement domainid=dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d startdate=2026-03-01 enddate=2027-03-02
    {
    "statement": {
    "account": "u1",
    "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
    "currency": "$",
    "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 1.1714893,
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 23.43302496,
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 24.60451426
    }
    }
    (u1) 🐱 > quota statement domainid=de3f3dfb-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02
    🙈 Error: (HTTP 531, error code 4365) Account Account [{"accountName":"u1","id":6,"uuid":"2f49212d-d6d5-437b-800d-a7bb4a8def4b"}] does not have permission to operate within domain id=de3f3dfb-f84b-11f0-8ace-32e0826870ba
  • showresources: lists the resources of each quota type in the period when set to true.

     (u1) 🐱 > quota statement startdate=2026-03-01 enddate=2027-03-02 showresources=true
    {
    "statement": {
    "account": "u1",
    "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
    "currency": "$",
    "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "resources": [
    {
    "displayname": "VM-91c1a276-e8a9-4fe9-bf93-905d84428b9a",
    "quotaconsumed": 0,
    "removed": false,
    "resourceid": "91c1a276-e8a9-4fe9-bf93-905d84428b9a"
    }
    ],
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 1.1714893,
    "resources": [
    {
    "displayname": "VM-91c1a276-e8a9-4fe9-bf93-905d84428b9a",
    "quotaconsumed": 1.1714893,
    "removed": false,
    "resourceid": "91c1a276-e8a9-4fe9-bf93-905d84428b9a"
    }
    ],
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "resources": [],
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "resources": [],
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "resources": [],
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "resources": [
    {
    "displayname": "ROOT-9",
    "quotaconsumed": 0,
    "removed": false,
    "resourceid": "d32f9ae3-c088-4f14-a15e-d2dcb0e53e98"
    }
    ],
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "resources": [],
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "resources": [],
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "resources": [],
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "resources": [],
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "resources": [],
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "resources": [],
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "resources": [
    {
    "displayname": "DefaultL2NetworkOffering",
    "quotaconsumed": 0,
    "removed": false,
    "resourceid": "d5090e0b-a8ec-4435-973f-8af355faaa25"
    }
    ],
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "resources": [],
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "resources": [],
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "resources": [],
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "resources": [],
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "resources": [],
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "resources": [],
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "resources": [],
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "resources": [],
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "resources": [],
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "resources": [],
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 23.43302496,
    "resources": [
    {
    "displayname": "<untraceable>",
    "quotaconsumed": 23.43302496,
    "removed": false
    }
    ],
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "resources": [],
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 24.60451426
    }
    }
    (u1) 🐱 > quota statement startdate=2026-03-01 enddate=2027-03-02 showresources=false
    {
    "statement": {
    "account": "u1",
    "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
    "currency": "$",
    "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 1.1714893,
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 23.43302496,
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 24.60451426
    }
    }
  • type: filters the statement to only include usage records for the specified usage type.

     (u1) 🐱 > quota statement startdate=2026-03-01 enddate=2027-03-02 type=1
    {
    "statement": {
    "account": "u1",
    "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
    "currency": "$",
    "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 0
    }
    }
    (u1) 🐱 > quota statement startdate=2026-03-01 enddate=2027-03-02 type=1 showresources=true
    {
    "statement": {
    "account": "u1",
    "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
    "currency": "$",
    "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "resources": [
    {
    "displayname": "VM-91c1a276-e8a9-4fe9-bf93-905d84428b9a",
    "quotaconsumed": 0,
    "removed": false,
    "resourceid": "91c1a276-e8a9-4fe9-bf93-905d84428b9a"
    }
    ],
    "type": 1,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 0
    }
    }
  • projectid: user accounts can only obtain statements for projects they belong to.

     (u1) 🐱 > quota statement projectid=c1ce41c4-7b01-4386-8264-479db5ace0bc startdate=2026-03-01 enddate=2027-03-02
    🙈 Error: (HTTP 432, error code 9999) The API [quotaStatement] does not exist or is not available forthis account/userin project [c1ce41c4-7b01-4386-8264-479db5ace0bc].
    (ur) 🐱 > quota statement projectid=c1ce41c4-7b01-4386-8264-479db5ace0bc startdate=2026-03-01 enddate=2027-03-02
    {
    "statement": {
    "account": "ur",
    "accountid": "b029e8b8-e539-4d1a-906d-3d4f2fb36b82",
    "currency": "$",
    "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 0,
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 0,
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 0
    }
    }

Test 2 (domain admins)

  • startdate and enddate only: returns only their own statement.

     (d1) 🐱 > quota statement startdate=2026-03-01 enddate=2027-03-02
    {
    "statement": {
    "account": "d1",
    "accountid": "feaffae2-7ba4-45dc-b46f-20ae86192685",
    "currency": "$",
    "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 0.32591051,
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 6.51882704,
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 6.84473755
    }
    }
  • account: allows generating statements for accounts belonging to their domain, but not for accounts from other domains.

     (d1) 🐱 > quota statement account=u1 domainid=dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d startdate=2026-03-01 enddate=2027-03-02
    {
    "statement": {
    "account": "u1",
    "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
    "currency": "$",
    "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 1.93128489,
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 45.14953752,
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 47.08082241
    }
    }
    (d1) 🐱 > quota statement account=d1 domainid=dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d startdate=2026-03-01 enddate=2027-03-02
    {
    "statement": {
    "account": "d1",
    "accountid": "feaffae2-7ba4-45dc-b46f-20ae86192685",
    "currency": "$",
    "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 0.32591051,
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 6.51882704,
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 6.84473755
    }
    }
    (d1) 🐱 > quota statement account=admin domainid=de3f3dfb-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02
    🙈 Error: (HTTP 531, error code 4365) Caller does not have permission to operate with provided resource
    
  • accountid: allows generating statements for accounts belonging to their domain, but not for accounts from other domains.

     (d1) 🐱 > quota statement accountid=2f49212d-d6d5-437b-800d-a7bb4a8def4b startdate=2026-03-01 enddate=2027-03-02
    {
    "statement": {
    "account": "u1",
    "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
    "currency": "$",
    "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 1.93128489,
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 45.14953752,
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 47.08082241
    }
    }
    (d1) 🐱 > quota statement accountid=feaffae2-7ba4-45dc-b46f-20ae86192685 startdate=2026-03-01 enddate=2027-03-02
    {
    "statement": {
    "account": "d1",
    "accountid": "feaffae2-7ba4-45dc-b46f-20ae86192685",
    "currency": "$",
    "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 0.32591051,
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 6.51882704,
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 6.84473755
    }
    }
    (d1) 🐱 > quota statement accountid=f684da1a-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02
    🙈 Error: (HTTP 531, error code 4365) Caller does not have permission to operate with provided resource.
  • domainid: allows generating statements for all accounts in their domain, but returns an error for domains outside their scope.

     (d1) 🐱 > quota statement domainid=dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d startdate=2026-03-01 enddate=2027-03-02
    {
    "statement": {
    "currency": "$",
    "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 2.2571954,
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 51.66836456,
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 53.92555996
    }
    }
    (d1) 🐱 > quota statement domainid=de3f3dfb-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02
    🙈 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
  • showresources: lists the resources of each quota type in the period when set to true.

     (d1) 🐱 > quota statement accountid=2f49212d-d6d5-437b-800d-a7bb4a8def4b startdate=2026-03-01 enddate=2027-03-02 showresources=true
    {
    "statement": {
    "account": "u1",
    "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
    "currency": "$",
    "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "resources": [
    {
    "displayname": "VM-91c1a276-e8a9-4fe9-bf93-905d84428b9a",
    "quotaconsumed": 0,
    "removed": true,
    "resourceid": "91c1a276-e8a9-4fe9-bf93-905d84428b9a"
    }
    ],
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 1.93128489,
    "resources": [
    {
    "displayname": "VM-91c1a276-e8a9-4fe9-bf93-905d84428b9a",
    "quotaconsumed": 1.93128489,
    "removed": true,
    "resourceid": "91c1a276-e8a9-4fe9-bf93-905d84428b9a"
    }
    ],
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "resources": [],
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "resources": [],
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "resources": [],
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "resources": [
    {
    "displayname": "ROOT-9",
    "quotaconsumed": 0,
    "removed": true,
    "resourceid": "d32f9ae3-c088-4f14-a15e-d2dcb0e53e98"
    }
    ],
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "resources": [],
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "resources": [],
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "resources": [],
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "resources": [],
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "resources": [],
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "resources": [],
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "resources": [
    {
    "displayname": "DefaultL2NetworkOffering",
    "quotaconsumed": 0,
    "removed": false,
    "resourceid": "d5090e0b-a8ec-4435-973f-8af355faaa25"
    }
    ],
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "resources": [],
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "resources": [],
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "resources": [],
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "resources": [],
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "resources": [],
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "resources": [],
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "resources": [],
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "resources": [],
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "resources": [],
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "resources": [],
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 45.14953752,
    "resources": [
    {
    "displayname": "<untraceable>",
    "quotaconsumed": 45.14953752,
    "removed": false
    }
    ],
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "resources": [],
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 47.08082241
    }
    }
    (d1) 🐱 > quota statement accountid=2f49212d-d6d5-437b-800d-a7bb4a8def4b startdate=2026-03-01 enddate=2027-03-02 showresources=false
    {
    "statement": {
    "account": "u1",
    "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
    "currency": "$",
    "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 1.93128489,
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 45.14953752,
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 47.08082241
    }
    }
  • type: filters the statement to only include usage records for the specified usage type.

     (d1) 🐱 > quota statement accountid=2f49212d-d6d5-437b-800d-a7bb4a8def4b startdate=2026-03-01 enddate=2027-03-02 type=1
    {
    "statement": {
    "account": "u1",
    "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
    "currency": "$",
    "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 0
    }
    }
    (d1) 🐱 > quota statement accountid=2f49212d-d6d5-437b-800d-a7bb4a8def4b startdate=2026-03-01 enddate=2027-03-02 type=1 showresources=true
    {
    "statement": {
    "account": "u1",
    "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
    "currency": "$",
    "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "resources": [
    {
    "displayname": "VM-91c1a276-e8a9-4fe9-bf93-905d84428b9a",
    "quotaconsumed": 0,
    "removed": true,
    "resourceid": "91c1a276-e8a9-4fe9-bf93-905d84428b9a"
    }
    ],
    "type": 1,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 0
    }
    }
  • projectid: allows generating statements for projects belonging to their domain, but returns an error for projects outside it.

     (d1) 🐱 > quota statement projectid=c1ce41c4-7b01-4386-8264-479db5ace0bc startdate=2026-03-01 enddate=2027-03-02
    🙈 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 statement projectid=c1ce41c4-7b01-4386-8264-479db5ace0bc startdate=2026-03-01 enddate=2027-03-02
    {
    "statement": {
    "account": "PrjAcct-aa-1",
    "accountid": "b14100c6-d9f6-450e-87a2-0833bb45e5f8",
    "currency": "$",
    "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 0,
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 0,
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 0
    }
    }

Test 3 (root admins)

  • startdate and enddate only: returns only their own statement.

     (admin) 🐱 > quota statement startdate=2026-03-01 enddate=2027-03-02
    {
    "statement": {
    "account": "admin",
    "accountid": "f684da1a-f84b-11f0-8ace-32e0826870ba",
    "currency": "$",
    "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 87.68817432,
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 0,
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 87.68817432
    }
    }
  • account: allows generating statements for all accounts.

     (admin) 🐱 > quota statement account=dr domainid=de3f3dfb-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02
    {
    "statement": {
    "account": "dr",
    "accountid": "aaba75a0-a575-41be-80e1-dbea14c10e51",
    "currency": "$",
    "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 0,
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 0,
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 0
    }
    }
    (admin) 🐱 > quota statement account=u1 domainid=dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d startdate=2026-03-01 enddate=2027-03-02
    {
    "statement": {
    "account": "u1",
    "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
    "currency": "$",
    "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 1.93128489,
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 45.14953752,
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 47.08082241
    }
    }
  • accountid: allows generating statements for all accounts.

     (admin) 🐱 > quota statement accountid=f684da1a-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02
    {
    "statement": {
    "account": "admin",
    "accountid": "f684da1a-f84b-11f0-8ace-32e0826870ba",
    "currency": "$",
    "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 87.68817432,
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 0,
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 87.68817432
    }
    }
    (admin) 🐱 > quota statement accountid=b029e8b8-e539-4d1a-906d-3d4f2fb36b82 startdate=2026-03-01 enddate=2027-03-02
    {
    "statement": {
    "account": "ur",
    "accountid": "b029e8b8-e539-4d1a-906d-3d4f2fb36b82",
    "currency": "$",
    "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 0,
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 0,
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 0
    }
    }
    (admin) 🐱 > quota statement accountid=feaffae2-7ba4-45dc-b46f-20ae86192685 startdate=2026-03-01 enddate=2027-03-02
    {
    "statement": {
    "account": "d1",
    "accountid": "feaffae2-7ba4-45dc-b46f-20ae86192685",
    "currency": "$",
    "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 0.32591051,
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 6.51882704,
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 6.84473755
    }
    }
    (admin) 🐱 > quota statement accountid=2f49212d-d6d5-437b-800d-a7bb4a8def4b startdate=2026-03-01 enddate=2027-03-02
    {
    "statement": {
    "account": "u1",
    "accountid": "2f49212d-d6d5-437b-800d-a7bb4a8def4b",
    "currency": "$",
    "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 1.93128489,
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 45.14953752,
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 47.08082241
    }
    }
  • domainid: allows generating statements for all domains.

     (admin) 🐱 > quota statement domainid=de3f3dfb-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02
    {
    "statement": {
    "currency": "$",
    "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 87.68817432,
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 0,
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 87.68817432
    }
    }
    (admin) 🐱 > quota statement domainid=dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d startdate=2026-03-01 enddate=2027-03-02
    {
    "statement": {
    "currency": "$",
    "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 2.2571954,
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 51.66836456,
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 53.92555996
    }
    }
  • showresources: lists the resources of each quota type in the period when set to true.

     (admin) 🐱 > quota statement accountid=f684da1a-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02 showresources=true
    {
    "statement": {
    "account": "admin",
    "accountid": "f684da1a-f84b-11f0-8ace-32e0826870ba",
    "currency": "$",
    "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "resources": [
    {
    "displayname": "VM-3fd7e901-8d9a-4b22-bc4a-df4145088535",
    "quotaconsumed": 0,
    "removed": false,
    "resourceid": "3fd7e901-8d9a-4b22-bc4a-df4145088535"
    }
    ],
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 87.68817432,
    "resources": [
    {
    "displayname": "VM-3fd7e901-8d9a-4b22-bc4a-df4145088535",
    "quotaconsumed": 87.68817432,
    "removed": false,
    "resourceid": "3fd7e901-8d9a-4b22-bc4a-df4145088535"
    }
    ],
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "resources": [],
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "resources": [],
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "resources": [],
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "resources": [],
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "resources": [],
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "resources": [],
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "resources": [],
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "resources": [],
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "resources": [],
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "resources": [],
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "resources": [
    {
    "displayname": "DefaultSharedNetworkOffering",
    "quotaconsumed": 0,
    "removed": false,
    "resourceid": "b7f878a4-b72b-4ae6-a496-2f8ccd5b98e4"
    }
    ],
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "resources": [],
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "resources": [],
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "resources": [],
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "resources": [],
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "resources": [],
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "resources": [],
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "resources": [],
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "resources": [],
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "resources": [],
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "resources": [],
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 0,
    "resources": [],
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "resources": [],
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 87.68817432
    }
    }
    (admin) 🐱 > quota statement accountid=f684da1a-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02 showresources=false
    {
    "statement": {
    "account": "admin",
    "accountid": "f684da1a-f84b-11f0-8ace-32e0826870ba",
    "currency": "$",
    "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 87.68817432,
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 0,
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 87.68817432
    }
    }
  • type: filters the statement to only include usage records for the specified usage type.

     (admin) 🐱 > quota statement accountid=f684da1a-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02 type=1
    {
    "statement": {
    "account": "admin",
    "accountid": "f684da1a-f84b-11f0-8ace-32e0826870ba",
    "currency": "$",
    "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 0
    }
    }
    (admin) 🐱 > quota statement accountid=f684da1a-f84b-11f0-8ace-32e0826870ba startdate=2026-03-01 enddate=2027-03-02 type=1 showresources=true
    {
    "statement": {
    "account": "admin",
    "accountid": "f684da1a-f84b-11f0-8ace-32e0826870ba",
    "currency": "$",
    "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "resources": [
    {
    "displayname": "VM-3fd7e901-8d9a-4b22-bc4a-df4145088535",
    "quotaconsumed": 0,
    "removed": false,
    "resourceid": "3fd7e901-8d9a-4b22-bc4a-df4145088535"
    }
    ],
    "type": 1,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 0
    }
    }
  • projectid: allows generating statements for all projects in the environment.

     (admin) 🐱 > quota statement projectid=c1ce41c4-7b01-4386-8264-479db5ace0bc startdate=2026-03-01 enddate=2027-03-02
    {
    "statement": {
    "account": "PrjAcct-aa-1",
    "accountid": "b14100c6-d9f6-450e-87a2-0833bb45e5f8",
    "currency": "$",
    "domain": "de3f3dfb-f84b-11f0-8ace-32e0826870ba",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [
    {
    "name": "RUNNING_VM",
    "quota": 0,
    "type": 1,
    "unit": "Compute*Month"
    },
    {
    "name": "ALLOCATED_VM",
    "quota": 0,
    "type": 2,
    "unit": "Compute*Month"
    },
    {
    "name": "IP_ADDRESS",
    "quota": 0,
    "type": 3,
    "unit": "IP*Month"
    },
    {
    "name": "NETWORK_BYTES_SENT",
    "quota": 0,
    "type": 4,
    "unit": "GB"
    },
    {
    "name": "NETWORK_BYTES_RECEIVED",
    "quota": 0,
    "type": 5,
    "unit": "GB"
    },
    {
    "name": "VOLUME",
    "quota": 0,
    "type": 6,
    "unit": "GB*Month"
    },
    {
    "name": "TEMPLATE",
    "quota": 0,
    "type": 7,
    "unit": "GB*Month"
    },
    {
    "name": "ISO",
    "quota": 0,
    "type": 8,
    "unit": "GB*Month"
    },
    {
    "name": "SNAPSHOT",
    "quota": 0,
    "type": 9,
    "unit": "GB*Month"
    },
    {
    "name": "SECURITY_GROUP",
    "quota": 0,
    "type": 10,
    "unit": "Policy*Month"
    },
    {
    "name": "LOAD_BALANCER_POLICY",
    "quota": 0,
    "type": 11,
    "unit": "Policy*Month"
    },
    {
    "name": "PORT_FORWARDING_RULE",
    "quota": 0,
    "type": 12,
    "unit": "Policy*Month"
    },
    {
    "name": "NETWORK_OFFERING",
    "quota": 0,
    "type": 13,
    "unit": "Policy*Month"
    },
    {
    "name": "VPN_USERS",
    "quota": 0,
    "type": 14,
    "unit": "Policy*Month"
    },
    {
    "name": "VM_DISK_IO_READ",
    "quota": 0,
    "type": 21,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_IO_WRITE",
    "quota": 0,
    "type": 22,
    "unit": "IOPS"
    },
    {
    "name": "VM_DISK_BYTES_READ",
    "quota": 0,
    "type": 23,
    "unit": "Bytes"
    },
    {
    "name": "VM_DISK_BYTES_WRITE",
    "quota": 0,
    "type": 24,
    "unit": "Bytes"
    },
    {
    "name": "VM_SNAPSHOT",
    "quota": 0,
    "type": 25,
    "unit": "GB*Month"
    },
    {
    "name": "VOLUME_SECONDARY",
    "quota": 0,
    "type": 26,
    "unit": "GB*Month"
    },
    {
    "name": "VM_SNAPSHOT_ON_PRIMARY",
    "quota": 0,
    "type": 27,
    "unit": "GB*Month"
    },
    {
    "name": "BACKUP",
    "quota": 0,
    "type": 28,
    "unit": "GB*Month"
    },
    {
    "name": "BUCKET",
    "quota": 0,
    "type": 29,
    "unit": "GB*Month"
    },
    {
    "name": "NETWORK",
    "quota": 0,
    "type": 30,
    "unit": "Compute*Month"
    },
    {
    "name": "VPC",
    "quota": 0,
    "type": 31,
    "unit": "Compute*Month"
    }
    ],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 0
    }
    }
    (admin) 🐱 > quota statement projectid=3841cab4-e861-44a4-97e4-cb122ae9e7dd startdate=2026-03-01 enddate=2027-03-02 type=1
    {
    "statement": {
    "account": "PrjAcct-pd1-2",
    "accountid": "b8c5a156-193d-47b5-8dbc-c26e8a0a3ea3",
    "currency": "$",
    "domain": "dc5064ad-d4a8-4bb3-ae18-a52e4810ac3d",
    "enddate": "2027-03-02T23:59:59-0300",
    "quotausage": [],
    "startdate": "2026-03-01T00:00:00-0300",
    "totalquota": 0
    }
    }

@winterhazel

Copy link
Copy Markdown
Member

@blueorangutan package

@blueorangutan

Copy link
Copy Markdown

@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.

@bernardodemarcobernardodemarco left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

code lgtm, did not test it

@blueorangutan

Copy link
Copy Markdown

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

@winterhazel

Copy link
Copy Markdown
Member

@DaanHoogland@sureshanaparti can we run the CI here?

@sureshanaparti

Copy link
Copy Markdown
Contributor

@blueorangutan test

@blueorangutan

Copy link
Copy Markdown

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

@blueorangutan

Copy link
Copy Markdown

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

TestResultTime (s)Test File

@winterhazel

Copy link
Copy Markdown
Member

@shwstppr@nvazquez I have addressed the issues you pointed out. Do you still plan to review this PR, or can we merge it?

@DaanHoogland

Copy link
Copy Markdown
Contributor

@shwstppr@nvazquez I have addressed the issues you pointed out. Do you still plan to review this PR, or can we merge it?

let’s give them a few days @winterhazel , maybe till the weekend?

@shwstppr
shwstppr self-requested a review April 28, 2026 14:37
@shwstppr

Copy link
Copy Markdown
Contributor

I've no further comment here. Earlier highlighted issue seems to have been addressed

@shwstpprshwstppr left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

code lgtm. My quota plugin knowledge is limited. Reported tests look good

@DaanHoogland

Copy link
Copy Markdown
Contributor

thanks for the followup @shwstppr . @winterhazel I see no serious comment by @nvazquez. He only asked about the same thing @shwstppr noticed, so I think we can merge.

@winterhazel

Copy link
Copy Markdown
Member

@shwstppr thanks for the review. I am proceeding with the merge for this one.

@winterhazel
winterhazel merged commit a73cc9a into apache:mainApr 30, 2026
27 of 28 checks passed
@winterhazelwinterhazel mentioned this pull request Jun 18, 2026
9 tasks
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

14 participants

@julien-vaz@blueorangutan@sureshanaparti@DaanHoogland@JoaoJandre@harikrishna-patnala@nvazquez@winterhazel@shwstppr@lucas-a-martins@bernardodemarco@weizhouapache@RosiKyu