orca usage¶
Show Nova tenant usage.
The reference below is generated from the live CLI by mkdocs-click. It
always reflects the version installed.
orca usage¶
Inspect Nova tenant usage.
With no sub-command, runs usage show for the current project
(backward-compatible). OSC parity: usage show and usage list.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--start |
text | Start date (YYYY-MM-DD). Default: 30 days ago. | None |
--end |
text | End date (YYYY-MM-DD). Default: today. | None |
--noindent |
boolean | Disable JSON indentation. | False |
--max-width |
integer | Maximum table width (0 = unlimited). | None |
--fit-width |
boolean | Fit table to terminal width. | False |
--column, -c |
text | Column to include (repeatable). Shows all if omitted. | Sentinel.UNSET |
--format, -f |
choice (table | json | value) |
Output format. | table |
--help |
boolean | Show this message and exit. | False |
Subcommands
- list: List per-project resource usage across the whole cloud (admin).
- show: Show CPU/RAM/disk hours and per-server breakdown for one project.
orca usage list¶
List per-project resource usage across the whole cloud (admin).
Parity with openstack usage list — hits Nova
/os-simple-tenant-usage without a tenant filter, which returns
one row per project active during the window.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--start |
text | Start date (YYYY-MM-DD). Default: 30 days ago. | None |
--end |
text | End date (YYYY-MM-DD). Default: today. | None |
--noindent |
boolean | Disable JSON indentation. | False |
--max-width |
integer | Maximum table width (0 = unlimited). | None |
--fit-width |
boolean | Fit table to terminal width. | False |
--column, -c |
text | Column to include (repeatable). Shows all if omitted. | Sentinel.UNSET |
--format, -f |
choice (table | json | value) |
Output format. | table |
--help |
boolean | Show this message and exit. | False |
orca usage show¶
Show CPU/RAM/disk hours and per-server breakdown for one project.
Examples:
orca usage show
orca usage show --start 2026-04-01 --end 2026-04-14
orca usage show --project
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--project |
text | Project ID (default: current project). | Sentinel.UNSET |
--start |
text | Start date (YYYY-MM-DD). Default: 30 days ago. | None |
--end |
text | End date (YYYY-MM-DD). Default: today. | None |
--noindent |
boolean | Disable JSON indentation. | False |
--max-width |
integer | Maximum table width (0 = unlimited). | None |
--fit-width |
boolean | Fit table to terminal width. | False |
--column, -c |
text | Column to include (repeatable). Shows all if omitted. | Sentinel.UNSET |
--format, -f |
choice (table | json | value) |
Output format. | table |
--help |
boolean | Show this message and exit. | False |