CLI Reference¶
This page is auto-generated from the running CLI via mkdocs-click — it never goes stale. Every command, option, flag, and environment variable shown here is introspected directly from the orca binary at build time.
For tutorial-style content, see the curated command pages.
orca¶
orca — OpenStack Rich Command-line Alternative.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--version |
boolean | Show the version and exit. | False |
--profile, -P |
text | Config profile to use (overrides active profile). | None |
--region, -R |
text | Region to use (overrides profile region_name). | None |
--debug |
boolean | Log HTTP requests, retries, and auth decisions to stderr. | False |
--help |
boolean | Show this message and exit. | False |
orca access-rule¶
Manage application credential access rules (Keystone).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca access-rule delete¶
Delete an access rule.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--user-id |
text | User ID (defaults to current user). | None |
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca access-rule list¶
List access rules.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--user-id |
text | User ID (defaults to current user). | None |
--service |
text | Filter by service type (e.g. compute). | None |
--method |
text | Filter by HTTP method. | None |
--path |
text | Filter by API path. | 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 access-rule show¶
Show an access rule.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--user-id |
text | User ID (defaults to current user). | 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 acl¶
Barbican secret ACLs — OSC parity top-level.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca acl delete¶
Delete the ACL on a secret (revert to project-wide access).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca acl get¶
Get the ACL for a secret.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 acl set¶
Set the ACL on a secret.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--user |
text | User ID to grant read access to (repeatable). | Sentinel.UNSET |
--project-access / --no-project-access |
boolean | Allow all project users read access. | True |
--help |
boolean | Show this message and exit. | False |
orca acl user¶
Per-user ACL operations on a secret.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca acl user add¶
Add users to a secret's read ACL.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--user |
text | User ID to grant read access (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca acl user remove¶
Remove users from a secret's read ACL.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--user |
text | User ID to revoke read access from (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca address-group¶
Manage Neutron address groups (collections of CIDRs).
Used as the remote_address_group_id of security-group rules to
reuse a curated list of CIDRs across multiple rules.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca address-group create¶
Create an address group.
Examples: orca address-group create office-network --address 10.0.0.0/24 --address 10.1.0.0/24
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | Free-text description. | None |
--address |
text | CIDR to include (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca address-group delete¶
Delete an address group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca address-group list¶
List address groups.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 address-group set¶
Update an address group's name / description / member CIDRs.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--add-address |
text | CIDR to append (repeatable). | Sentinel.UNSET |
--remove-address |
text | CIDR to remove (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca address-group show¶
Show an address group's details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 address-group unset¶
Remove addresses from an address group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--address |
text | CIDR to remove (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca address-scope¶
Manage Neutron address scopes.
An address scope groups subnet pools that share the same routing domain — useful in BGP-driven L3 deployments and overlapping-CIDR scenarios.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca address-scope create¶
Create an address scope.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--ip-version |
choice (4 | 6) |
IP version: 4 or 6. | 4 |
--shared / --unshared |
boolean | Visible to other projects. | False |
--help |
boolean | Show this message and exit. | False |
orca address-scope delete¶
Delete an address scope.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca address-scope list¶
List address scopes.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 address-scope set¶
Update an address scope.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--shared / --unshared |
boolean | Switch visibility. | None |
--help |
boolean | Show this message and exit. | False |
orca address-scope show¶
Show an address scope's details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 aggregate¶
Manage host aggregates (Nova).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca aggregate add¶
OSC parity verbs (aggregate add host …).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca aggregate add add¶
Add a host to an aggregate.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca aggregate add-host¶
Add a host to an aggregate.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca aggregate cache¶
OSC parity verbs (aggregate cache image …).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca aggregate cache cache¶
Request that images be cached on hosts in an aggregate.
Examples:
orca aggregate image cache
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca aggregate cache-image¶
Request that images be cached on hosts in an aggregate.
Examples:
orca aggregate image cache
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca aggregate create¶
Create a host aggregate.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--zone |
text | Availability zone name. | None |
--help |
boolean | Show this message and exit. | False |
orca aggregate delete¶
Delete a host aggregate.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca aggregate host¶
Manage hosts inside an aggregate.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca aggregate host add¶
Add a host to an aggregate.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca aggregate host remove¶
Remove a host from an aggregate.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca aggregate image¶
Manage image caching on aggregates.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca aggregate image cache¶
Request that images be cached on hosts in an aggregate.
Examples:
orca aggregate image cache
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca aggregate list¶
List host aggregates.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 aggregate remove¶
OSC parity verbs (aggregate remove host …).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca aggregate remove remove¶
Remove a host from an aggregate.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca aggregate remove-host¶
Remove a host from an aggregate.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca aggregate set¶
Update an aggregate's name, AZ, or metadata.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--zone |
text | New availability zone. | None |
--property |
text | Metadata key=value (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca aggregate show¶
Show aggregate details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 aggregate unset¶
Unset metadata properties on an aggregate.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--property |
text | Metadata key to remove (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca alarm¶
Manage Aodh alarms.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca alarm capabilities¶
Show Aodh API capabilities.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca alarm create¶
Create an alarm.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Alarm name. | Sentinel.UNSET |
--type |
choice (gnocchi_resources_threshold | gnocchi_aggregation_by_metrics_threshold | gnocchi_aggregation_by_resources_threshold | event | composite | loadbalancer_member_health | threshold) |
Alarm type. | Sentinel.UNSET |
--rule |
text | Type-specific rule as a JSON string. | Sentinel.UNSET |
--description |
text | Alarm description. | `` |
--severity |
choice (low | moderate | critical) |
Alarm severity. | low |
--enabled / --disabled |
boolean | Enable or disable the alarm. | True |
--repeat-actions / --no-repeat-actions |
boolean | Re-trigger actions on each evaluation while in alarm state. | False |
--alarm-action |
text | Webhook URL to call when entering alarm state. Repeatable. | Sentinel.UNSET |
--ok-action |
text | Webhook URL to call when entering ok state. Repeatable. | Sentinel.UNSET |
--insufficient-data-action |
text | Webhook URL to call on insufficient data. Repeatable. | Sentinel.UNSET |
--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 alarm delete¶
Delete an alarm.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca alarm history¶
Show the change history of an alarm.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--limit |
integer | Max number of history entries. | 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 alarm list¶
List alarms.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
text | Filter by alarm type. | None |
--state |
choice (ok | alarm | insufficient_data) |
Filter by state. | None |
--enabled / --disabled |
boolean | Filter by enabled status. | None |
--name |
text | Filter by alarm name. | None |
--limit |
integer | Max number of alarms to return. | 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 alarm metrics¶
Show Aodh evaluator metrics (OSC alarm metrics).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 alarm quota¶
Inspect or set Aodh per-project alarm quota.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca alarm quota set¶
Set alarm quota for a project.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--alarms |
integer | Maximum number of alarms for the project. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca alarm quota show¶
Show the alarm quota for a project (OSC alarm quota show).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--project |
text | Project to query (default: caller's project). | 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 alarm quota-set¶
Set alarm quota for a project.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--alarms |
integer | Maximum number of alarms for the project. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca alarm set¶
Update an alarm.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New alarm name. | None |
--description |
text | New description. | None |
--severity |
choice (low | moderate | critical) |
N/A | None |
--enabled / --disabled |
boolean | Enable or disable. | None |
--repeat-actions / --no-repeat-actions |
boolean | N/A | None |
--rule |
text | Updated type-specific rule as JSON. | None |
--alarm-action |
text | N/A | Sentinel.UNSET |
--ok-action |
text | N/A | Sentinel.UNSET |
--insufficient-data-action |
text | N/A | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca alarm set¶
Update an alarm.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New alarm name. | None |
--description |
text | New description. | None |
--severity |
choice (low | moderate | critical) |
N/A | None |
--enabled / --disabled |
boolean | Enable or disable. | None |
--repeat-actions / --no-repeat-actions |
boolean | N/A | None |
--rule |
text | Updated type-specific rule as JSON. | None |
--alarm-action |
text | N/A | Sentinel.UNSET |
--ok-action |
text | N/A | Sentinel.UNSET |
--insufficient-data-action |
text | N/A | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca alarm show¶
Show an alarm.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 alarm state¶
Inspect or override an alarm's evaluation state.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca alarm state get¶
Get the current state of an alarm.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca alarm state set¶
Set the state of an alarm.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca alarm state-get¶
Get the current state of an alarm.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca alarm state-set¶
Set the state of an alarm.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca allocation¶
Placement allocations — OSC parity.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca allocation candidate¶
Placement allocation candidates.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca allocation candidate candidate-list¶
List allocation candidates for the requested resources.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--resource |
text | Requested resource, e.g. VCPU=4. Repeatable. | Sentinel.UNSET |
--required |
text | Required trait. Repeatable. | Sentinel.UNSET |
--forbidden |
text | Forbidden trait. Repeatable. | Sentinel.UNSET |
--limit |
integer | Max number of candidates. | 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 allocation delete¶
Delete all allocations for a consumer.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca allocation set¶
Set (replace) allocations for a consumer against a single resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--resource-provider |
text | Resource provider UUID. | Sentinel.UNSET |
--resource |
text | Resource class and amount, e.g. VCPU=4. Repeatable. | Sentinel.UNSET |
--project-id |
text | Consumer project UUID. | Sentinel.UNSET |
--user-id |
text | Consumer user UUID. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca allocation show¶
Show allocations for a consumer.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 allocation unset¶
Drop a single resource-class allocation for a consumer.
Reads the consumer's full allocations, strips rc_name from
each provider entry (optionally only on --rp-uuid), then PUTs
the remaining allocations back. Empty entries are dropped.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--resource-class |
text | Resource class to clear (e.g. VCPU, MEMORY_MB). | Sentinel.UNSET |
--rp-uuid |
text | Optional: limit to allocations on this resource provider (default: all providers). | None |
--help |
boolean | Show this message and exit. | False |
orca application-credential¶
Manage application credentials (Keystone v3).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca application-credential create¶
Create an application credential.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | N/A | None |
--secret |
text | Secret (auto-generated if omitted). | None |
--expires |
text | Expiry (ISO 8601, e.g. 2026-12-31T00:00:00). | None |
--unrestricted |
boolean | Allow creation of other credentials (dangerous). | False |
--user |
text | N/A | None |
--access-rules |
text | Access rules as a JSON array, e.g. '[{"path":"/v3/projects","method":"GET","service":"identity"}]'. Keystone only attaches access rules at create time. | None |
--save-profile |
text | Save the new credential as an orca profile of this name. | None |
--help |
boolean | Show this message and exit. | False |
orca application-credential delete¶
Delete an application credential.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--user |
text | N/A | None |
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca application-credential list¶
List application credentials.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--user |
text | User ID (default: current user). | 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 application-credential show¶
Show application credential details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--user |
text | N/A | 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 audit¶
Run a security audit on the project.
Checks for common misconfigurations: - Security groups with 0.0.0.0/0 on dangerous ports - Servers without SSH key pair - Servers with admin password set - Unencrypted volumes - Publicly exposed services
Examples: orca audit
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca auth¶
Keystone identity & access diagnostics.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca auth check¶
Verify credentials are still valid (password check).
Tests authentication against Keystone without running any command. Use before long scripts to fail fast.
Examples: orca auth check # check active profile orca auth check --all # check every orca profile orca auth check --clouds # also check clouds.yaml entries
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--all, -a |
boolean | Check all profiles, not just the active one. | False |
--clouds |
boolean | Also check clouds.yaml entries. | False |
--help |
boolean | Show this message and exit. | False |
orca auth token¶
Inspect or revoke the current token.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca auth token debug¶
Inspect the current token — roles, catalog, methods, expiration.
Shows everything Keystone returned in the token payload. Use --raw for the full JSON dump.
Examples: orca auth token debug orca auth token debug --raw
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--raw |
boolean | Print the full token body as JSON. | False |
--help |
boolean | Show this message and exit. | False |
orca auth token revoke¶
Revoke a token.
Example:
orca auth token revoke
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca auth token-debug¶
Inspect the current token — roles, catalog, methods, expiration.
Shows everything Keystone returned in the token payload. Use --raw for the full JSON dump.
Examples: orca auth token debug orca auth token debug --raw
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--raw |
boolean | Print the full token body as JSON. | False |
--help |
boolean | Show this message and exit. | False |
orca auth token-revoke¶
Revoke a token.
Example:
orca auth token revoke
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca auth whoami¶
Show current identity — user, project, roles, endpoints.
Fast summary of who you are and what you can do, without listing all resources.
Examples: orca auth whoami orca -P staging auth whoami
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca availability-zone¶
Manage availability zones (Nova).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca availability-zone list¶
List availability zones.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--long |
boolean | Show hosts and services. | False |
--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 backup¶
Manage Freezer backups, jobs, sessions & clients.
For Cinder volume backups see orca volume backup-list etc.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca backup action¶
Manage backup actions.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca backup action create¶
Create a standalone backup action.
Examples: orca backup action create --path /var/data --container my-backups orca backup action create --action restore --path /var/data --container my-backups orca backup action create --path /var/lib/mysql --mode mysql --backup-name daily-mysql
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--action |
choice (backup | restore | admin) |
N/A | backup |
--path |
text | Path to back up or restore. | Sentinel.UNSET |
--container |
text | Swift container name. | None |
--storage |
choice (swift | local | ssh | s3) |
N/A | swift |
--mode |
choice (fs | mysql | mongo | mssql | cinder | nova) |
N/A | fs |
--backup-name |
text | Name for the backup. | None |
--max-level |
integer | Max incremental backup level. | None |
--help |
boolean | Show this message and exit. | False |
orca backup action delete¶
Delete a backup action.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca backup action list¶
List backup actions.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--limit |
integer | Max results. | 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 backup action show¶
Show backup action details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 backup action-create¶
Create a standalone backup action.
Examples: orca backup action create --path /var/data --container my-backups orca backup action create --action restore --path /var/data --container my-backups orca backup action create --path /var/lib/mysql --mode mysql --backup-name daily-mysql
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--action |
choice (backup | restore | admin) |
N/A | backup |
--path |
text | Path to back up or restore. | Sentinel.UNSET |
--container |
text | Swift container name. | None |
--storage |
choice (swift | local | ssh | s3) |
N/A | swift |
--mode |
choice (fs | mysql | mongo | mssql | cinder | nova) |
N/A | fs |
--backup-name |
text | Name for the backup. | None |
--max-level |
integer | Max incremental backup level. | None |
--help |
boolean | Show this message and exit. | False |
orca backup action-delete¶
Delete a backup action.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca backup action-list¶
List backup actions.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--limit |
integer | Max results. | 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 backup action-show¶
Show backup action details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 backup client¶
Manage backup clients (agents).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca backup client delete¶
Unregister a backup client.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca backup client list¶
List registered backup clients (agents).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--limit |
integer | Max results. | 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 backup client register¶
Register a new backup client.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | Client description. | `` |
--help |
boolean | Show this message and exit. | False |
orca backup client show¶
Show backup client details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 backup client-delete¶
Unregister a backup client.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca backup client-list¶
List registered backup clients (agents).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--limit |
integer | Max results. | 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 backup client-register¶
Register a new backup client.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | Client description. | `` |
--help |
boolean | Show this message and exit. | False |
orca backup client-show¶
Show backup client details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 backup delete¶
Delete a backup.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca backup job¶
Manage backup jobs.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca backup job create¶
Create a backup job.
Examples:
orca backup job create --client-id
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | Job description. | `` |
--client-id |
text | Freezer client ID. | Sentinel.UNSET |
--action |
choice (backup | restore | admin) |
Action type. | backup |
--path |
text | Path to back up or restore. | Sentinel.UNSET |
--container |
text | Swift container name for storage. | None |
--storage |
choice (swift | local | ssh | s3) |
Storage backend. | swift |
--mode |
choice (fs | mysql | mongo | mssql | cinder | nova) |
Backup mode. | fs |
--schedule-interval |
text | Schedule interval (e.g. '24 hours', '7 days'). | None |
--help |
boolean | Show this message and exit. | False |
orca backup job delete¶
Delete a backup job.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca backup job list¶
List backup jobs.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--limit |
integer | Max results. | 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 backup job show¶
Show backup job details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 backup job start¶
Start (trigger) a backup job.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca backup job stop¶
Stop a running backup job.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca backup job-create¶
Create a backup job.
Examples:
orca backup job create --client-id
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | Job description. | `` |
--client-id |
text | Freezer client ID. | Sentinel.UNSET |
--action |
choice (backup | restore | admin) |
Action type. | backup |
--path |
text | Path to back up or restore. | Sentinel.UNSET |
--container |
text | Swift container name for storage. | None |
--storage |
choice (swift | local | ssh | s3) |
Storage backend. | swift |
--mode |
choice (fs | mysql | mongo | mssql | cinder | nova) |
Backup mode. | fs |
--schedule-interval |
text | Schedule interval (e.g. '24 hours', '7 days'). | None |
--help |
boolean | Show this message and exit. | False |
orca backup job-delete¶
Delete a backup job.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca backup job-list¶
List backup jobs.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--limit |
integer | Max results. | 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 backup job-show¶
Show backup job details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 backup job-start¶
Start (trigger) a backup job.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca backup job-stop¶
Stop a running backup job.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca backup list¶
List backups.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--limit |
integer | Max results. | None |
--offset |
integer | Offset for pagination. | 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 backup session¶
Manage backup sessions.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca backup session add-job¶
Add a job to a session.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca backup session create¶
Create a backup session.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | Session description. | `` |
--schedule-interval |
text | Schedule interval (e.g. '24 hours'). | None |
--help |
boolean | Show this message and exit. | False |
orca backup session delete¶
Delete a backup session.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca backup session list¶
List backup sessions.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--limit |
integer | Max results. | 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 backup session remove-job¶
Remove a job from a session.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca backup session show¶
Show backup session details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 backup session start¶
Start a backup session (triggers all its jobs).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca backup session-add-job¶
Add a job to a session.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca backup session-create¶
Create a backup session.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | Session description. | `` |
--schedule-interval |
text | Schedule interval (e.g. '24 hours'). | None |
--help |
boolean | Show this message and exit. | False |
orca backup session-delete¶
Delete a backup session.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca backup session-list¶
List backup sessions.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--limit |
integer | Max results. | 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 backup session-remove-job¶
Remove a job from a session.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca backup session-show¶
Show backup session details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 backup session-start¶
Start a backup session (triggers all its jobs).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca backup show¶
Show backup details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 block-storage¶
OSC parity: openstack block storage … admin verbs.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca block-storage cleanup¶
Run a Cinder admin cleanup (POST /workers/cleanup).
Parity with openstack block storage cleanup — clears
abandoned operations from a failed node.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--cluster |
text | Cluster on which to run the cleanup. | None |
--host |
text | Host on which to run the cleanup. | None |
--binary |
text | Service binary (e.g. cinder-volume). | None |
--is-up / --not-up |
boolean | Filter on service liveness. | None |
--disabled / --enabled |
boolean | Filter on the service disabled flag. | None |
--resource-id |
text | Restrict the cleanup to one resource. | None |
--resource-type |
text | Restrict the cleanup to one resource type (Volume, Snapshot, …). | None |
--service-id |
integer | Restrict the cleanup to a single Cinder service ID. | None |
--help |
boolean | Show this message and exit. | False |
orca block-storage cluster¶
Manage Cinder active/active clusters (admin).
Maps to OSC openstack block storage cluster ….
Requires Cinder micro-version >= 3.7 on the cloud.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca block-storage cluster list¶
List Cinder clusters.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Filter by cluster name. | Sentinel.UNSET |
--binary |
text | Filter by service binary (e.g. cinder-volume). | Sentinel.UNSET |
--detail |
boolean | Include extended fields. | False |
--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 block-storage cluster set¶
Enable/disable a cluster or set a disable-reason.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--binary |
text | Service binary (required if ambiguous). | Sentinel.UNSET |
--disable |
boolean | Disable the cluster. | None |
--enable |
boolean | Enable the cluster. | None |
--disable-reason |
text | Reason recorded when disabling. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca block-storage cluster show¶
Show one Cinder cluster.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--binary |
text | Disambiguate when several binaries share a cluster name. | Sentinel.UNSET |
--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 block-storage log-level¶
Inspect or change live log levels of Cinder services (admin).
Maps to OSC openstack block storage log level ….
Requires Cinder micro-version >= 3.32.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca block-storage log-level list¶
List current log levels per service / logger.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--binary |
text | Filter by service binary (cinder-api, cinder-volume, …). | Sentinel.UNSET |
--server |
text | Filter by host. | Sentinel.UNSET |
--prefix |
text | Filter by logger prefix. | Sentinel.UNSET |
--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 block-storage log-level set¶
Change the runtime log level of a Cinder service.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--binary |
text | Restrict to one service binary. | Sentinel.UNSET |
--server |
text | Restrict to one host. | Sentinel.UNSET |
--prefix |
text | Restrict to one logger prefix. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca block-storage resource-filter¶
List/show server-side filters available for Cinder list APIs (admin).
Maps to OSC openstack block storage resource filter ….
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca block-storage resource-filter list¶
List all resource types that support server-side filters.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 block-storage resource-filter show¶
Show filters available for one resource type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 block-storage snapshot¶
Snapshot-level admin verbs under block-storage.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca block-storage snapshot manageable¶
Discover Cinder-manageable existing snapshots on the backend.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca block-storage snapshot manageable list¶
List snapshots on the backend that are not (yet) managed by Cinder.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--host |
text | Filter by Cinder host. | Sentinel.UNSET |
--cluster |
text | Filter by cluster name. | Sentinel.UNSET |
--detail |
boolean | Include extra backend fields. | False |
--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 block-storage volume¶
Volume-level admin verbs under block-storage.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca block-storage volume manageable¶
Discover Cinder-manageable existing backend resources (admin).
Maps to OSC openstack block storage volume manageable list.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca block-storage volume manageable list¶
List volumes on the backend that are not (yet) managed by Cinder.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--host |
text | Filter by Cinder host (required on most backends). | Sentinel.UNSET |
--cluster |
text | Filter by cluster name. | Sentinel.UNSET |
--detail |
boolean | Include extra backend fields. | False |
--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 ca¶
Barbican Certificate Authorities (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca ca get¶
Show a Certificate Authority by ID.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 ca list¶
List Certificate Authorities registered with Barbican.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 catalog¶
List available service endpoints from the Keystone catalog.
Bare orca catalog keeps the historical behaviour (equivalent to
orca catalog list); use orca catalog show <service> to drill
into a specific service.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 catalog list¶
List all service endpoints from the Keystone catalog (OSC parity).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 catalog show¶
Show all endpoints for a service (by name or type).
Examples: orca catalog show compute orca catalog show nova orca catalog show identity
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 cleanup¶
Find orphaned resources — unused IPs, detached volumes, broken stacks, etc.
Detects the following by default: floating-ip — not associated with any port volume — detached & available, or in error state snapshot — in error state; or older than --older-than days port — no device attached security-group — non-default, not used by any server server — in ERROR state router — no external gateway and no attached interfaces stack — in a failed/rollback state (requires Heat) loadbalancer — in ERROR state (requires Octavia)
By default only reports findings. Use --delete to clean up.
Examples: orca cleanup orca cleanup --older-than 30 orca cleanup --skip stack --skip loadbalancer orca cleanup --delete --yes orca cleanup --older-than 14 --delete --yes
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--delete |
boolean | Actually delete the detected orphaned resources. | False |
--older-than |
integer | Flag volumes and snapshots older than N days (implies age check). | None |
--skip |
choice (floating-ip | volume | snapshot | port | security-group | server | router | stack | loadbalancer) |
Resource type to skip (repeatable). | Sentinel.UNSET |
--yes, -y |
boolean | Skip confirmation when deleting. | False |
--help |
boolean | Show this message and exit. | False |
orca cluster¶
Manage Kubernetes clusters & cluster templates (Magnum).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca cluster create¶
Create a Kubernetes cluster.
Examples:
orca cluster create my-k8s --template
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--template |
text | Cluster template UUID or name. | Sentinel.UNSET |
--node-count |
integer | Number of worker nodes. | 1 |
--master-count |
integer | Number of master nodes. | 1 |
--keypair |
text | SSH keypair name. | None |
--timeout |
integer | Creation timeout (minutes). | 60 |
--flavor |
text | Node flavor (overrides template). | None |
--master-flavor |
text | Master flavor (overrides template). | None |
--help |
boolean | Show this message and exit. | False |
orca cluster delete¶
Delete a cluster.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca cluster kubeconfig¶
Show the cluster API address and connection info.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca cluster list¶
List clusters.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 cluster nodegroup¶
Manage node groups in a cluster.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca cluster nodegroup create¶
Create a node group in a cluster.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Node group name. | Sentinel.UNSET |
--flavor-id |
text | Flavor ID for nodes. | Sentinel.UNSET |
--node-count |
integer | Initial number of nodes. | 1 |
--min-node-count |
integer | Minimum node count (for autoscaling). | None |
--max-node-count |
integer | Maximum node count (for autoscaling). | None |
--role |
text | Node group role (worker/infra). | worker |
--image-id |
text | Override image ID. | None |
--help |
boolean | Show this message and exit. | False |
orca cluster nodegroup delete¶
Delete a node group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca cluster nodegroup list¶
List node groups in a cluster.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 cluster nodegroup show¶
Show node group details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 cluster nodegroup update¶
Update a node group (resize / autoscaling bounds).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--node-count |
integer | New node count. | None |
--min-node-count |
integer | New minimum node count. | None |
--max-node-count |
integer | New maximum node count. | None |
--help |
boolean | Show this message and exit. | False |
orca cluster nodegroup-create¶
Create a node group in a cluster.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Node group name. | Sentinel.UNSET |
--flavor-id |
text | Flavor ID for nodes. | Sentinel.UNSET |
--node-count |
integer | Initial number of nodes. | 1 |
--min-node-count |
integer | Minimum node count (for autoscaling). | None |
--max-node-count |
integer | Maximum node count (for autoscaling). | None |
--role |
text | Node group role (worker/infra). | worker |
--image-id |
text | Override image ID. | None |
--help |
boolean | Show this message and exit. | False |
orca cluster nodegroup-delete¶
Delete a node group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca cluster nodegroup-list¶
List node groups in a cluster.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 cluster nodegroup-show¶
Show node group details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 cluster nodegroup-update¶
Update a node group (resize / autoscaling bounds).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--node-count |
integer | New node count. | None |
--min-node-count |
integer | New minimum node count. | None |
--max-node-count |
integer | New maximum node count. | None |
--help |
boolean | Show this message and exit. | False |
orca cluster resize¶
Resize a cluster (change worker node count).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--node-count |
integer | New number of worker nodes. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca cluster show¶
Show cluster details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 cluster template¶
Manage cluster templates.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca cluster template create¶
Create a cluster template.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--image |
text | Base image UUID or name. | Sentinel.UNSET |
--external-network |
text | External network ID. | Sentinel.UNSET |
--coe |
choice (kubernetes | swarm | mesos) |
N/A | kubernetes |
--keypair |
text | SSH keypair name. | None |
--flavor |
text | Node flavor. | None |
--master-flavor |
text | Master flavor. | None |
--network-driver |
text | Network driver (flannel, calico, etc.). | None |
--docker-volume-size |
integer | Docker volume size in GB. | None |
--dns |
text | DNS nameserver. | 8.8.8.8 |
--master-lb / --no-master-lb |
boolean | N/A | True |
--floating-ip / --no-floating-ip |
boolean | N/A | True |
--label |
text | Key=value label (repeatable). E.g. --label boot_volume_size=20 | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca cluster template delete¶
Delete a cluster template.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca cluster template list¶
List cluster templates.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 cluster template show¶
Show cluster template details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 cluster template-create¶
Create a cluster template.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--image |
text | Base image UUID or name. | Sentinel.UNSET |
--external-network |
text | External network ID. | Sentinel.UNSET |
--coe |
choice (kubernetes | swarm | mesos) |
N/A | kubernetes |
--keypair |
text | SSH keypair name. | None |
--flavor |
text | Node flavor. | None |
--master-flavor |
text | Master flavor. | None |
--network-driver |
text | Network driver (flannel, calico, etc.). | None |
--docker-volume-size |
integer | Docker volume size in GB. | None |
--dns |
text | DNS nameserver. | 8.8.8.8 |
--master-lb / --no-master-lb |
boolean | N/A | True |
--floating-ip / --no-floating-ip |
boolean | N/A | True |
--label |
text | Key=value label (repeatable). E.g. --label boot_volume_size=20 | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca cluster template-delete¶
Delete a cluster template.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca cluster template-list¶
List cluster templates.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 cluster template-show¶
Show cluster template details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 cluster upgrade¶
Upgrade a cluster to a new template version.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--template-id |
text | New cluster template ID to upgrade to. | Sentinel.UNSET |
--max-batch-size |
integer | Max number of nodes to upgrade simultaneously. | 1 |
--nodegroup |
text | Specific nodegroup to upgrade. | None |
--help |
boolean | Show this message and exit. | False |
orca coe¶
Magnum Container Orchestration Engine — OSC parity top-level.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca coe cluster¶
Manage Kubernetes clusters & cluster templates (Magnum).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca coe cluster create¶
Create a Kubernetes cluster.
Examples:
orca cluster create my-k8s --template
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--template |
text | Cluster template UUID or name. | Sentinel.UNSET |
--node-count |
integer | Number of worker nodes. | 1 |
--master-count |
integer | Number of master nodes. | 1 |
--keypair |
text | SSH keypair name. | None |
--timeout |
integer | Creation timeout (minutes). | 60 |
--flavor |
text | Node flavor (overrides template). | None |
--master-flavor |
text | Master flavor (overrides template). | None |
--help |
boolean | Show this message and exit. | False |
orca coe cluster delete¶
Delete a cluster.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca coe cluster kubeconfig¶
Show the cluster API address and connection info.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca coe cluster list¶
List clusters.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 coe cluster nodegroup¶
Manage node groups in a cluster.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca coe cluster nodegroup create¶
Create a node group in a cluster.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Node group name. | Sentinel.UNSET |
--flavor-id |
text | Flavor ID for nodes. | Sentinel.UNSET |
--node-count |
integer | Initial number of nodes. | 1 |
--min-node-count |
integer | Minimum node count (for autoscaling). | None |
--max-node-count |
integer | Maximum node count (for autoscaling). | None |
--role |
text | Node group role (worker/infra). | worker |
--image-id |
text | Override image ID. | None |
--help |
boolean | Show this message and exit. | False |
orca coe cluster nodegroup delete¶
Delete a node group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca coe cluster nodegroup list¶
List node groups in a cluster.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 coe cluster nodegroup show¶
Show node group details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 coe cluster nodegroup update¶
Update a node group (resize / autoscaling bounds).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--node-count |
integer | New node count. | None |
--min-node-count |
integer | New minimum node count. | None |
--max-node-count |
integer | New maximum node count. | None |
--help |
boolean | Show this message and exit. | False |
orca coe cluster nodegroup-create¶
Create a node group in a cluster.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Node group name. | Sentinel.UNSET |
--flavor-id |
text | Flavor ID for nodes. | Sentinel.UNSET |
--node-count |
integer | Initial number of nodes. | 1 |
--min-node-count |
integer | Minimum node count (for autoscaling). | None |
--max-node-count |
integer | Maximum node count (for autoscaling). | None |
--role |
text | Node group role (worker/infra). | worker |
--image-id |
text | Override image ID. | None |
--help |
boolean | Show this message and exit. | False |
orca coe cluster nodegroup-delete¶
Delete a node group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca coe cluster nodegroup-list¶
List node groups in a cluster.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 coe cluster nodegroup-show¶
Show node group details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 coe cluster nodegroup-update¶
Update a node group (resize / autoscaling bounds).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--node-count |
integer | New node count. | None |
--min-node-count |
integer | New minimum node count. | None |
--max-node-count |
integer | New maximum node count. | None |
--help |
boolean | Show this message and exit. | False |
orca coe cluster resize¶
Resize a cluster (change worker node count).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--node-count |
integer | New number of worker nodes. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca coe cluster show¶
Show cluster details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 coe cluster template¶
Manage cluster templates.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca coe cluster template create¶
Create a cluster template.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--image |
text | Base image UUID or name. | Sentinel.UNSET |
--external-network |
text | External network ID. | Sentinel.UNSET |
--coe |
choice (kubernetes | swarm | mesos) |
N/A | kubernetes |
--keypair |
text | SSH keypair name. | None |
--flavor |
text | Node flavor. | None |
--master-flavor |
text | Master flavor. | None |
--network-driver |
text | Network driver (flannel, calico, etc.). | None |
--docker-volume-size |
integer | Docker volume size in GB. | None |
--dns |
text | DNS nameserver. | 8.8.8.8 |
--master-lb / --no-master-lb |
boolean | N/A | True |
--floating-ip / --no-floating-ip |
boolean | N/A | True |
--label |
text | Key=value label (repeatable). E.g. --label boot_volume_size=20 | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca coe cluster template delete¶
Delete a cluster template.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca coe cluster template list¶
List cluster templates.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 coe cluster template show¶
Show cluster template details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 coe cluster template-create¶
Create a cluster template.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--image |
text | Base image UUID or name. | Sentinel.UNSET |
--external-network |
text | External network ID. | Sentinel.UNSET |
--coe |
choice (kubernetes | swarm | mesos) |
N/A | kubernetes |
--keypair |
text | SSH keypair name. | None |
--flavor |
text | Node flavor. | None |
--master-flavor |
text | Master flavor. | None |
--network-driver |
text | Network driver (flannel, calico, etc.). | None |
--docker-volume-size |
integer | Docker volume size in GB. | None |
--dns |
text | DNS nameserver. | 8.8.8.8 |
--master-lb / --no-master-lb |
boolean | N/A | True |
--floating-ip / --no-floating-ip |
boolean | N/A | True |
--label |
text | Key=value label (repeatable). E.g. --label boot_volume_size=20 | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca coe cluster template-delete¶
Delete a cluster template.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca coe cluster template-list¶
List cluster templates.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 coe cluster template-show¶
Show cluster template details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 coe cluster upgrade¶
Upgrade a cluster to a new template version.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--template-id |
text | New cluster template ID to upgrade to. | Sentinel.UNSET |
--max-batch-size |
integer | Max number of nodes to upgrade simultaneously. | 1 |
--nodegroup |
text | Specific nodegroup to upgrade. | None |
--help |
boolean | Show this message and exit. | False |
orca completion¶
Shell completion: print instructions or install automatically.
Examples: orca completion # auto-detect shell, print instructions orca completion bash # print instructions for bash (legacy) orca completion show zsh # same, explicit orca completion install # auto-detect shell, install orca completion install fish # install for fish
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca completion install¶
Install orca shell completion (auto-detects shell when omitted).
- bash/zsh: appends an eval line to ~/.bashrc / ~/.zshrc (idempotent).
- fish: writes ~/.config/fish/completions/orca.fish.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca completion show¶
Print manual installation instructions for the given shell.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca compute-service¶
Manage Nova compute services (nova-compute, nova-conductor, …).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca compute-service delete¶
Force-delete a compute service record.
Use this to remove stale service entries after a host is decommissioned.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca compute-service list¶
List compute services.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--host |
text | Filter by hostname. | None |
--binary |
text | Filter by binary (e.g. nova-compute). | 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 compute-service set¶
Enable, disable, or force-down a compute service.
Examples: orca compute-service set 1 --disable --disabled-reason "maintenance" orca compute-service set 1 --enable orca compute-service set 1 --force-down
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--enable / --disable |
boolean | Enable or disable the service. | None |
--disabled-reason |
text | Reason for disabling (used with --disable). | None |
--force-down / --no-force-down |
boolean | Force the service down (for evacuate scenarios). | None |
--help |
boolean | Show this message and exit. | False |
orca console¶
Inspect server consoles (log, URL) — OSC-parity alias.
Equivalent to the primary orca server console … group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca console log¶
Server boot log.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca console log log¶
Show the server console output (boot log).
Examples:
orca server console-log
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--lines |
integer | Number of lines to retrieve (0 = all). | 50 |
--help |
boolean | Show this message and exit. | False |
orca console url¶
Server remote console URL.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca console url url¶
Get a URL to access the server console (VNC/SPICE/serial).
Examples:
orca server console-url
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (novnc | xvpvnc | spice-html5 | rdp-html5 | serial) |
Console type. | novnc |
--open |
boolean | Open the URL in the default system browser immediately. | False |
--help |
boolean | Show this message and exit. | False |
orca container¶
Manage object storage containers (Swift).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca container create¶
Create a container.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca container delete¶
Delete a container.
Use --recursive to delete all objects in the container first.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--recursive |
boolean | Delete all objects before deleting the container. | False |
--yes, -y |
boolean | Skip confirmation prompt. | False |
--help |
boolean | Show this message and exit. | False |
orca container list¶
List containers.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 container save¶
Download all objects in a container to a local directory.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--output-dir |
text | Local directory to save objects into. | . |
--help |
boolean | Show this message and exit. | False |
orca container set¶
Set metadata on a container.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--property |
text | Metadata key=value pair (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca container show¶
Show container metadata.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 container stats¶
Show account-level storage statistics.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 container unset¶
Remove metadata from a container.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--property |
text | Metadata key to remove (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca credential¶
Manage Keystone credentials.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca credential create¶
Create a credential.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--user |
text | User ID who owns this credential. | Sentinel.UNSET |
--type |
text | Credential type (ec2, totp, cert, etc.). | Sentinel.UNSET |
--blob |
text | Credential data (JSON string or raw value). | Sentinel.UNSET |
--project |
text | Project ID (required for EC2 credentials). | None |
--help |
boolean | Show this message and exit. | False |
orca credential delete¶
Delete a credential.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca credential list¶
List credentials.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--user |
text | Filter by user ID. | None |
--type |
text | Filter by type (ec2, totp, cert…). | 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 credential set¶
Update a credential.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--blob |
text | New credential data. | None |
--project |
text | New project ID. | None |
--help |
boolean | Show this message and exit. | False |
orca credential show¶
Show credential details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 doctor¶
Run a pre-deployment health check on your OpenStack environment.
Verifies authentication, quota headroom, default security group rules, and service availability. No destructive operations are performed unless --fix is specified.
Checks performed: ✓ Authentication & token validity ✓ Service reachability (Nova, Neutron, Cinder, Glance) ✓ Compute quota headroom (instances, cores, RAM) ✓ Volume quota headroom ✓ Network quota headroom (floating IPs, security groups) ✓ Default security group SSH/ICMP rules
Quota thresholds: Green < 70% — comfortable headroom Yellow 70–90% — monitor closely Red ≥ 90% — critical, next deploy may fail
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--fix |
boolean | Attempt to fix auto-correctable issues. | False |
--cidr |
text | CIDR for auto-created security group rules (--fix). Defaults to interactive prompt when a TTY is detected, otherwise 0.0.0.0/0. | None |
--list-deprecated |
boolean | List every ADR-0008 deprecated alias in the CLI tree and exit (offline — no authentication required). | False |
--help |
boolean | Show this message and exit. | False |
orca domain¶
Manage domains (Keystone v3).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca domain create¶
Create a domain.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | N/A | None |
--enable / --disable |
boolean | N/A | True |
--help |
boolean | Show this message and exit. | False |
orca domain delete¶
Delete a domain.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca domain list¶
List domains.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 domain set¶
Update a domain.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | N/A | None |
--description |
text | N/A | None |
--enable / --disable |
boolean | N/A | None |
--help |
boolean | Show this message and exit. | False |
orca domain show¶
Show domain details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 endpoint¶
Manage Keystone service endpoints.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca endpoint create¶
Create an endpoint.
OSC-style positional form: endpoint create SERVICE INTERFACE URL.
Legacy flag form: endpoint create --service ID --interface public
--url .... Either works.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--service |
text | Service ID (alternative to positional SERVICE). | None |
--interface |
choice (public | internal | admin) |
Endpoint interface (alternative to positional INTERFACE). | None |
--url |
text | Endpoint URL (alternative to positional URL). | None |
--region |
text | Region ID. | None |
--enable / --disable |
boolean | Enable or disable the endpoint. | True |
--help |
boolean | Show this message and exit. | False |
orca endpoint delete¶
Delete an endpoint.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca endpoint list¶
List endpoints.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--service |
text | Filter by service ID or name. | None |
--interface |
choice (public | internal | admin) |
Filter by interface type. | None |
--region |
text | Filter by region ID. | 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 endpoint project¶
Manage endpoint↔project filter (Keystone OS-EP-FILTER extension).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca endpoint project add¶
Restrict an endpoint to a project.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca endpoint project list¶
List projects an endpoint is bound to.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 endpoint project remove¶
Drop an endpoint↔project binding.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca endpoint set¶
Update an endpoint.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--url |
text | New URL. | None |
--interface |
choice (public | internal | admin) |
New interface type. | None |
--region |
text | New region ID. | None |
--enable / --disable |
boolean | Enable or disable. | None |
--help |
boolean | Show this message and exit. | False |
orca endpoint show¶
Show endpoint details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 endpoint-group¶
Manage Keystone endpoint groups.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca endpoint-group add-project¶
Associate a project with an endpoint group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca endpoint-group create¶
Create an endpoint group.
OSC-style: endpoint-group create my-eg --filter ....
Legacy: endpoint-group create --name my-eg --filter ....
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Endpoint group name (alternative to positional NAME). | None |
--filter |
text | Filter criterion (e.g. service_id=xxx). Repeatable. | Sentinel.UNSET |
--description |
text | Description. | `` |
--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 endpoint-group delete¶
Delete an endpoint group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca endpoint-group list¶
List endpoint groups.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 endpoint-group project¶
Manage project membership of an endpoint group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca endpoint-group project add¶
Associate a project with an endpoint group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca endpoint-group project remove¶
Remove a project from an endpoint group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca endpoint-group remove-project¶
Remove a project from an endpoint group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca endpoint-group set¶
Update an endpoint group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | N/A | None |
--description |
text | N/A | None |
--filter |
text | N/A | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca endpoint-group show¶
Show an endpoint group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 event¶
Browse instance actions and events (Nova).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca event all¶
List recent instance actions across ALL servers.
Fetches all servers, then gathers their actions, merges, and sorts by start time (newest first).
Examples: orca event all orca event all --limit 20 orca event all --action create
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--limit |
integer | Max number of events to display. | 50 |
--action |
text | Filter by action type (e.g. create, delete). | 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 event list¶
List instance actions for a server.
Examples:
orca event list
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 event show¶
Show details for a single instance action, including sub-events.
Examples:
orca event show
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 event timeline¶
Show a chronological timeline of all actions for a server.
Renders a Rich Tree with each action as a branch and sub-events as leaves.
Examples:
orca event timeline
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca export¶
Export project infrastructure as YAML/JSON.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--output, -o |
text | Output file path (default: stdout). | None |
--resources, -r |
text | Comma-separated resource types to export (default: all). | None |
--format, -f |
choice (yaml | json) |
Output format. | yaml |
--help |
boolean | Show this message and exit. | False |
orca extension¶
List or inspect API extensions enabled on this cloud.
Currently surfaces Neutron extensions (the most actively used). OSC's
cross-service openstack extension list aggregates several services
— orca focuses on Neutron because that's where the meaningful
discoverability lives (port-forwarding, metering, segment-range,
QoS rule types, RBAC scopes, …).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca extension list¶
List enabled Neutron extensions.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 extension show¶
Show details of a single Neutron extension by alias.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 federation-protocol¶
Manage Keystone federation protocols.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca federation-protocol create¶
Create a federation protocol.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--mapping-id |
text | Mapping ID to associate. | Sentinel.UNSET |
--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 federation-protocol delete¶
Delete a federation protocol.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca federation-protocol list¶
List federation protocols for an identity provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 federation-protocol set¶
Update a federation protocol.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--mapping-id |
text | New mapping ID. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca federation-protocol show¶
Show a federation protocol.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 find¶
Universal search across every OpenStack resource.
Matches the query (case-insensitive substring) against IDs, names, IPs, CIDRs, fingerprints, MAC addresses, and device references.
Examples: orca find 10.0.0.5 # who uses this IP? orca find web # anything matching 'web' orca find abc12345 # by partial UUID orca find 10.0.0.5 -t ports -t servers
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type, -t |
choice (servers | ports | floatingips | volumes | networks | subnets | security_groups | routers | images | keypairs) |
Restrict search to one or more resource types (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca flavor¶
Manage flavors.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca flavor access¶
Manage per-project access on private flavors.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca flavor access add¶
Grant a project access to a private flavor.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca flavor access list¶
List projects that have access to a private flavor.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 flavor access remove¶
Revoke a project's access to a private flavor.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca flavor access-add¶
Grant a project access to a private flavor.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca flavor access-list¶
List projects that have access to a private flavor.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 flavor access-remove¶
Revoke a project's access to a private flavor.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca flavor create¶
Create a flavor.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--vcpus |
integer | Number of vCPUs. | Sentinel.UNSET |
--ram |
integer | RAM in MB. | Sentinel.UNSET |
--disk |
integer | Root disk size in GB. | 0 |
--ephemeral |
integer | Ephemeral disk in GB. | 0 |
--swap |
integer | Swap disk in MB. | 0 |
--rxtx-factor |
float | RX/TX factor. | 1.0 |
--public / --private |
boolean | Make flavor public or private. | True |
--id |
text | Flavor ID (auto-generated if 'auto'). | auto |
--help |
boolean | Show this message and exit. | False |
orca flavor delete¶
Delete a flavor.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca flavor list¶
List available flavors.
With no --limit the command auto-paginates through all flavors using
the Nova marker cursor (useful on clouds exposing hundreds of flavors).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--limit |
integer | Max flavors to return. Omit for all (auto-paginates). | 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 flavor set¶
Set extra specs on a flavor.
Examples:
orca flavor set
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--property |
text | Extra spec key=value (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca flavor show¶
Show flavor details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 flavor unset¶
Unset extra specs from a flavor.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--property |
text | Extra spec key to remove (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca floating-ip¶
Manage floating IPs.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca floating-ip associate¶
Associate a floating IP with a port.
Examples:
orca floating-ip associate
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--port-id |
text | Port ID to associate with. | Sentinel.UNSET |
--fixed-ip |
text | Fixed IP on the port (if multiple). | None |
--help |
boolean | Show this message and exit. | False |
orca floating-ip bulk-release¶
Bulk-release floating IPs to free up unused addresses.
By default releases all IPs with status DOWN. Use --unassociated to release all IPs not attached to any port. Combine both for maximum cleanup.
Examples: orca floating-ip bulk-release # release all DOWN orca floating-ip bulk-release --status ERROR # release all ERROR orca floating-ip bulk-release -u # release all unassociated orca floating-ip bulk-release -u -y # auto-confirm
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--status, -s |
text | Release floating IPs with this status (DOWN, ERROR, etc.). | DOWN |
--unassociated, -u |
boolean | Release all unassociated floating IPs (no port_id), regardless of status. | False |
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca floating-ip create¶
Allocate a floating IP from an external network.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--network |
text | External network ID. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca floating-ip delete¶
Release a floating IP.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca floating-ip disassociate¶
Disassociate a floating IP from its port.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca floating-ip list¶
List floating IPs.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 floating-ip pool¶
Inspect the pools (external networks) that floating IPs can come from.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca floating-ip pool list¶
List external networks usable as floating-IP pools.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 floating-ip port-forwarding¶
Manage port-forwarding rules attached to a floating IP.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca floating-ip port-forwarding create¶
Create a port-forwarding rule.
Example:
orca floating-ip port-forwarding create
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--internal-port-id |
text | Port to forward traffic to. | Sentinel.UNSET |
--internal-ip-address |
text | Fixed IP of the internal port to target. | Sentinel.UNSET |
--internal-port |
integer | Internal TCP/UDP port. | Sentinel.UNSET |
--external-port |
integer | External TCP/UDP port (on the floating IP). | Sentinel.UNSET |
--protocol |
choice (tcp | udp) |
N/A | tcp |
--description |
text | Free-text description. | None |
--help |
boolean | Show this message and exit. | False |
orca floating-ip port-forwarding delete¶
Delete a port-forwarding rule.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca floating-ip port-forwarding list¶
List port-forwarding rules on a floating IP.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 floating-ip port-forwarding set¶
Update a port-forwarding rule.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--internal-port-id |
text | N/A | None |
--internal-ip-address |
text | N/A | None |
--internal-port |
integer | N/A | None |
--external-port |
integer | N/A | None |
--protocol |
choice (tcp | udp) |
N/A | None |
--description |
text | N/A | None |
--help |
boolean | Show this message and exit. | False |
orca floating-ip port-forwarding show¶
Show a port-forwarding rule.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 floating-ip set¶
Set floating IP properties.
Examples:
orca floating-ip set
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--port |
text | Associate with port ID. | None |
--fixed-ip-address |
text | Fixed IP on the port (if multiple). | None |
--description |
text | Set description. | None |
--qos-policy |
text | Attach QoS policy ID. | None |
--no-qos-policy |
boolean | Remove attached QoS policy. | False |
--help |
boolean | Show this message and exit. | False |
orca floating-ip show¶
Show floating IP details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 floating-ip unset¶
Unset floating IP properties.
Examples:
orca floating-ip unset
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--port |
boolean | Disassociate port. | False |
--qos-policy |
boolean | Remove QoS policy. | False |
--help |
boolean | Show this message and exit. | False |
orca group¶
Manage groups (Keystone v3).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca group add-user¶
Add a user to a group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca group create¶
Create a group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | N/A | None |
--domain |
text | N/A | None |
--help |
boolean | Show this message and exit. | False |
orca group delete¶
Delete a group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca group list¶
List groups.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--domain |
text | Filter by domain ID. | 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 group member¶
Inspect users belonging to a group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca group member list¶
List users in a group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 group member-list¶
List users in a group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 group remove-user¶
Remove a user from a group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca group set¶
Update a group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | N/A | None |
--description |
text | N/A | None |
--help |
boolean | Show this message and exit. | False |
orca group show¶
Show group details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 group user¶
Manage user membership of a group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca group user add¶
Add a user to a group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca group user remove¶
Remove a user from a group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca hypervisor¶
Manage hypervisors (Nova).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca hypervisor list¶
List hypervisors.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 hypervisor show¶
Show hypervisor details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 hypervisor stats¶
Aggregate hypervisor statistics across the cluster.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca hypervisor stats show¶
Show cluster-wide hypervisor stats (vCPUs, RAM, disk, running VMs).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 hypervisor usage¶
Show fill rate per hypervisor, sorted by load.
Combines vCPU, RAM and disk usage into a per-host 'score' (the worst dimension) so the most-saturated hypervisors surface at the top.
Color thresholds: Green < 70% — comfortable headroom Yellow 70–90% — monitor closely Red ≥ 90% — critical
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--sort-by |
choice (cpu | ram | disk | max | vms) |
Metric to sort by. 'max' picks the worst of CPU/RAM/disk per host. | max |
--reverse |
boolean | Sort least-loaded first (default: most-loaded first). | False |
--threshold |
integer range (between 0 and 100) |
Only show hypervisors whose 'max' fill rate is ≥ this percentage. | 0 |
--top |
integer | Show only the top N hypervisors after sorting. | 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 identity-provider¶
Manage Keystone identity providers (federation).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca identity-provider create¶
Create an identity provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--remote-id |
text | Remote entity ID. Repeatable. | Sentinel.UNSET |
--description |
text | Description. | `` |
--domain-id |
text | Domain to associate. | None |
--enable / --disable |
boolean | N/A | True |
--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 identity-provider delete¶
Delete an identity provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca identity-provider list¶
List identity providers.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 identity-provider set¶
Update an identity provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | N/A | None |
--enable / --disable |
boolean | N/A | None |
--remote-id |
text | N/A | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca identity-provider show¶
Show an identity provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 image¶
Manage images.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image add¶
OSC parity verbs (image add project …).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image add create¶
Share an image with a project (sets status to 'pending').
The project must then run 'orca image member-set --status accepted' to confirm acceptance.
Example:
orca image member-create
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image cache¶
Manage the Glance image cache (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image cache clear¶
Clear the entire image cache (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca image cache delete¶
Remove a specific image from the cache (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca image cache list¶
List cached and queued images (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 image cache queue¶
Queue an image for pre-caching (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image cache-clear¶
Clear the entire image cache (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca image cache-delete¶
Remove a specific image from the cache (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca image cache-list¶
List cached and queued images (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 image cache-queue¶
Queue an image for pre-caching (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image create¶
Create a new image (and optionally upload data).
Examples: orca image create my-image orca image create my-image --file ubuntu.qcow2 orca image create my-image --disk-format raw --file disk.img orca image create my-image --property os_distro=ubuntu \ --property os_version=24.04 \ --property hw_qemu_guest_agent=yes
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--disk-format |
choice (raw | qcow2 | vmdk | vdi | vhd | vhdx | iso | aki | ari | ami) |
Disk format. | qcow2 |
--container-format |
choice (bare | ovf | ova | aki | ari | ami | docker) |
Container format. | bare |
--min-disk |
integer | Min disk (GB). | 0 |
--min-ram |
integer | Min RAM (MB). | 0 |
--visibility |
choice (private | shared | community | public) |
Visibility. | private |
--file |
path | Upload image data from file immediately. | None |
--property |
text | Custom image property to set on creation (e.g. os_distro=ubuntu). Repeatable. Values may contain '='; only the first '=' splits. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca image deactivate¶
Deactivate an image (make data unavailable).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image delete¶
Delete an image.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca image download¶
Download image data to a local file.
Supports large files — streams to disk without loading into memory.
Examples:
orca image download
Note: Snapshots taken with 'orca server image create' on a boot-from-volume instance return 0 bytes — they are Glance shells pointing at a Cinder snapshot. Use 'orca volume upload-to-image' to materialize the underlying volume as a real, downloadable image first.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--output, -o |
path | Output file path. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca image download¶
Download image data to a local file.
Supports large files — streams to disk without loading into memory.
Examples:
orca image download
Note: Snapshots taken with 'orca server image create' on a boot-from-volume instance return 0 bytes — they are Glance shells pointing at a Cinder snapshot. Use 'orca volume upload-to-image' to materialize the underlying volume as a real, downloadable image first.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--output, -o |
path | Output file path. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca image import¶
Import image data using the Glance v2 import API.
Methods: web-download Pull image from a public URI (requires --uri) glance-direct Finalise an image whose binary was already staged copy-image Copy image data across stores (requires --store)
Examples:
orca image import
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--method |
choice (web-download | glance-direct | copy-image) |
Import method. | web-download |
--uri |
text | Source URI (required for web-download). | None |
--store |
text | Target store(s) for copy-image (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca image info¶
Inspect Glance-advertised capabilities (stores, import methods).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image info import¶
List Glance image-import methods enabled on this cloud.
Equivalent to openstack image import info.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 image list¶
List available images.
Examples: orca image list orca image list --visibility public orca image list --visibility shared -f value -c ID -c Name
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--visibility |
choice (public | private | shared | community | all) |
Filter by image visibility. Glance defaults to 'all' the caller can see. | all |
--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 image member¶
Manage Glance image members (sharing).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image member create¶
Share an image with a project (sets status to 'pending').
The project must then run 'orca image member-set --status accepted' to confirm acceptance.
Example:
orca image member-create
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image member delete¶
Revoke a project's access to a shared image.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca image member list¶
List all projects that have access to a shared image.
The image must have visibility=shared.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 image member set¶
Accept, reject, or reset a shared image invitation.
Run this as the receiving project to accept or reject sharing.
Examples:
orca image member-set
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--status |
choice (accepted | rejected | pending) |
New membership status. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca image member show¶
Show a specific project's membership status for a shared image.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 image member show¶
Show a specific project's membership status for a shared image.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 image member-create¶
Share an image with a project (sets status to 'pending').
The project must then run 'orca image member-set --status accepted' to confirm acceptance.
Example:
orca image member-create
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image member-delete¶
Revoke a project's access to a shared image.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca image member-list¶
List all projects that have access to a shared image.
The image must have visibility=shared.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 image member-set¶
Accept, reject, or reset a shared image invitation.
Run this as the receiving project to accept or reject sharing.
Examples:
orca image member-set
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--status |
choice (accepted | rejected | pending) |
New membership status. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca image member-show¶
Show a specific project's membership status for a shared image.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 image metadef¶
Manage Glance metadata definitions (namespaces, objects, properties).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image metadef namespace¶
Manage metadef namespaces.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image metadef namespace create¶
Create a metadef namespace.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--display-name |
text | Human-readable name. | None |
--description |
text | Description. | None |
--visibility |
choice (private | public) |
N/A | private |
--protected |
boolean | Prevent deletion via API. | False |
--help |
boolean | Show this message and exit. | False |
orca image metadef namespace delete¶
Delete a metadef namespace (and all its objects/properties).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca image metadef namespace list¶
List metadef namespaces.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 image metadef namespace set¶
Update a metadef namespace.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--display-name |
text | N/A | None |
--description |
text | N/A | None |
--visibility |
choice (private | public) |
N/A | None |
--protected / --no-protected |
boolean | N/A | None |
--help |
boolean | Show this message and exit. | False |
orca image metadef namespace show¶
Show namespace details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image metadef object¶
Manage metadef objects within a namespace.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image metadef object create¶
Create a metadef object (a grouping of related properties).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | N/A | None |
--required |
text | Required property name (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca image metadef object delete¶
Delete a metadef object.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca image metadef object list¶
List objects in a namespace.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 image metadef object property¶
Inspect a property nested inside a metadef object.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
# orca image metadef object property show¶
Show one property nested inside a metadef object.
Equivalent to openstack image metadef object property show.
Glance returns the property as a key inside the object's
properties dict — we resolve it client-side.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 image metadef object show¶
Show a metadef object.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image metadef object update¶
Update a metadef object.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | N/A | None |
--required |
text | Replace required list (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca image metadef property¶
Manage metadef properties within a namespace.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image metadef property create¶
Define a property schema in a namespace.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (string | integer | number | boolean | array) |
JSON Schema type. | Sentinel.UNSET |
--title |
text | N/A | None |
--description |
text | N/A | None |
--default |
text | N/A | None |
--help |
boolean | Show this message and exit. | False |
orca image metadef property delete¶
Delete a metadef property.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca image metadef property list¶
List properties in a namespace.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 image metadef property set¶
Update a metadef property.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (string | integer | number | boolean | array) |
N/A | None |
--title |
text | N/A | None |
--description |
text | N/A | None |
--default |
text | N/A | None |
--help |
boolean | Show this message and exit. | False |
orca image metadef property show¶
Show a metadef property's schema.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image metadef resource-type¶
Inspect Glance resource types and their namespace associations.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image metadef resource-type association-create¶
Associate a resource type with a namespace.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--prefix |
text | Property prefix (e.g. 'hw_'). | None |
--help |
boolean | Show this message and exit. | False |
orca image metadef resource-type association-delete¶
Remove a resource type association from a namespace.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca image metadef resource-type association-list¶
List resource type associations on a namespace.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 image metadef resource-type list¶
List all Glance resource types globally.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 image reactivate¶
Reactivate a deactivated image.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image remove¶
OSC parity verbs (image remove project …).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image remove delete¶
Revoke a project's access to a shared image.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca image share-and-accept¶
Share an image with a project and immediately accept on their behalf (admin mode).
Combines member-create + member-set --status accepted in one step.
Requires admin credentials or the ability to act on behalf of both projects.
Example:
orca image share-and-accept
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca image show¶
Show image details, including custom properties and integrity hashes.
Custom properties (anything outside the Glance v2 standard schema, e.g.
os_distro, os_version, hw_qemu_guest_agent) are surfaced separately:
table → rendered as a "Properties" sub-table after the main table
json → nested under a top-level "properties" key
value → printed after the standard fields, one KEY VALUE per line
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 image shrink¶
Convert a raw image to qcow2 with compression to save space.
Downloads the image, converts it locally via qemu-img convert,
then uploads the compressed result as a new image. The original is
deactivated (not deleted) so you can verify before removing it.
Requires qemu-img to be installed locally.
Examples:
orca image shrink
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca image stage¶
Upload image data to the staging area (interruptible import).
Uploads binary data to /v2/images/{id}/stage without activating the image. After staging, run:
orca image import
to complete the import. Requires Glance ≥ 16.0 (Queens) and API v2.6+.
Example:
orca image stage
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image stores¶
Inspect Glance multi-store backends.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image stores info¶
List available Glance storage backends (multi-store only).
Example: orca image stores-info orca image stores-info --detail
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--detail |
boolean | Show store properties (admin only, requires Glance ≥ 2.15). | False |
--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 image stores info¶
List available Glance storage backends (multi-store only).
Example: orca image stores-info orca image stores-info --detail
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--detail |
boolean | Show store properties (admin only, requires Glance ≥ 2.15). | False |
--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 image stores-info¶
List available Glance storage backends (multi-store only).
Example: orca image stores-info orca image stores-info --detail
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--detail |
boolean | Show store properties (admin only, requires Glance ≥ 2.15). | False |
--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 image tag¶
Manage tags on a Glance image.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image tag add¶
Add a tag to an image.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image tag delete¶
Remove a tag from an image.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image tag-add¶
Add a tag to an image.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image tag-delete¶
Remove a tag from an image.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image task¶
Inspect Glance import / task queue.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca image task list¶
List Glance async tasks.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (import | export | clone) |
Filter by task type. | None |
--status |
choice (pending | processing | success | failure) |
Filter by task status. | 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 image task show¶
Show details of a Glance async task.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 image task-list¶
List Glance async tasks.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (import | export | clone) |
Filter by task type. | None |
--status |
choice (pending | processing | success | failure) |
Filter by task status. | 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 image task-show¶
Show details of a Glance async task.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 image unused¶
Find images not used by any server instance.
Cross-references Glance images with Nova servers to identify images that no running or stopped instance references. By default snapshots are excluded from the scan.
Examples: orca image unused # dry-run orca image unused --delete # interactive delete orca image unused --delete -y # auto-confirm orca image unused --include-snapshots # include snapshot images
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--delete, -d |
boolean | Actually delete unused images. | False |
--yes, -y |
boolean | Skip confirmation (with --delete). | False |
--include-snapshots |
boolean | Include snapshot images in the scan. | False |
--help |
boolean | Show this message and exit. | False |
orca image update¶
Update image properties (JSON-Patch).
Builds one atomic JSON-Patch document from all flags. --property emits
add when the key is absent and replace when it already exists, so
untouched properties survive. --remove-property is strict by default
and turns idempotent under --ignore-missing.
Examples:
orca image update
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--min-disk |
integer | New min disk (GB). | None |
--min-ram |
integer | New min RAM (MB). | None |
--visibility |
choice (private | shared | community | public) |
New visibility. | None |
--property |
text | Set or replace a custom image property (KEY=VALUE). Repeatable. Untouched properties are preserved. | Sentinel.UNSET |
--remove-property |
text | Remove a custom image property by key. Repeatable. Errors if the key is absent (use --ignore-missing for idempotent runs). | Sentinel.UNSET |
--ignore-missing |
boolean | With --remove-property: silently skip keys that aren't on the image. | False |
--help |
boolean | Show this message and exit. | False |
orca image update¶
Update image properties (JSON-Patch).
Builds one atomic JSON-Patch document from all flags. --property emits
add when the key is absent and replace when it already exists, so
untouched properties survive. --remove-property is strict by default
and turns idempotent under --ignore-missing.
Examples:
orca image update
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--min-disk |
integer | New min disk (GB). | None |
--min-ram |
integer | New min RAM (MB). | None |
--visibility |
choice (private | shared | community | public) |
New visibility. | None |
--property |
text | Set or replace a custom image property (KEY=VALUE). Repeatable. Untouched properties are preserved. | Sentinel.UNSET |
--remove-property |
text | Remove a custom image property by key. Repeatable. Errors if the key is absent (use --ignore-missing for idempotent runs). | Sentinel.UNSET |
--ignore-missing |
boolean | With --remove-property: silently skip keys that aren't on the image. | False |
--help |
boolean | Show this message and exit. | False |
orca image update¶
Update image properties (JSON-Patch).
Builds one atomic JSON-Patch document from all flags. --property emits
add when the key is absent and replace when it already exists, so
untouched properties survive. --remove-property is strict by default
and turns idempotent under --ignore-missing.
Examples:
orca image update
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--min-disk |
integer | New min disk (GB). | None |
--min-ram |
integer | New min RAM (MB). | None |
--visibility |
choice (private | shared | community | public) |
New visibility. | None |
--property |
text | Set or replace a custom image property (KEY=VALUE). Repeatable. Untouched properties are preserved. | Sentinel.UNSET |
--remove-property |
text | Remove a custom image property by key. Repeatable. Errors if the key is absent (use --ignore-missing for idempotent runs). | Sentinel.UNSET |
--ignore-missing |
boolean | With --remove-property: silently skip keys that aren't on the image. | False |
--help |
boolean | Show this message and exit. | False |
orca image upload¶
Upload image data from a local file.
The image must already exist and be in 'queued' status.
Supports large files — streams from disk without loading into memory.
Examples:
orca image upload
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca ip¶
IP address utilities.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca ip whois¶
Find which resource owns a given IP address.
Searches across floating IPs, ports, subnets, routers, servers and load-balancers to resolve who is using the address.
Examples: orca ip whois 10.0.0.15 orca ip whois 203.0.113.42
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca ip-availability¶
Inspect IP availability across networks (admin).
Reports allocated vs total addresses per subnet — useful for sizing planning before quota changes.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca ip-availability list¶
List IP availability across networks.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--network-id |
text | Filter by network ID. | None |
--ip-version |
choice (4 | 6) |
Filter by IP version. | 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 ip-availability show¶
Show IP availability for a network (with subnet breakdown).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 keypair¶
Manage SSH key pairs.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca keypair create¶
Generate a new key pair.
OpenStack generates both keys. The private key is returned ONCE and saved locally. The public key is stored server-side.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--save-to |
path | Path to save the private key. Default: ~/.ssh/ |
None |
--help |
boolean | Show this message and exit. | False |
orca keypair delete¶
Delete a key pair.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca keypair generate¶
Generate a key pair locally and upload the public key.
The private key NEVER leaves your machine.
Examples: orca keypair generate my-key orca keypair generate my-key --type rsa --bits 4096
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (ed25519 | rsa | ecdsa) |
Key algorithm. | ed25519 |
--bits |
integer | Key size (RSA only, default 4096). | None |
--save-to |
path | Private key path. Default: ~/.ssh/orca- |
None |
--help |
boolean | Show this message and exit. | False |
orca keypair list¶
List key pairs.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 keypair show¶
Show key pair details (fingerprint & public key).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 keypair upload¶
Import an existing public key.
Examples: orca keypair upload my-key --public-key-file ~/.ssh/id_ed25519.pub orca keypair upload my-key --public-key "ssh-ed25519 AAAA..."
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--public-key-file |
path | Path to public key file. Default: ~/.ssh/id_rsa.pub | None |
--public-key |
text | Public key content as string (e.g. 'ssh-rsa AAAA...'). | None |
--help |
boolean | Show this message and exit. | False |
orca limit¶
Manage Keystone project-level resource limits.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca limit create¶
Create a project-level limit.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--project-id |
text | Project ID. | Sentinel.UNSET |
--service-id |
text | Service ID. | Sentinel.UNSET |
--resource-name |
text | Resource name. | Sentinel.UNSET |
--resource-limit |
integer | Limit value. | Sentinel.UNSET |
--region-id |
text | Region ID. | None |
--description |
text | Description. | `` |
--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 limit delete¶
Delete a project-level limit.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca limit list¶
List limits.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--service-id |
text | Filter by service ID. | None |
--region-id |
text | Filter by region ID. | None |
--resource-name |
text | Filter by resource name. | None |
--project-id |
text | Filter by project ID. | 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 limit set¶
Update a project-level limit.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--resource-limit |
integer | New limit value. | None |
--description |
text | N/A | None |
--help |
boolean | Show this message and exit. | False |
orca limit show¶
Show a limit.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 limits¶
Show compute limits and quotas.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca limits show¶
Show compute quotas and current usage for this project.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--project |
text | Show limits for a specific project (admin). | None |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer¶
Manage load balancers, listeners, pools & members (Octavia).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca loadbalancer amphora¶
Manage Octavia amphorae (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca loadbalancer amphora failover¶
Trigger a failover for an amphora (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer amphora list¶
List amphora (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--lb-id |
text | Filter by load balancer ID. | None |
--status |
text | Filter by amphora status. | 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 loadbalancer amphora show¶
Show amphora details (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer amphora-failover¶
Trigger a failover for an amphora (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer amphora-list¶
List amphora (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--lb-id |
text | Filter by load balancer ID. | None |
--status |
text | Filter by amphora status. | 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 loadbalancer amphora-show¶
Show amphora details (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer create¶
Create a load balancer.
Examples:
orca loadbalancer create my-lb --subnet-id
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--subnet-id |
text | VIP subnet ID. | Sentinel.UNSET |
--description |
text | Description. | `` |
--provider |
text | Provider (e.g. amphora, ovn). | None |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer delete¶
Delete a load balancer.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--cascade |
boolean | Delete LB and all child resources. | False |
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer healthmonitor¶
Manage Octavia health monitors.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca loadbalancer healthmonitor create¶
Create a health monitor.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--pool-id |
text | Pool ID. | Sentinel.UNSET |
--type |
choice (HTTP | HTTPS | PING | TCP | TLS-HELLO | UDP-CONNECT) |
N/A | Sentinel.UNSET |
--delay |
integer | Probe interval (seconds). | Sentinel.UNSET |
--timeout |
integer | Probe timeout (seconds). | Sentinel.UNSET |
--max-retries |
integer | Max retries (1-10). | 3 |
--url-path |
text | HTTP URL path to probe. | / |
--expected-codes |
text | Expected HTTP codes. | 200 |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer healthmonitor delete¶
Delete a health monitor.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer healthmonitor list¶
List health monitors.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer healthmonitor set¶
Update a health monitor.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--delay |
integer | Probe interval (seconds). | None |
--timeout |
integer | Probe timeout (seconds). | None |
--max-retries |
integer | Max retries. | None |
--url-path |
text | HTTP URL path to probe. | None |
--expected-codes |
text | Expected HTTP codes. | None |
--enable / --disable |
boolean | Enable or disable the health monitor. | None |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer healthmonitor show¶
Show health monitor details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer healthmonitor-create¶
Create a health monitor.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--pool-id |
text | Pool ID. | Sentinel.UNSET |
--type |
choice (HTTP | HTTPS | PING | TCP | TLS-HELLO | UDP-CONNECT) |
N/A | Sentinel.UNSET |
--delay |
integer | Probe interval (seconds). | Sentinel.UNSET |
--timeout |
integer | Probe timeout (seconds). | Sentinel.UNSET |
--max-retries |
integer | Max retries (1-10). | 3 |
--url-path |
text | HTTP URL path to probe. | / |
--expected-codes |
text | Expected HTTP codes. | 200 |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer healthmonitor-delete¶
Delete a health monitor.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer healthmonitor-list¶
List health monitors.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer healthmonitor-set¶
Update a health monitor.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--delay |
integer | Probe interval (seconds). | None |
--timeout |
integer | Probe timeout (seconds). | None |
--max-retries |
integer | Max retries. | None |
--url-path |
text | HTTP URL path to probe. | None |
--expected-codes |
text | Expected HTTP codes. | None |
--enable / --disable |
boolean | Enable or disable the health monitor. | None |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer healthmonitor-show¶
Show health monitor details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer l7policy¶
Manage Octavia L7 policies (compound noun).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca loadbalancer l7policy create¶
Create an L7 policy.
Examples:
orca loadbalancer l7policy-create --listener-id
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--listener-id |
text | Listener to attach the policy to. | Sentinel.UNSET |
--action |
choice (REDIRECT_TO_POOL | REDIRECT_TO_URL | REJECT | REDIRECT_PREFIX) |
Policy action. | Sentinel.UNSET |
--name |
text | Policy name. | None |
--description |
text | Description. | None |
--position |
integer | Policy position (order). | None |
--redirect-pool-id |
text | Pool to redirect to (REDIRECT_TO_POOL). | None |
--redirect-url |
text | URL to redirect to (REDIRECT_TO_URL). | None |
--redirect-prefix |
text | URL prefix to redirect to (REDIRECT_PREFIX). | None |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer l7policy delete¶
Delete an L7 policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer l7policy list¶
List L7 policies.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer l7policy set¶
Update an L7 policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--action |
choice (REDIRECT_TO_POOL | REDIRECT_TO_URL | REJECT | REDIRECT_PREFIX) |
New action. | None |
--position |
integer | New position. | None |
--redirect-pool-id |
text | New redirect pool ID. | None |
--redirect-url |
text | New redirect URL. | None |
--enable / --disable |
boolean | Enable or disable. | None |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer l7policy show¶
Show L7 policy details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer l7policy-create¶
Create an L7 policy.
Examples:
orca loadbalancer l7policy-create --listener-id
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--listener-id |
text | Listener to attach the policy to. | Sentinel.UNSET |
--action |
choice (REDIRECT_TO_POOL | REDIRECT_TO_URL | REJECT | REDIRECT_PREFIX) |
Policy action. | Sentinel.UNSET |
--name |
text | Policy name. | None |
--description |
text | Description. | None |
--position |
integer | Policy position (order). | None |
--redirect-pool-id |
text | Pool to redirect to (REDIRECT_TO_POOL). | None |
--redirect-url |
text | URL to redirect to (REDIRECT_TO_URL). | None |
--redirect-prefix |
text | URL prefix to redirect to (REDIRECT_PREFIX). | None |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer l7policy-delete¶
Delete an L7 policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer l7policy-list¶
List L7 policies.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer l7policy-set¶
Update an L7 policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--action |
choice (REDIRECT_TO_POOL | REDIRECT_TO_URL | REJECT | REDIRECT_PREFIX) |
New action. | None |
--position |
integer | New position. | None |
--redirect-pool-id |
text | New redirect pool ID. | None |
--redirect-url |
text | New redirect URL. | None |
--enable / --disable |
boolean | Enable or disable. | None |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer l7policy-show¶
Show L7 policy details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer l7rule¶
Manage Octavia L7 rules (compound noun).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca loadbalancer l7rule create¶
Create an L7 rule.
Examples:
orca loadbalancer l7rule-create
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (COOKIE | FILE_TYPE | HEADER | HOST_NAME | PATH | SSL_CONN_HAS_CERT | SSL_VERIFY_RESULT | SSL_DN_FIELD) |
Rule type. | Sentinel.UNSET |
--compare-type |
choice (CONTAINS | ENDS_WITH | EQUAL_TO | REGEX | STARTS_WITH) |
Comparison type. | Sentinel.UNSET |
--value |
text | Value to compare against. | Sentinel.UNSET |
--key |
text | Key (for HEADER, COOKIE rules). | None |
--invert |
boolean | Invert the match result. | False |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer l7rule delete¶
Delete an L7 rule.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer l7rule list¶
List L7 rules for a policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer l7rule set¶
Update an L7 rule.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (COOKIE | FILE_TYPE | HEADER | HOST_NAME | PATH | SSL_CONN_HAS_CERT | SSL_VERIFY_RESULT | SSL_DN_FIELD) |
New rule type. | None |
--compare-type |
choice (CONTAINS | ENDS_WITH | EQUAL_TO | REGEX | STARTS_WITH) |
New comparison type. | None |
--value |
text | New value. | None |
--key |
text | New key. | None |
--invert / --no-invert |
boolean | Invert match. | None |
--enable / --disable |
boolean | Enable or disable the rule. | None |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer l7rule show¶
Show L7 rule details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer l7rule-create¶
Create an L7 rule.
Examples:
orca loadbalancer l7rule-create
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (COOKIE | FILE_TYPE | HEADER | HOST_NAME | PATH | SSL_CONN_HAS_CERT | SSL_VERIFY_RESULT | SSL_DN_FIELD) |
Rule type. | Sentinel.UNSET |
--compare-type |
choice (CONTAINS | ENDS_WITH | EQUAL_TO | REGEX | STARTS_WITH) |
Comparison type. | Sentinel.UNSET |
--value |
text | Value to compare against. | Sentinel.UNSET |
--key |
text | Key (for HEADER, COOKIE rules). | None |
--invert |
boolean | Invert the match result. | False |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer l7rule-delete¶
Delete an L7 rule.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer l7rule-list¶
List L7 rules for a policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer l7rule-set¶
Update an L7 rule.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (COOKIE | FILE_TYPE | HEADER | HOST_NAME | PATH | SSL_CONN_HAS_CERT | SSL_VERIFY_RESULT | SSL_DN_FIELD) |
New rule type. | None |
--compare-type |
choice (CONTAINS | ENDS_WITH | EQUAL_TO | REGEX | STARTS_WITH) |
New comparison type. | None |
--value |
text | New value. | None |
--key |
text | New key. | None |
--invert / --no-invert |
boolean | Invert match. | None |
--enable / --disable |
boolean | Enable or disable the rule. | None |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer l7rule-show¶
Show L7 rule details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer list¶
List load balancers.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer listener¶
Manage Octavia listeners.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca loadbalancer listener create¶
Create a listener.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--lb-id |
text | Load balancer ID. | Sentinel.UNSET |
--protocol |
choice (HTTP | HTTPS | TCP | UDP | TERMINATED_HTTPS) |
N/A | Sentinel.UNSET |
--port |
integer | Listen port. | Sentinel.UNSET |
--default-pool-id |
text | Default pool ID. | None |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer listener delete¶
Delete a listener.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer listener list¶
List listeners.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer listener set¶
Update a listener.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--default-pool-id |
text | New default pool ID. | None |
--connection-limit |
integer | Max connections (-1 for unlimited). | None |
--enable / --disable |
boolean | Enable or disable the listener. | None |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer listener show¶
Show listener details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer listener-create¶
Create a listener.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--lb-id |
text | Load balancer ID. | Sentinel.UNSET |
--protocol |
choice (HTTP | HTTPS | TCP | UDP | TERMINATED_HTTPS) |
N/A | Sentinel.UNSET |
--port |
integer | Listen port. | Sentinel.UNSET |
--default-pool-id |
text | Default pool ID. | None |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer listener-delete¶
Delete a listener.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer listener-list¶
List listeners.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer listener-set¶
Update a listener.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--default-pool-id |
text | New default pool ID. | None |
--connection-limit |
integer | Max connections (-1 for unlimited). | None |
--enable / --disable |
boolean | Enable or disable the listener. | None |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer listener-show¶
Show listener details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer member¶
Manage Octavia pool members.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca loadbalancer member add¶
Add a member to a pool.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--address |
text | Member IP address. | Sentinel.UNSET |
--port |
integer | Member port. | Sentinel.UNSET |
--subnet-id |
text | Member subnet ID. | None |
--weight |
integer | Weight (0-256). | 1 |
--name |
text | Member name. | None |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer member list¶
List members in a pool.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer member remove¶
Remove a member from a pool.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer member set¶
Update a pool member.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--weight |
integer | New weight (0-256). | None |
--enable / --disable |
boolean | Enable or disable the member. | None |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer member show¶
Show member details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer member-add¶
Add a member to a pool.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--address |
text | Member IP address. | Sentinel.UNSET |
--port |
integer | Member port. | Sentinel.UNSET |
--subnet-id |
text | Member subnet ID. | None |
--weight |
integer | Weight (0-256). | 1 |
--name |
text | Member name. | None |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer member-list¶
List members in a pool.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer member-remove¶
Remove a member from a pool.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer member-set¶
Update a pool member.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--weight |
integer | New weight (0-256). | None |
--enable / --disable |
boolean | Enable or disable the member. | None |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer member-show¶
Show member details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer pool¶
Manage Octavia pools.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca loadbalancer pool create¶
Create a pool.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--listener-id |
text | Listener ID to attach to. | None |
--lb-id |
text | Load balancer ID (if no listener). | None |
--protocol |
choice (HTTP | HTTPS | PROXY | TCP | UDP) |
N/A | Sentinel.UNSET |
--algorithm |
choice (ROUND_ROBIN | LEAST_CONNECTIONS | SOURCE_IP) |
Load balancing algorithm. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer pool delete¶
Delete a pool.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer pool list¶
List pools.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer pool set¶
Update a pool.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--algorithm |
choice (ROUND_ROBIN | LEAST_CONNECTIONS | SOURCE_IP) |
New LB algorithm. | None |
--enable / --disable |
boolean | Enable or disable the pool. | None |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer pool show¶
Show pool details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer pool-create¶
Create a pool.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--listener-id |
text | Listener ID to attach to. | None |
--lb-id |
text | Load balancer ID (if no listener). | None |
--protocol |
choice (HTTP | HTTPS | PROXY | TCP | UDP) |
N/A | Sentinel.UNSET |
--algorithm |
choice (ROUND_ROBIN | LEAST_CONNECTIONS | SOURCE_IP) |
Load balancing algorithm. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer pool-delete¶
Delete a pool.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer pool-list¶
List pools.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer pool-set¶
Update a pool.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--algorithm |
choice (ROUND_ROBIN | LEAST_CONNECTIONS | SOURCE_IP) |
New LB algorithm. | None |
--enable / --disable |
boolean | Enable or disable the pool. | None |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer pool-show¶
Show pool details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer set¶
Update a load balancer.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--enable / --disable |
boolean | Enable or disable the load balancer. | None |
--help |
boolean | Show this message and exit. | False |
orca loadbalancer show¶
Show load balancer details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer stats¶
Inspect Octavia load-balancer stats.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca loadbalancer stats show¶
Show load balancer statistics.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer stats-show¶
Show load balancer statistics.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 loadbalancer status¶
Inspect Octavia load-balancer status.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca loadbalancer status show¶
Show load balancer operating status tree.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca loadbalancer status-show¶
Show load balancer operating status tree.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca local-ip¶
Manage Neutron local IPs (Yoga+ — tenant-local virtual IPs).
A local IP is a virtual IP allocated within a single project that can be associated with multiple ports for an east-west floating-IP pattern (no SNAT, no L3 router).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca local-ip association¶
Manage local-IP-to-port associations.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca local-ip association create¶
Associate a port with a local IP.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--port-id |
text | Port to associate. | Sentinel.UNSET |
--fixed-ip |
text | Specific fixed IP of the port (autopicked otherwise). | None |
--help |
boolean | Show this message and exit. | False |
orca local-ip association delete¶
Remove a port association from a local IP.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca local-ip association list¶
List port associations on a local IP.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 local-ip create¶
Create a local IP.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--network-id |
text | Local network ID. | Sentinel.UNSET |
--local-port-id |
text | Port ID to anchor the local IP. | None |
--ip-address |
text | Specific IP within the network's CIDR (autopicked otherwise). | None |
--ip-mode |
choice (translate | passthrough) |
Translate (SNAT-like) or passthrough. | None |
--help |
boolean | Show this message and exit. | False |
orca local-ip delete¶
Delete a local IP.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca local-ip list¶
List local IPs.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 local-ip set¶
Update a local IP.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--help |
boolean | Show this message and exit. | False |
orca local-ip show¶
Show a local IP.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 mapping¶
Manage Keystone federation attribute mappings.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca mapping create¶
Create a mapping.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--rules |
text | Mapping rules as a JSON string. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca mapping delete¶
Delete a mapping.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca mapping list¶
List mappings.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 mapping set¶
Update a mapping.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--rules |
text | New rules as JSON. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca mapping show¶
Show a mapping (prints JSON rules).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca metric¶
Query metrics, measures & resources (Gnocchi).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca metric archive-policy¶
Manage Gnocchi archive policies (compound noun).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca metric archive-policy create¶
Create an archive policy.
Example: orca metric archive-policy-create my-policy \ --definition 1m:1440 --definition 1h:720
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--definition |
text | Granularity:points pair (repeatable). E.g. 1m:1440. | Sentinel.UNSET |
--aggregation-method |
text | Aggregation method (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca metric archive-policy delete¶
Delete an archive policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca metric archive-policy list¶
List archive policies.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 metric archive-policy show¶
Show an archive policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 metric archive-policy-create¶
Create an archive policy.
Example: orca metric archive-policy-create my-policy \ --definition 1m:1440 --definition 1h:720
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--definition |
text | Granularity:points pair (repeatable). E.g. 1m:1440. | Sentinel.UNSET |
--aggregation-method |
text | Aggregation method (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca metric archive-policy-delete¶
Delete an archive policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca metric archive-policy-list¶
List archive policies.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 metric archive-policy-show¶
Show an archive policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 metric create¶
Create a Gnocchi metric.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Metric name. | Sentinel.UNSET |
--archive-policy-name |
text | Archive policy to use (default: low). | None |
--resource-id |
text | Resource ID to attach the metric to. | None |
--help |
boolean | Show this message and exit. | False |
orca metric delete¶
Delete a Gnocchi metric.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca metric list¶
List metrics.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--limit |
integer | Max results. | 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 metric measures¶
Read or push measures (samples) on a Gnocchi metric.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca metric measures add¶
Push measures to a metric.
Example:
orca metric measures-add
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--measure |
text | Measure as timestamp:value (repeatable). Timestamp: ISO-8601. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca metric measures show¶
Get measures (datapoints) for a metric.
Examples:
orca metric measures
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--start |
text | Start timestamp (ISO 8601 or relative e.g. -1h). | None |
--stop |
text | Stop timestamp. | None |
--granularity |
text | Granularity in seconds. | None |
--aggregation |
text | Aggregation method. | mean |
--limit |
integer | Max measures to return. | 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 metric measures-add¶
Push measures to a metric.
Example:
orca metric measures-add
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--measure |
text | Measure as timestamp:value (repeatable). Timestamp: ISO-8601. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca metric resource¶
Inspect Gnocchi resources.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca metric resource list¶
List resources.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
text | Resource type to list. | generic |
--limit |
integer | Max results. Gnocchi can return very large datasets without a limit. | 100 |
--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 metric resource show¶
Show resource details and its metrics.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
text | Resource type. | generic |
--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 metric resource-list¶
List resources.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
text | Resource type to list. | generic |
--limit |
integer | Max results. Gnocchi can return very large datasets without a limit. | 100 |
--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 metric resource-show¶
Show resource details and its metrics.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
text | Resource type. | generic |
--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 metric resource-type¶
Inspect Gnocchi resource types (compound noun).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca metric resource-type create¶
Create a Gnocchi resource type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--attribute |
text | Resource attribute key:type (repeatable). E.g. host:string. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca metric resource-type delete¶
Delete a Gnocchi resource type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca metric resource-type list¶
List resource types.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 metric resource-type show¶
Show a Gnocchi resource type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 metric resource-type-create¶
Create a Gnocchi resource type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--attribute |
text | Resource attribute key:type (repeatable). E.g. host:string. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca metric resource-type-delete¶
Delete a Gnocchi resource type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca metric resource-type-list¶
List resource types.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 metric resource-type-show¶
Show a Gnocchi resource type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 metric show¶
Show metric details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 metric status¶
Show Gnocchi processing status.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network¶
Manage networks, subnets, ports & routers.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network agent¶
Manage Neutron agents (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network agent add¶
Bind a network or router to an agent (admin scheduler).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network agent add network¶
Bind a network to a DHCP agent.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network agent add router¶
Bind a router to an L3 agent.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network agent delete¶
Delete a Neutron agent record.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca network agent list¶
List Neutron agents.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--host |
text | Filter by host. | None |
--agent-type |
text | Filter by agent type. | 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 network agent remove¶
Unbind a network or router from an agent (admin scheduler).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network agent remove network¶
Unbind a network from a DHCP agent.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network agent remove router¶
Unbind a router from an L3 agent.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network agent set¶
Update a Neutron agent.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--enable / --disable |
boolean | Enable or disable the agent. | None |
--description |
text | New description. | None |
--help |
boolean | Show this message and exit. | False |
orca network agent show¶
Show a Neutron agent's details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network agent-delete¶
Delete a Neutron agent record.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca network agent-list¶
List Neutron agents.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--host |
text | Filter by host. | None |
--agent-type |
text | Filter by agent type. | 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 network agent-set¶
Update a Neutron agent.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--enable / --disable |
boolean | Enable or disable the agent. | None |
--description |
text | New description. | None |
--help |
boolean | Show this message and exit. | False |
orca network agent-show¶
Show a Neutron agent's details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network auto-allocated-topology¶
Manage the project's auto-allocated topology.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network auto-allocated-topology delete¶
Delete the auto-allocated topology for a project.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--project-id |
text | Project ID (default: current project). | None |
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca network auto-allocated-topology show¶
Show or create the auto-allocated topology for a project.
Examples:
orca network auto-allocated-topology-show
orca network auto-allocated-topology-show --project-id
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--project-id |
text | Project ID (default: current project). | None |
--check-resources |
boolean | Validate resources without creating topology. | False |
--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 network auto-allocated-topology show¶
Show or create the auto-allocated topology for a project.
Examples:
orca network auto-allocated-topology-show
orca network auto-allocated-topology-show --project-id
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--project-id |
text | Project ID (default: current project). | None |
--check-resources |
boolean | Validate resources without creating topology. | False |
--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 network auto-allocated-topology-delete¶
Delete the auto-allocated topology for a project.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--project-id |
text | Project ID (default: current project). | None |
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca network auto-allocated-topology-show¶
Show or create the auto-allocated topology for a project.
Examples:
orca network auto-allocated-topology-show
orca network auto-allocated-topology-show --project-id
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--project-id |
text | Project ID (default: current project). | None |
--check-resources |
boolean | Validate resources without creating topology. | False |
--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 network create¶
Create a network.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--admin-state / --no-admin-state |
boolean | Admin state up. | True |
--shared |
boolean | Shared across projects. | False |
--help |
boolean | Show this message and exit. | False |
orca network delete¶
Delete a network.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca network flavor¶
Manage Neutron service flavors (admin SDN).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network flavor add¶
Attach sub-resources to a network flavor.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network flavor add profile¶
Attach a service profile to a flavor (OSC network flavor add profile).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network flavor create¶
Create a network flavor.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--service-type |
text | Service type (FLAVORS, FIREWALL_V2, …). | Sentinel.UNSET |
--description |
text | N/A | None |
--enabled / --disabled |
boolean | N/A | True |
--help |
boolean | Show this message and exit. | False |
orca network flavor delete¶
Delete a network flavor.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca network flavor list¶
List network flavors.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network flavor remove¶
Detach sub-resources from a network flavor.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network flavor remove profile¶
Detach a service profile from a flavor (OSC network flavor remove profile).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network flavor set¶
Update a network flavor.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | N/A | None |
--description |
text | N/A | None |
--enabled / --disabled |
boolean | N/A | None |
--help |
boolean | Show this message and exit. | False |
orca network flavor show¶
Show a network flavor.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network flavor-profile¶
Manage Neutron service profiles attached to flavors (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network flavor-profile create¶
Create a service profile.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--driver |
text | Backend driver class. | None |
--description |
text | N/A | None |
--metainfo |
text | Free-text JSON the driver consumes. | None |
--enabled / --disabled |
boolean | N/A | True |
--help |
boolean | Show this message and exit. | False |
orca network flavor-profile delete¶
Delete a service profile.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca network flavor-profile list¶
List service profiles.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network flavor-profile set¶
Update a service profile.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | N/A | None |
--enabled / --disabled |
boolean | N/A | None |
--metainfo |
text | N/A | None |
--help |
boolean | Show this message and exit. | False |
orca network flavor-profile show¶
Show a service profile.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network l3-conntrack-helper¶
Manage L3 conntrack helper modules on a router (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network l3-conntrack-helper create¶
Attach a conntrack helper to a router.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--helper |
text | Helper module name (ftp, tftp, sip, h323, …). | Sentinel.UNSET |
--protocol |
choice (tcp | udp) |
N/A | tcp |
--port |
integer | Port the helper listens on. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca network l3-conntrack-helper delete¶
Detach a conntrack helper.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca network l3-conntrack-helper list¶
List conntrack helpers on a router.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network l3-conntrack-helper set¶
Update a conntrack helper (port only — helper/protocol are immutable).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--port |
integer | N/A | None |
--help |
boolean | Show this message and exit. | False |
orca network l3-conntrack-helper show¶
Show a conntrack helper.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network list¶
List networks.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network meter¶
Manage Neutron metering labels (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network meter create¶
Create a metering label.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | N/A | None |
--shared / --unshared |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca network meter delete¶
Delete a metering label.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca network meter list¶
List metering labels.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network meter show¶
Show a metering label.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network meter-rule¶
Manage Neutron metering label rules (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network meter-rule create¶
Create a metering rule.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--label-id |
text | Metering label to attach to. | Sentinel.UNSET |
--direction |
choice (ingress | egress) |
N/A | ingress |
--remote-ip-prefix |
text | CIDR to match (legacy alias of --source-ip-prefix). | None |
--source-ip-prefix |
text | N/A | None |
--destination-ip-prefix |
text | N/A | None |
--excluded |
boolean | Invert the match (exclude this CIDR from accounting). | False |
--help |
boolean | Show this message and exit. | False |
orca network meter-rule delete¶
Delete a metering rule.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca network meter-rule list¶
List metering label rules.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--label-id |
text | Filter by metering label. | 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 network meter-rule show¶
Show a metering rule.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network port¶
Manage Neutron ports.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network port create¶
Create a port.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--network-id |
text | Network ID. | Sentinel.UNSET |
--name |
text | Port name. | None |
--fixed-ip |
text | Fixed IP address. | None |
--help |
boolean | Show this message and exit. | False |
orca network port delete¶
Delete a port.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca network port list¶
List ports.
Examples:
orca network port list
orca network port list --network-id
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--network-id |
text | Filter by network ID. | None |
--subnet-id, --subnet |
text | Filter to ports that have a fixed IP in this subnet. | None |
--device-owner |
text | Filter by device owner (e.g. compute:nova, network:router_interface, network:dhcp). |
None |
--device-id |
text | Filter by the attached resource ID (server, router, ...). | 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 network port show¶
Show port details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network port unset¶
Remove properties from a port.
Examples:
orca network port-unset
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--security-group |
text | Security group ID to remove (repeatable). | Sentinel.UNSET |
--qos-policy |
boolean | Remove the QoS policy from the port. | False |
--description |
boolean | Clear the port description. | False |
--help |
boolean | Show this message and exit. | False |
orca network port update¶
Update a port.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--admin-state / --no-admin-state |
boolean | Admin state. | None |
--help |
boolean | Show this message and exit. | False |
orca network port update¶
Update a port.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--admin-state / --no-admin-state |
boolean | Admin state. | None |
--help |
boolean | Show this message and exit. | False |
orca network port-create¶
Create a port.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--network-id |
text | Network ID. | Sentinel.UNSET |
--name |
text | Port name. | None |
--fixed-ip |
text | Fixed IP address. | None |
--help |
boolean | Show this message and exit. | False |
orca network port-delete¶
Delete a port.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca network port-list¶
List ports.
Examples:
orca network port list
orca network port list --network-id
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--network-id |
text | Filter by network ID. | None |
--subnet-id, --subnet |
text | Filter to ports that have a fixed IP in this subnet. | None |
--device-owner |
text | Filter by device owner (e.g. compute:nova, network:router_interface, network:dhcp). |
None |
--device-id |
text | Filter by the attached resource ID (server, router, ...). | 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 network port-show¶
Show port details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network port-unset¶
Remove properties from a port.
Examples:
orca network port-unset
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--security-group |
text | Security group ID to remove (repeatable). | Sentinel.UNSET |
--qos-policy |
boolean | Remove the QoS policy from the port. | False |
--description |
boolean | Clear the port description. | False |
--help |
boolean | Show this message and exit. | False |
orca network port-update¶
Update a port.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--admin-state / --no-admin-state |
boolean | Admin state. | None |
--help |
boolean | Show this message and exit. | False |
orca network qos¶
Manage Neutron QoS policies and rules.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network qos policy¶
Manage QoS policies.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network qos policy create¶
Create a QoS policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Policy name. | Sentinel.UNSET |
--shared |
boolean | Share with all projects. | False |
--default |
boolean | Set as default policy. | False |
--description |
text | Description. | None |
--help |
boolean | Show this message and exit. | False |
orca network qos policy delete¶
Delete a QoS policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca network qos policy list¶
List QoS policies.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--shared |
boolean | Show only shared policies. | False |
--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 network qos policy set¶
Update a QoS policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--shared / --no-shared |
boolean | Share or un-share. | None |
--default / --no-default |
boolean | Set or unset as default. | None |
--help |
boolean | Show this message and exit. | False |
orca network qos policy show¶
Show a QoS policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network qos policy-create¶
Create a QoS policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Policy name. | Sentinel.UNSET |
--shared |
boolean | Share with all projects. | False |
--default |
boolean | Set as default policy. | False |
--description |
text | Description. | None |
--help |
boolean | Show this message and exit. | False |
orca network qos policy-delete¶
Delete a QoS policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca network qos policy-list¶
List QoS policies.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--shared |
boolean | Show only shared policies. | False |
--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 network qos policy-set¶
Update a QoS policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--shared / --no-shared |
boolean | Share or un-share. | None |
--default / --no-default |
boolean | Set or unset as default. | None |
--help |
boolean | Show this message and exit. | False |
orca network qos policy-show¶
Show a QoS policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network qos rule¶
Manage QoS rules attached to a policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network qos rule create¶
Create a QoS rule.
Examples:
orca qos rule-create
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (bandwidth-limit | dscp-marking | minimum-bandwidth | minimum-packet-rate) |
Rule type. | bandwidth-limit |
--max-kbps |
integer | Maximum bandwidth in kbps (bandwidth-limit). | None |
--max-burst-kbps |
integer | Maximum burst bandwidth in kbps (bandwidth-limit). | None |
--direction |
choice (ingress | egress) |
Traffic direction (bandwidth-limit, minimum-bandwidth). | egress |
--dscp-mark |
integer | DSCP mark value 0-56 (dscp-marking). | None |
--min-kbps |
integer | Minimum bandwidth in kbps (minimum-bandwidth). | None |
--help |
boolean | Show this message and exit. | False |
orca network qos rule delete¶
Delete a QoS rule.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (bandwidth-limit | dscp-marking | minimum-bandwidth | minimum-packet-rate) |
Rule type. | bandwidth-limit |
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca network qos rule list¶
List QoS rules for a policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (bandwidth-limit | dscp-marking | minimum-bandwidth | minimum-packet-rate) |
Rule type. | bandwidth-limit |
--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 network qos rule set¶
Update an existing QoS rule.
Example:
orca qos rule set
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (bandwidth-limit | dscp-marking | minimum-bandwidth | minimum-packet-rate) |
Rule type. | bandwidth-limit |
--max-kbps |
integer | New max bandwidth in kbps (bandwidth-limit). | None |
--max-burst-kbps |
integer | New max burst bandwidth in kbps (bandwidth-limit). | None |
--direction |
choice (ingress | egress) |
New traffic direction (bandwidth-limit, minimum-bandwidth). | None |
--dscp-mark |
integer | New DSCP mark value (dscp-marking). | None |
--min-kbps |
integer | New min bandwidth in kbps (minimum-bandwidth). | None |
--help |
boolean | Show this message and exit. | False |
orca network qos rule show¶
Show details of a QoS rule.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (bandwidth-limit | dscp-marking | minimum-bandwidth | minimum-packet-rate) |
Rule type. | bandwidth-limit |
--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 network qos rule-create¶
Create a QoS rule.
Examples:
orca qos rule-create
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (bandwidth-limit | dscp-marking | minimum-bandwidth | minimum-packet-rate) |
Rule type. | bandwidth-limit |
--max-kbps |
integer | Maximum bandwidth in kbps (bandwidth-limit). | None |
--max-burst-kbps |
integer | Maximum burst bandwidth in kbps (bandwidth-limit). | None |
--direction |
choice (ingress | egress) |
Traffic direction (bandwidth-limit, minimum-bandwidth). | egress |
--dscp-mark |
integer | DSCP mark value 0-56 (dscp-marking). | None |
--min-kbps |
integer | Minimum bandwidth in kbps (minimum-bandwidth). | None |
--help |
boolean | Show this message and exit. | False |
orca network qos rule-delete¶
Delete a QoS rule.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (bandwidth-limit | dscp-marking | minimum-bandwidth | minimum-packet-rate) |
Rule type. | bandwidth-limit |
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca network qos rule-list¶
List QoS rules for a policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (bandwidth-limit | dscp-marking | minimum-bandwidth | minimum-packet-rate) |
Rule type. | bandwidth-limit |
--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 network qos rule-type¶
Inspect QoS rule types Neutron knows how to enforce (read-only).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network qos rule-type list¶
List supported QoS rule types.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network qos rule-type show¶
Show the directions a QoS rule type supports.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network rbac¶
Manage RBAC policies on networks/qos/subnetpools/etc.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network rbac create¶
Create an RBAC policy to share a network resource.
Example — share a network with all projects:
orca network rbac-create \
--object-type network \
--object
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--object-type |
choice (network | qos_policy | security_group | address_group | address_scope | subnetpool) |
Type of the shared object. | Sentinel.UNSET |
--object |
text | ID of the object to share. | Sentinel.UNSET |
--action |
choice (access_as_shared | access_as_external) |
RBAC action. | Sentinel.UNSET |
--target-project |
text | Project ID to grant access to (use '*' for all projects). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca network rbac delete¶
Delete an RBAC policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca network rbac list¶
List RBAC policies.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--object-type |
choice (network | qos_policy | security_group | address_group | address_scope | subnetpool) |
Filter by object type. | 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 network rbac show¶
Show an RBAC policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network rbac update¶
Update the target project of an RBAC policy.
Example:
orca network rbac-update
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--target-project |
text | New target project ID (use '*' for all projects). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca network rbac update¶
Update the target project of an RBAC policy.
Example:
orca network rbac-update
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--target-project |
text | New target project ID (use '*' for all projects). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca network rbac-create¶
Create an RBAC policy to share a network resource.
Example — share a network with all projects:
orca network rbac-create \
--object-type network \
--object
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--object-type |
choice (network | qos_policy | security_group | address_group | address_scope | subnetpool) |
Type of the shared object. | Sentinel.UNSET |
--object |
text | ID of the object to share. | Sentinel.UNSET |
--action |
choice (access_as_shared | access_as_external) |
RBAC action. | Sentinel.UNSET |
--target-project |
text | Project ID to grant access to (use '*' for all projects). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca network rbac-delete¶
Delete an RBAC policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca network rbac-list¶
List RBAC policies.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--object-type |
choice (network | qos_policy | security_group | address_group | address_scope | subnetpool) |
Filter by object type. | 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 network rbac-show¶
Show an RBAC policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network rbac-update¶
Update the target project of an RBAC policy.
Example:
orca network rbac-update
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--target-project |
text | New target project ID (use '*' for all projects). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca network router¶
Manage Neutron routers.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network router add¶
Attach a sub-resource to a router (interface, route).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network router add gateway¶
Set an external gateway on a router (OSC router add gateway).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--network |
text | External network ID to use as gateway. | Sentinel.UNSET |
--fixed-ip |
text | Fixed IP on the external network (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca network router add interface¶
Add a subnet interface to a router.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--subnet-id |
text | Subnet to attach. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca network router add port¶
Attach an existing port to a router (OSC router add port).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network router add route¶
Add a static route to a router (requires extraroute-atomic extension).
Example:
orca network router-add-route
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--destination |
text | Destination network (e.g. 10.1.0.0/24). | Sentinel.UNSET |
--nexthop |
text | Next-hop IP address. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca network router add subnet¶
Add a subnet to a router (OSC router add subnet).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network router create¶
Create a router.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--external-network |
text | External network ID for gateway. | None |
--help |
boolean | Show this message and exit. | False |
orca network router delete¶
Delete a router.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca network router list¶
List routers.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network router ndp-proxy¶
Manage IPv6 NDP proxies on a router.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network router ndp-proxy create¶
Create an NDP proxy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--router-id |
text | N/A | Sentinel.UNSET |
--port-id |
text | N/A | Sentinel.UNSET |
--ip-address |
text | Specific IPv6 address (autopicked if omitted). | None |
--help |
boolean | Show this message and exit. | False |
orca network router ndp-proxy delete¶
Delete an NDP proxy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca network router ndp-proxy list¶
List NDP proxies.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--router-id |
text | Filter by router. | 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 network router ndp-proxy set¶
Update an NDP proxy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | N/A | None |
--description |
text | N/A | None |
--help |
boolean | Show this message and exit. | False |
orca network router ndp-proxy show¶
Show an NDP proxy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network router remove¶
Detach a sub-resource from a router.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network router remove gateway¶
Clear a router's external gateway (OSC router remove gateway).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network router remove interface¶
Remove a subnet interface from a router.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--subnet-id |
text | Subnet to detach. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca network router remove port¶
Detach a port from a router (OSC router remove port).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network router remove route¶
Remove a static route from a router (requires extraroute-atomic extension).
Example:
orca network router-remove-route
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--destination |
text | Destination network to remove. | Sentinel.UNSET |
--nexthop |
text | Next-hop IP address. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca network router remove subnet¶
Remove a subnet from a router (OSC router remove subnet).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network router show¶
Show router details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network router update¶
Update a router.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--external-network |
text | New external gateway network ID. | None |
--help |
boolean | Show this message and exit. | False |
orca network router update¶
Update a router.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--external-network |
text | New external gateway network ID. | None |
--help |
boolean | Show this message and exit. | False |
orca network router update¶
Update a router.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--external-network |
text | New external gateway network ID. | None |
--help |
boolean | Show this message and exit. | False |
orca network router-add-interface¶
Add a subnet interface to a router.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--subnet-id |
text | Subnet to attach. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca network router-add-route¶
Add a static route to a router (requires extraroute-atomic extension).
Example:
orca network router-add-route
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--destination |
text | Destination network (e.g. 10.1.0.0/24). | Sentinel.UNSET |
--nexthop |
text | Next-hop IP address. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca network router-create¶
Create a router.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--external-network |
text | External network ID for gateway. | None |
--help |
boolean | Show this message and exit. | False |
orca network router-delete¶
Delete a router.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca network router-list¶
List routers.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network router-remove-interface¶
Remove a subnet interface from a router.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--subnet-id |
text | Subnet to detach. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca network router-remove-route¶
Remove a static route from a router (requires extraroute-atomic extension).
Example:
orca network router-remove-route
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--destination |
text | Destination network to remove. | Sentinel.UNSET |
--nexthop |
text | Next-hop IP address. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca network router-set-gateway¶
Set (or replace) the external gateway on a router.
Examples:
orca network router-set-gateway
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--external-network |
text | External network ID to use as gateway. | Sentinel.UNSET |
--enable-snat / --disable-snat |
boolean | Enable or disable SNAT on the gateway. | None |
--help |
boolean | Show this message and exit. | False |
orca network router-show¶
Show router details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network router-unset-gateway¶
Remove the external gateway from a router.
Example:
orca network router-unset-gateway
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network router-update¶
Update a router.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--external-network |
text | New external gateway network ID. | None |
--help |
boolean | Show this message and exit. | False |
orca network segment¶
Manage network segments.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network segment create¶
Create a network segment.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--network-id |
text | Network ID this segment belongs to. | Sentinel.UNSET |
--network-type |
choice (flat | geneve | gre | local | vlan | vxlan) |
Network type. | Sentinel.UNSET |
--physical-network |
text | Physical network name. | None |
--segment |
integer | Segmentation ID (VLAN ID or tunnel ID). | None |
--description |
text | Segment description. | None |
--help |
boolean | Show this message and exit. | False |
orca network segment delete¶
Delete a network segment.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca network segment list¶
List network segments.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--network-id |
text | Filter by network ID. | 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 network segment set¶
Update a network segment.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--help |
boolean | Show this message and exit. | False |
orca network segment show¶
Show a network segment.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network segment-create¶
Create a network segment.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--network-id |
text | Network ID this segment belongs to. | Sentinel.UNSET |
--network-type |
choice (flat | geneve | gre | local | vlan | vxlan) |
Network type. | Sentinel.UNSET |
--physical-network |
text | Physical network name. | None |
--segment |
integer | Segmentation ID (VLAN ID or tunnel ID). | None |
--description |
text | Segment description. | None |
--help |
boolean | Show this message and exit. | False |
orca network segment-delete¶
Delete a network segment.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca network segment-list¶
List network segments.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--network-id |
text | Filter by network ID. | 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 network segment-range¶
Manage network segment ID ranges (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network segment-range create¶
Create a segment range.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--network-type |
choice (vlan | vxlan | gre | geneve) |
Segment type. | Sentinel.UNSET |
--physical-network |
text | Physical network identifier (required for vlan). | None |
--minimum |
integer | Minimum segment ID. | Sentinel.UNSET |
--maximum |
integer | Maximum segment ID. | Sentinel.UNSET |
--shared / --unshared |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca network segment-range delete¶
Delete a segment range.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca network segment-range list¶
List network segment ranges.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network segment-range set¶
Update a segment range.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | N/A | None |
--minimum |
integer | N/A | None |
--maximum |
integer | N/A | None |
--help |
boolean | Show this message and exit. | False |
orca network segment-range show¶
Show a segment range.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network segment-set¶
Update a network segment.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--help |
boolean | Show this message and exit. | False |
orca network segment-show¶
Show a network segment.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network service-provider¶
Inspect Neutron service providers (BGP-VPN, L3, …).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network service-provider list¶
List Neutron service providers.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network show¶
Show network details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network subnet¶
Manage Neutron subnets.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network subnet create¶
Create a subnet.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--network-id |
text | Parent network ID. | Sentinel.UNSET |
--cidr |
text | CIDR (e.g. 10.0.0.0/24). | Sentinel.UNSET |
--ip-version |
choice (4 | 6) |
N/A | 4 |
--gateway |
text | Gateway IP. Auto if omitted. | None |
--dhcp / --no-dhcp |
boolean | Enable DHCP. | True |
--dns |
text | DNS nameserver (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca network subnet delete¶
Delete a subnet.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca network subnet inspect¶
Full inspection of a subnet — fields + IP usage + attached ports + servers.
Cross-references three Neutron endpoints so you don't have to run
subnet show + port list + ip-availability show by hand:
GET /subnets/{id}— the subnet fieldsGET /network-ip-availabilities/{network_id}— IP usage per subnetGET /ports?fixed_ips=subnet_id=<id>— who actually uses each IP
For each port, follow device_id when device_owner is
compute:* to surface the server name (single Nova servers/{id}
GET per attached VM).
Example:
orca network subnet inspect
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network subnet list¶
List subnets.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network subnet show¶
Show subnet details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network subnet update¶
Update a subnet.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--dns-nameserver |
text | DNS nameserver IP (repeatable, replaces existing list). | Sentinel.UNSET |
--enable-dhcp / --disable-dhcp |
boolean | Enable or disable DHCP. | None |
--help |
boolean | Show this message and exit. | False |
orca network subnet update¶
Update a subnet.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--dns-nameserver |
text | DNS nameserver IP (repeatable, replaces existing list). | Sentinel.UNSET |
--enable-dhcp / --disable-dhcp |
boolean | Enable or disable DHCP. | None |
--help |
boolean | Show this message and exit. | False |
orca network subnet update¶
Update a subnet.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--dns-nameserver |
text | DNS nameserver IP (repeatable, replaces existing list). | Sentinel.UNSET |
--enable-dhcp / --disable-dhcp |
boolean | Enable or disable DHCP. | None |
--help |
boolean | Show this message and exit. | False |
orca network subnet-create¶
Create a subnet.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--network-id |
text | Parent network ID. | Sentinel.UNSET |
--cidr |
text | CIDR (e.g. 10.0.0.0/24). | Sentinel.UNSET |
--ip-version |
choice (4 | 6) |
N/A | 4 |
--gateway |
text | Gateway IP. Auto if omitted. | None |
--dhcp / --no-dhcp |
boolean | Enable DHCP. | True |
--dns |
text | DNS nameserver (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca network subnet-delete¶
Delete a subnet.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca network subnet-list¶
List subnets.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network subnet-show¶
Show subnet details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network subnet-update¶
Update a subnet.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--dns-nameserver |
text | DNS nameserver IP (repeatable, replaces existing list). | Sentinel.UNSET |
--enable-dhcp / --disable-dhcp |
boolean | Enable or disable DHCP. | None |
--help |
boolean | Show this message and exit. | False |
orca network subport¶
Sub-ports of a trunk (alias of orca trunk subport).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network subport list¶
List sub-ports on a trunk.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network topology¶
Display the network topology as a tree.
Shows networks → subnets → connected ports with device info (servers, routers, DHCP, load-balancers).
Examples:
orca network topology
orca network topology --network-id
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--network-id |
text | Show only this network. | None |
--help |
boolean | Show this message and exit. | False |
orca network trace¶
Trace the full network path for a server instance.
Shows every hop: fixed IP → port → security groups → router → floating IP, with status and IDs at each step.
Examples:
orca network trace
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network trunk¶
Manage Neutron trunks (VLAN trunk ports).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network trunk add-subport¶
Add a sub-port to a trunk.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--port |
text | Sub-port port ID. | Sentinel.UNSET |
--segmentation-type |
choice (vlan | inherit) |
Segmentation type. | vlan |
--segmentation-id |
integer | VLAN ID (1–4094). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca network trunk create¶
Create a trunk.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--port |
text | Parent port ID (the trunk port). | Sentinel.UNSET |
--name |
text | Trunk name. | None |
--description |
text | Description. | None |
--disable |
boolean | Create trunk in administratively down state. | False |
--help |
boolean | Show this message and exit. | False |
orca network trunk delete¶
Delete a trunk.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca network trunk list¶
List trunks.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network trunk remove-subport¶
Remove a sub-port from a trunk.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--port |
text | Sub-port port ID to remove. | Sentinel.UNSET |
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca network trunk set¶
Update a trunk.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--enable / --disable |
boolean | Enable or disable the trunk. | None |
--help |
boolean | Show this message and exit. | False |
orca network trunk show¶
Show trunk details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network trunk subport¶
Manage sub-ports on a trunk.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca network trunk subport add¶
Add a sub-port to a trunk.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--port |
text | Sub-port port ID. | Sentinel.UNSET |
--segmentation-type |
choice (vlan | inherit) |
Segmentation type. | vlan |
--segmentation-id |
integer | VLAN ID (1–4094). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca network trunk subport list¶
List sub-ports on a trunk.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network trunk subport remove¶
Remove a sub-port from a trunk.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--port |
text | Sub-port port ID to remove. | Sentinel.UNSET |
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca network trunk subport-list¶
List sub-ports on a trunk.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 network trunk unset¶
Clear optional fields on a trunk (description, …).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
boolean | Clear the description. | False |
--help |
boolean | Show this message and exit. | False |
orca network update¶
Update a network.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--admin-state / --no-admin-state |
boolean | Admin state. | None |
--help |
boolean | Show this message and exit. | False |
orca network update¶
Update a network.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--admin-state / --no-admin-state |
boolean | Admin state. | None |
--help |
boolean | Show this message and exit. | False |
orca network update¶
Update a network.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--admin-state / --no-admin-state |
boolean | Admin state. | None |
--help |
boolean | Show this message and exit. | False |
orca object¶
Manage object storage containers & objects (Swift).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca object account¶
Manage Swift account-level metadata.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca object account set¶
Set account-level metadata.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--property |
text | Metadata key=value pair (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca object account show¶
Show Swift account-level metadata and counters.
Equivalent to openstack object store account show.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 object account unset¶
Remove account-level metadata.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--property |
text | Metadata key to remove (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca object account-set¶
Set account-level metadata.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--property |
text | Metadata key=value pair (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca object account-unset¶
Remove account-level metadata.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--property |
text | Metadata key to remove (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca object container¶
Manage Swift containers.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca object container create¶
Create a container.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca object container delete¶
Delete a container.
Use --recursive to delete all objects in the container first.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--recursive |
boolean | Delete all objects before deleting the container. | False |
--yes, -y |
boolean | Skip confirmation prompt. | False |
--help |
boolean | Show this message and exit. | False |
orca object container list¶
List containers.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 object container save¶
Download all objects in a container to a local directory.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--output-dir |
text | Local directory to save objects into. | . |
--help |
boolean | Show this message and exit. | False |
orca object container set¶
Set metadata on a container.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--property |
text | Metadata key=value pair (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca object container show¶
Show container metadata.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 object container-create¶
Create a container.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca object container-delete¶
Delete a container.
Use --recursive to delete all objects in the container first.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--recursive |
boolean | Delete all objects before deleting the container. | False |
--yes, -y |
boolean | Skip confirmation prompt. | False |
--help |
boolean | Show this message and exit. | False |
orca object container-list¶
List containers.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 object container-save¶
Download all objects in a container to a local directory.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--output-dir |
text | Local directory to save objects into. | . |
--help |
boolean | Show this message and exit. | False |
orca object container-set¶
Set metadata on a container.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--property |
text | Metadata key=value pair (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca object container-show¶
Show container metadata.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 object delete¶
Delete one or more objects from a container.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca object download¶
Download an object from a container.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--file |
text | Local filename to save to (defaults to object name). | None |
--help |
boolean | Show this message and exit. | False |
orca object download¶
Download an object from a container.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--file |
text | Local filename to save to (defaults to object name). | None |
--help |
boolean | Show this message and exit. | False |
orca object list¶
List objects in a container.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--prefix |
text | Only list objects with this prefix. | None |
--delimiter |
text | Delimiter for pseudo-folder grouping. | None |
--long |
boolean | Show hash and content type. | False |
--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 object set¶
Set metadata on an object.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--property |
text | Metadata key=value pair (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca object show¶
Show object metadata.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 object stats¶
Show account-level storage statistics.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 object tree¶
Show containers and objects as a tree.
Without a container argument, shows all containers. With a container, shows the pseudo-folder structure of objects within it.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--delimiter |
text | Delimiter for pseudo-folder hierarchy. | / |
--help |
boolean | Show this message and exit. | False |
orca object unset¶
Remove metadata from an object.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--property |
text | Metadata key to remove (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca object upload¶
Upload file(s) to a container.
Files larger than 5 GB are automatically split into segments using Swift SLO (Static Large Object).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Override the object name (only valid for single file upload). | None |
--segment-size |
integer | Segment size in MB for large files (default: 4096 MB). | None |
--help |
boolean | Show this message and exit. | False |
orca object upload¶
Upload file(s) to a container.
Files larger than 5 GB are automatically split into segments using Swift SLO (Static Large Object).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Override the object name (only valid for single file upload). | None |
--segment-size |
integer | Segment size in MB for large files (default: 4096 MB). | None |
--help |
boolean | Show this message and exit. | False |
orca object-store¶
OSC parity: openstack object store … admin verbs.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca object-store account¶
Swift account-level metadata.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca object-store account set¶
Set account-level metadata.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--property |
text | Metadata key=value pair (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca object-store account show¶
Show Swift account-level metadata and counters.
Equivalent to openstack object store account show.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 object-store account unset¶
Remove account-level metadata.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--property |
text | Metadata key to remove (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca orchestration¶
Heat orchestration — OSC parity top-level.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca orchestration build¶
Heat build info.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca orchestration build info¶
Show Heat engine + API build info (GET /v1/build_info).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 orchestration resource-type¶
Inspect Heat resource types (compound noun).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca orchestration resource-type list¶
List available Heat resource types.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--filter |
text | Filter resource types by name substring. | 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 orchestration resource-type show¶
Show the schema for a Heat resource type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--template-type |
choice (cfn | hot) |
Template format for the resource schema. | hot |
--help |
boolean | Show this message and exit. | False |
orca orchestration service¶
Heat engine services.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca orchestration service list¶
List heat-engine workers (GET /v1/services).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 orchestration template¶
Heat template inspection (OSC parity).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca orchestration template function¶
Heat template functions per version.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca orchestration template function list¶
List the intrinsic functions available in a template version.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 orchestration template validate¶
Validate a Heat template.
Examples: orca stack template-validate -t template.yaml orca stack template-validate -t template.yaml -e env.yaml
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--template, -t |
text | Template file path or URL. | Sentinel.UNSET |
--environment, -e |
text | Environment file path. | None |
--parameter |
text | Parameter key=value (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca orchestration template version¶
Heat template versions.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca orchestration template version list¶
List Heat template versions accepted by the engine.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 overview¶
Show a project dashboard — servers, quotas, volumes, IPs at a glance.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca placement¶
Manage Placement resources (resource providers, classes, traits, etc.).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca placement allocation¶
Manage Placement allocations.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca placement allocation candidate¶
Placement allocation candidates.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca placement allocation candidate candidate-list¶
List allocation candidates for the requested resources.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--resource |
text | Requested resource, e.g. VCPU=4. Repeatable. | Sentinel.UNSET |
--required |
text | Required trait. Repeatable. | Sentinel.UNSET |
--forbidden |
text | Forbidden trait. Repeatable. | Sentinel.UNSET |
--limit |
integer | Max number of candidates. | 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 placement allocation candidate-list¶
List allocation candidates for the requested resources.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--resource |
text | Requested resource, e.g. VCPU=4. Repeatable. | Sentinel.UNSET |
--required |
text | Required trait. Repeatable. | Sentinel.UNSET |
--forbidden |
text | Forbidden trait. Repeatable. | Sentinel.UNSET |
--limit |
integer | Max number of candidates. | 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 placement allocation delete¶
Delete all allocations for a consumer.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca placement allocation set¶
Set (replace) allocations for a consumer against a single resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--resource-provider |
text | Resource provider UUID. | Sentinel.UNSET |
--resource |
text | Resource class and amount, e.g. VCPU=4. Repeatable. | Sentinel.UNSET |
--project-id |
text | Consumer project UUID. | Sentinel.UNSET |
--user-id |
text | Consumer user UUID. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca placement allocation show¶
Show allocations for a consumer.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 placement allocation unset¶
Drop a single resource-class allocation for a consumer.
Reads the consumer's full allocations, strips rc_name from
each provider entry (optionally only on --rp-uuid), then PUTs
the remaining allocations back. Empty entries are dropped.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--resource-class |
text | Resource class to clear (e.g. VCPU, MEMORY_MB). | Sentinel.UNSET |
--rp-uuid |
text | Optional: limit to allocations on this resource provider (default: all providers). | None |
--help |
boolean | Show this message and exit. | False |
orca placement allocation-candidate-list¶
List allocation candidates for the requested resources.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--resource |
text | Requested resource, e.g. VCPU=4. Repeatable. | Sentinel.UNSET |
--required |
text | Required trait. Repeatable. | Sentinel.UNSET |
--forbidden |
text | Forbidden trait. Repeatable. | Sentinel.UNSET |
--limit |
integer | Max number of candidates. | 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 placement allocation-delete¶
Delete all allocations for a consumer.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca placement allocation-set¶
Set (replace) allocations for a consumer against a single resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--resource-provider |
text | Resource provider UUID. | Sentinel.UNSET |
--resource |
text | Resource class and amount, e.g. VCPU=4. Repeatable. | Sentinel.UNSET |
--project-id |
text | Consumer project UUID. | Sentinel.UNSET |
--user-id |
text | Consumer user UUID. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca placement allocation-show¶
Show allocations for a consumer.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 placement resource-class¶
Manage Placement resource classes (compound noun).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca placement resource-class create¶
Create a custom resource class (must start with CUSTOM_).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca placement resource-class delete¶
Delete a custom resource class.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca placement resource-class list¶
List resource classes.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 placement resource-class set¶
Rename a custom resource class (OSC parity).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New resource class name (must start with CUSTOM_). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca placement resource-class show¶
Show a resource class.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca placement resource-class-create¶
Create a custom resource class (must start with CUSTOM_).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca placement resource-class-delete¶
Delete a custom resource class.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca placement resource-class-list¶
List resource classes.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 placement resource-class-show¶
Show a resource class.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider¶
Manage Placement resource providers (compound noun).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider aggregate¶
Aggregate associations of a resource provider (OSC parity).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider aggregate aggregate-delete¶
Remove all aggregate associations from a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider aggregate aggregate-list¶
List aggregates associated with a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 placement resource-provider aggregate aggregate-set¶
Set (replace) aggregates on a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider aggregate-delete¶
Remove all aggregate associations from a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider aggregate-list¶
List aggregates associated with a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 placement resource-provider aggregate-set¶
Set (replace) aggregates on a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider allocation¶
Allocations against a resource provider (OSC parity).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider allocation delete¶
Delete all allocations for a consumer.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider allocation set¶
Set (replace) allocations for a consumer against a single resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--resource-provider |
text | Resource provider UUID. | Sentinel.UNSET |
--resource |
text | Resource class and amount, e.g. VCPU=4. Repeatable. | Sentinel.UNSET |
--project-id |
text | Consumer project UUID. | Sentinel.UNSET |
--user-id |
text | Consumer user UUID. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider allocation show¶
Show allocations for a consumer.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 placement resource-provider allocation unset¶
Drop a single resource-class allocation for a consumer.
Reads the consumer's full allocations, strips rc_name from
each provider entry (optionally only on --rp-uuid), then PUTs
the remaining allocations back. Empty entries are dropped.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--resource-class |
text | Resource class to clear (e.g. VCPU, MEMORY_MB). | Sentinel.UNSET |
--rp-uuid |
text | Optional: limit to allocations on this resource provider (default: all providers). | None |
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider create¶
Create a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--uuid |
text | Explicit UUID for the new provider. | None |
--parent-uuid |
text | UUID of the parent provider. | 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 placement resource-provider delete¶
Delete a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider inventory¶
Inventories of a resource provider (OSC parity).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider inventory class¶
Per-resource-class inventory verbs (OSC parity).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
# orca placement resource-provider inventory class inventory-set¶
Create or update a single inventory for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--total |
integer | Total inventory units. | Sentinel.UNSET |
--reserved |
integer | N/A | 0 |
--min-unit |
integer | N/A | 1 |
--max-unit |
integer | N/A | None |
--step-size |
integer | N/A | 1 |
--allocation-ratio |
float | N/A | 1.0 |
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider inventory inventory-delete¶
Delete an inventory for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider inventory inventory-delete-all¶
Delete all inventories for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider inventory inventory-list¶
List inventories for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 placement resource-provider inventory inventory-set¶
Create or update a single inventory for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--total |
integer | Total inventory units. | Sentinel.UNSET |
--reserved |
integer | N/A | 0 |
--min-unit |
integer | N/A | 1 |
--max-unit |
integer | N/A | None |
--step-size |
integer | N/A | 1 |
--allocation-ratio |
float | N/A | 1.0 |
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider inventory inventory-show¶
Show a single inventory for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 placement resource-provider inventory-delete¶
Delete an inventory for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider inventory-delete-all¶
Delete all inventories for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider inventory-list¶
List inventories for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 placement resource-provider inventory-set¶
Create or update a single inventory for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--total |
integer | Total inventory units. | Sentinel.UNSET |
--reserved |
integer | N/A | 0 |
--min-unit |
integer | N/A | 1 |
--max-unit |
integer | N/A | None |
--step-size |
integer | N/A | 1 |
--allocation-ratio |
float | N/A | 1.0 |
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider inventory-show¶
Show a single inventory for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 placement resource-provider list¶
List resource providers.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Filter by name. | None |
--uuid |
text | Filter by UUID. | None |
--in-tree |
text | Limit to providers in this tree. | 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 placement resource-provider set¶
Update a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--parent-uuid |
text | New parent provider UUID. | None |
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider show¶
Show a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 placement resource-provider trait¶
Traits associated with a resource provider (OSC parity).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider trait trait-delete¶
Remove all traits from a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider trait trait-list¶
List traits associated with a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 placement resource-provider trait trait-set¶
Set (replace) traits on a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider trait-delete¶
Remove all traits from a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider trait-list¶
List traits associated with a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 placement resource-provider trait-set¶
Set (replace) traits on a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider usage¶
Per-resource-provider usage (OSC parity).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider usage usage¶
Show usages for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 placement resource-provider-aggregate-delete¶
Remove all aggregate associations from a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider-aggregate-list¶
List aggregates associated with a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 placement resource-provider-aggregate-set¶
Set (replace) aggregates on a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider-create¶
Create a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--uuid |
text | Explicit UUID for the new provider. | None |
--parent-uuid |
text | UUID of the parent provider. | 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 placement resource-provider-delete¶
Delete a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider-inventory-delete¶
Delete an inventory for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider-inventory-delete-all¶
Delete all inventories for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider-inventory-list¶
List inventories for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 placement resource-provider-inventory-set¶
Create or update a single inventory for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--total |
integer | Total inventory units. | Sentinel.UNSET |
--reserved |
integer | N/A | 0 |
--min-unit |
integer | N/A | 1 |
--max-unit |
integer | N/A | None |
--step-size |
integer | N/A | 1 |
--allocation-ratio |
float | N/A | 1.0 |
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider-inventory-show¶
Show a single inventory for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 placement resource-provider-list¶
List resource providers.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Filter by name. | None |
--uuid |
text | Filter by UUID. | None |
--in-tree |
text | Limit to providers in this tree. | 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 placement resource-provider-set¶
Update a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--parent-uuid |
text | New parent provider UUID. | None |
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider-show¶
Show a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 placement resource-provider-trait-delete¶
Remove all traits from a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider-trait-list¶
List traits associated with a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 placement resource-provider-trait-set¶
Set (replace) traits on a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca placement resource-provider-usage¶
Show usages for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 placement trait¶
Manage Placement traits.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca placement trait create¶
Create a custom trait (must start with CUSTOM_).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca placement trait delete¶
Delete a custom trait.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca placement trait list¶
List traits.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Filter traits by name prefix. | None |
--associated |
boolean | Only traits associated with a resource provider. | False |
--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 placement trait show¶
Show a trait (existence check — Placement traits have no body).
Equivalent to openstack trait show. Raises OrcaCLIError
if the trait does not exist.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca placement trait-create¶
Create a custom trait (must start with CUSTOM_).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca placement trait-delete¶
Delete a custom trait.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca placement trait-list¶
List traits.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Filter traits by name prefix. | None |
--associated |
boolean | Only traits associated with a resource provider. | False |
--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 placement usage¶
Inspect Placement usage.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca placement usage list¶
Show aggregated usages by project/user.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--project-id |
text | Filter by project UUID. | None |
--user-id |
text | Filter by user UUID. | 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 placement usage list¶
Show aggregated usages by project/user.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--project-id |
text | Filter by project UUID. | None |
--user-id |
text | Filter by user UUID. | 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 placement usage-list¶
Show aggregated usages by project/user.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--project-id |
text | Filter by project UUID. | None |
--user-id |
text | Filter by user UUID. | 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 policy¶
Manage Keystone policies.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca policy create¶
Create a policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
text | MIME type of the policy blob. | application/json |
--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 policy delete¶
Delete a policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca policy list¶
List policies.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
text | Filter by policy type. | 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 policy set¶
Update a policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--blob |
text | New policy blob. | None |
--type |
text | New MIME type. | None |
--help |
boolean | Show this message and exit. | False |
orca policy show¶
Show a policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 port¶
Manage Neutron ports (alias of orca network port).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca port create¶
Create a port.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--network-id |
text | Network ID. | Sentinel.UNSET |
--name |
text | Port name. | None |
--fixed-ip |
text | Fixed IP address. | None |
--help |
boolean | Show this message and exit. | False |
orca port delete¶
Delete a port.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca port list¶
List ports.
Examples:
orca network port list
orca network port list --network-id
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--network-id |
text | Filter by network ID. | None |
--subnet-id, --subnet |
text | Filter to ports that have a fixed IP in this subnet. | None |
--device-owner |
text | Filter by device owner (e.g. compute:nova, network:router_interface, network:dhcp). |
None |
--device-id |
text | Filter by the attached resource ID (server, router, ...). | 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 port show¶
Show port details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 port unset¶
Remove properties from a port.
Examples:
orca network port-unset
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--security-group |
text | Security group ID to remove (repeatable). | Sentinel.UNSET |
--qos-policy |
boolean | Remove the QoS policy from the port. | False |
--description |
boolean | Clear the port description. | False |
--help |
boolean | Show this message and exit. | False |
orca port update¶
Update a port.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--admin-state / --no-admin-state |
boolean | Admin state. | None |
--help |
boolean | Show this message and exit. | False |
orca port update¶
Update a port.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--admin-state / --no-admin-state |
boolean | Admin state. | None |
--help |
boolean | Show this message and exit. | False |
orca profile¶
Manage configuration profiles (multi-account).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca profile add¶
Add a new profile interactively.
Examples: orca profile add production orca profile add staging --copy-from production --color yellow
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--copy-from |
text | Copy settings from an existing profile. | None |
--color |
text | Profile color (e.g. red, green, blue, cyan, magenta, yellow). | None |
--help |
boolean | Show this message and exit. | False |
orca profile color¶
Manage profile color.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca profile color set¶
Set a color for a profile. Use 'none' to remove.
Available colors: red, green, blue, yellow, magenta, cyan, white, bright_red, bright_green, bright_blue, bright_yellow, bright_magenta, bright_cyan, orange3, purple, pink1
Examples: orca profile color set red orca profile color set blue production orca profile color set none staging
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca profile edit¶
Edit an existing profile interactively.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca profile export¶
Export profiles to external formats.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca profile export clouds¶
Export a profile as a clouds.yaml entry.
Examples: orca profile export clouds # active profile orca profile export clouds production # specific profile orca profile export clouds production -o clouds.yaml
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--output, -o |
text | Write to file instead of stdout. | None |
--cloud-name |
text | Cloud name in clouds.yaml (default: profile name). | None |
--help |
boolean | Show this message and exit. | False |
orca profile export openrc¶
Export a profile as an OpenRC shell script.
Examples: orca profile export openrc # active profile to stdout orca profile export openrc production # specific profile orca profile export openrc production -o prod-openrc.sh source <(orca profile export openrc) # source directly
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--output, -o |
text | Write to file instead of stdout. | None |
--help |
boolean | Show this message and exit. | False |
orca profile from-clouds¶
Import a cloud from clouds.yaml as an orca profile.
Examples: orca profile import clouds mycloud orca profile import clouds mycloud --name production orca profile import clouds mycloud -f /path/to/clouds.yaml
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name, -n |
text | Profile name (default: cloud name). | None |
--file, -f |
text | Path to clouds.yaml (default: auto-detect). | None |
--help |
boolean | Show this message and exit. | False |
orca profile from-openrc¶
Import an OpenRC file as an orca profile.
Examples: orca profile import openrc admin-openrc.sh orca profile import openrc admin-openrc.sh --name production
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name, -n |
text | Profile name (default: filename without extension). | None |
--help |
boolean | Show this message and exit. | False |
orca profile import¶
Import profiles from external sources.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca profile import clouds¶
Import a cloud from clouds.yaml as an orca profile.
Examples: orca profile import clouds mycloud orca profile import clouds mycloud --name production orca profile import clouds mycloud -f /path/to/clouds.yaml
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name, -n |
text | Profile name (default: cloud name). | None |
--file, -f |
text | Path to clouds.yaml (default: auto-detect). | None |
--help |
boolean | Show this message and exit. | False |
orca profile import openrc¶
Import an OpenRC file as an orca profile.
Examples: orca profile import openrc admin-openrc.sh orca profile import openrc admin-openrc.sh --name production
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name, -n |
text | Profile name (default: filename without extension). | None |
--help |
boolean | Show this message and exit. | False |
orca profile list¶
List all profiles.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca profile region¶
Manage profile region.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca profile region list¶
List available regions from the Keystone service catalog.
Authenticates with the current profile and inspects the catalog to show which regions are available.
Examples: orca profile region list orca -P infomaniak profile region list
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca profile region set¶
Set the default region for a profile.
Use 'none' to clear the region (use the first available).
Examples: orca profile region set dc3-a orca profile region set dc4-a production orca profile region set none # clear region
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca profile regions¶
List available regions from the Keystone service catalog.
Authenticates with the current profile and inspects the catalog to show which regions are available.
Examples: orca profile region list orca -P infomaniak profile region list
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca profile remove¶
Remove a profile.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca profile rename¶
Rename a profile.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca profile set-color¶
Set a color for a profile. Use 'none' to remove.
Available colors: red, green, blue, yellow, magenta, cyan, white, bright_red, bright_green, bright_blue, bright_yellow, bright_magenta, bright_cyan, orange3, purple, pink1
Examples: orca profile color set red orca profile color set blue production orca profile color set none staging
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca profile set-region¶
Set the default region for a profile.
Use 'none' to clear the region (use the first available).
Examples: orca profile region set dc3-a orca profile region set dc4-a production orca profile region set none # clear region
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca profile show¶
Show profile details. Defaults to active profile.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca profile switch¶
Switch the active profile.
Without a NAME argument, shows an interactive numbered menu.
Examples: orca profile switch # interactive menu orca profile switch production orca profile switch staging
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca profile to-clouds¶
Export a profile as a clouds.yaml entry.
Examples: orca profile export clouds # active profile orca profile export clouds production # specific profile orca profile export clouds production -o clouds.yaml
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--output, -o |
text | Write to file instead of stdout. | None |
--cloud-name |
text | Cloud name in clouds.yaml (default: profile name). | None |
--help |
boolean | Show this message and exit. | False |
orca profile to-openrc¶
Export a profile as an OpenRC shell script.
Examples: orca profile export openrc # active profile to stdout orca profile export openrc production # specific profile orca profile export openrc production -o prod-openrc.sh source <(orca profile export openrc) # source directly
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--output, -o |
text | Write to file instead of stdout. | None |
--help |
boolean | Show this message and exit. | False |
orca project¶
Manage projects (Keystone v3).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca project cleanup¶
Delete ALL resources in a project in dependency order.
Requires admin credentials when targeting a project other than the one used for authentication.
Deletion order (respects dependencies): stacks → load-balancers → servers → floating-ips → dns-zones → routers (interfaces detached first) → networks → security-groups → backups → volumes → snapshots → images → secrets → swift containers (objects deleted first)
Examples: orca project cleanup --dry-run orca project cleanup --project my-test-tenant --yes orca project cleanup --created-before 2024-01-01T00:00:00 --skip image orca project cleanup --skip stack --skip secret --yes
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--project |
text | Project name or ID to clean up (default: current auth project). | None |
--dry-run |
boolean | List resources that would be deleted without deleting them. | False |
--yes, -y |
boolean | Skip confirmation prompt. | False |
--created-before |
text | Only delete resources created before this datetime (UTC). | None |
--skip |
choice (stack | loadbalancer | server | floating-ip | dns-zone | router | network | security-group | backup | volume | snapshot | image | secret | container) |
Resource type to skip (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca project create¶
Create a project.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--domain |
text | Domain ID. | None |
--description |
text | Description. | None |
--enable / --disable |
boolean | N/A | True |
--tag |
text | Tag (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca project delete¶
Delete a project.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca project list¶
List projects.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--domain |
text | Filter by domain ID. | None |
--user |
text | Filter by user ID. | None |
--enabled / --disabled |
boolean | Filter by enabled state. | 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 project set¶
Update a project.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | N/A | None |
--description |
text | N/A | None |
--enable / --disable |
boolean | N/A | None |
--help |
boolean | Show this message and exit. | False |
orca project show¶
Show project details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 ptr¶
Floating-IP reverse-DNS (PTR) records.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca ptr record¶
Per-floating-IP PTR records.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca ptr record list¶
List PTR records on all floating-IPs visible to the caller.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 ptr record set¶
Set or update a PTR record on a floating-IP.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--ptrdname |
text | Reverse DNS name. | Sentinel.UNSET |
--description |
text | N/A | None |
--ttl |
integer | TTL in seconds. | None |
--help |
boolean | Show this message and exit. | False |
orca ptr record show¶
Show the PTR record of a floating-IP.
REGION:FIP_UUID — same format Designate accepts on
/v2/reverse/floatingips/{region}:{uuid}.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 ptr record unset¶
Clear the PTR record of a floating-IP.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca qos¶
Manage Neutron QoS policies and rules.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca qos policy¶
Manage QoS policies.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca qos policy create¶
Create a QoS policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Policy name. | Sentinel.UNSET |
--shared |
boolean | Share with all projects. | False |
--default |
boolean | Set as default policy. | False |
--description |
text | Description. | None |
--help |
boolean | Show this message and exit. | False |
orca qos policy delete¶
Delete a QoS policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca qos policy list¶
List QoS policies.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--shared |
boolean | Show only shared policies. | False |
--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 qos policy set¶
Update a QoS policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--shared / --no-shared |
boolean | Share or un-share. | None |
--default / --no-default |
boolean | Set or unset as default. | None |
--help |
boolean | Show this message and exit. | False |
orca qos policy show¶
Show a QoS policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 qos policy-create¶
Create a QoS policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Policy name. | Sentinel.UNSET |
--shared |
boolean | Share with all projects. | False |
--default |
boolean | Set as default policy. | False |
--description |
text | Description. | None |
--help |
boolean | Show this message and exit. | False |
orca qos policy-delete¶
Delete a QoS policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca qos policy-list¶
List QoS policies.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--shared |
boolean | Show only shared policies. | False |
--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 qos policy-set¶
Update a QoS policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--shared / --no-shared |
boolean | Share or un-share. | None |
--default / --no-default |
boolean | Set or unset as default. | None |
--help |
boolean | Show this message and exit. | False |
orca qos policy-show¶
Show a QoS policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 qos rule¶
Manage QoS rules attached to a policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca qos rule create¶
Create a QoS rule.
Examples:
orca qos rule-create
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (bandwidth-limit | dscp-marking | minimum-bandwidth | minimum-packet-rate) |
Rule type. | bandwidth-limit |
--max-kbps |
integer | Maximum bandwidth in kbps (bandwidth-limit). | None |
--max-burst-kbps |
integer | Maximum burst bandwidth in kbps (bandwidth-limit). | None |
--direction |
choice (ingress | egress) |
Traffic direction (bandwidth-limit, minimum-bandwidth). | egress |
--dscp-mark |
integer | DSCP mark value 0-56 (dscp-marking). | None |
--min-kbps |
integer | Minimum bandwidth in kbps (minimum-bandwidth). | None |
--help |
boolean | Show this message and exit. | False |
orca qos rule delete¶
Delete a QoS rule.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (bandwidth-limit | dscp-marking | minimum-bandwidth | minimum-packet-rate) |
Rule type. | bandwidth-limit |
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca qos rule list¶
List QoS rules for a policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (bandwidth-limit | dscp-marking | minimum-bandwidth | minimum-packet-rate) |
Rule type. | bandwidth-limit |
--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 qos rule set¶
Update an existing QoS rule.
Example:
orca qos rule set
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (bandwidth-limit | dscp-marking | minimum-bandwidth | minimum-packet-rate) |
Rule type. | bandwidth-limit |
--max-kbps |
integer | New max bandwidth in kbps (bandwidth-limit). | None |
--max-burst-kbps |
integer | New max burst bandwidth in kbps (bandwidth-limit). | None |
--direction |
choice (ingress | egress) |
New traffic direction (bandwidth-limit, minimum-bandwidth). | None |
--dscp-mark |
integer | New DSCP mark value (dscp-marking). | None |
--min-kbps |
integer | New min bandwidth in kbps (minimum-bandwidth). | None |
--help |
boolean | Show this message and exit. | False |
orca qos rule show¶
Show details of a QoS rule.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (bandwidth-limit | dscp-marking | minimum-bandwidth | minimum-packet-rate) |
Rule type. | bandwidth-limit |
--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 qos rule-create¶
Create a QoS rule.
Examples:
orca qos rule-create
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (bandwidth-limit | dscp-marking | minimum-bandwidth | minimum-packet-rate) |
Rule type. | bandwidth-limit |
--max-kbps |
integer | Maximum bandwidth in kbps (bandwidth-limit). | None |
--max-burst-kbps |
integer | Maximum burst bandwidth in kbps (bandwidth-limit). | None |
--direction |
choice (ingress | egress) |
Traffic direction (bandwidth-limit, minimum-bandwidth). | egress |
--dscp-mark |
integer | DSCP mark value 0-56 (dscp-marking). | None |
--min-kbps |
integer | Minimum bandwidth in kbps (minimum-bandwidth). | None |
--help |
boolean | Show this message and exit. | False |
orca qos rule-delete¶
Delete a QoS rule.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (bandwidth-limit | dscp-marking | minimum-bandwidth | minimum-packet-rate) |
Rule type. | bandwidth-limit |
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca qos rule-list¶
List QoS rules for a policy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (bandwidth-limit | dscp-marking | minimum-bandwidth | minimum-packet-rate) |
Rule type. | bandwidth-limit |
--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 qos rule-type¶
Inspect QoS rule types Neutron knows how to enforce (read-only).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca qos rule-type list¶
List supported QoS rule types.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 qos rule-type show¶
Show the directions a QoS rule type supports.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 quota¶
Inspect project quotas across Nova, Neutron and Cinder.
With no sub-command, runs quota show for backward compatibility.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca quota default¶
Show the cloud-wide default quotas (Nova + Cinder + Neutron).
Parity with openstack quota show --default — Nova and Cinder
each expose a /os-quota-sets/<project>/defaults endpoint that
returns the same values regardless of the project; Neutron uses
/quotas/default.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--project |
text | Project ID (only used to look up defaults; Nova/Cinder return the same answer for any project). | Sentinel.UNSET |
--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 quota delete¶
Reset project quotas to the cloud defaults (admin).
Parity with openstack quota delete. With --service all (default)
issues DELETE on Nova, Cinder and Neutron quota-sets for the project.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--project |
text | Project ID (default: current project). | Sentinel.UNSET |
--service |
choice (all | compute | volume | network) |
Which service's quota to reset. | all |
--yes |
boolean | Skip the confirmation prompt. | False |
--help |
boolean | Show this message and exit. | False |
orca quota list¶
List projects with non-default quotas (admin).
Parity with openstack quota list — restricted to Neutron because
Nova and Cinder do not expose a cross-project list endpoint.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--service |
choice (network) |
Only Neutron exposes a list-all endpoint; Compute and Volume require a per-project fan-out (use orca quota show --project <id> instead). |
network |
--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 quota set¶
Set quotas on Nova / Cinder / Neutron (admin).
Pass any combination of resource flags — only services with at least
one flag receive a PUT. Use -1 for unlimited (Compute / Volume)
or the explicit Neutron sentinel.
Examples:
orca quota set --instances 50 --cores 100
orca quota set --project
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--project |
text | Project ID (default: current project). | Sentinel.UNSET |
--instances |
integer | Compute: max instances. | Sentinel.UNSET |
--cores |
integer | Compute: max vCPUs. | Sentinel.UNSET |
--ram |
integer | Compute: max RAM (MB). | Sentinel.UNSET |
--key-pairs |
integer | Compute: max key pairs. | Sentinel.UNSET |
--server-groups |
integer | Compute: max server groups. | Sentinel.UNSET |
--server-group-members |
integer | Compute: max members per server group. | Sentinel.UNSET |
--metadata-items |
integer | Compute: max metadata items per server. | Sentinel.UNSET |
--volumes |
integer | Volume: max volumes. | Sentinel.UNSET |
--snapshots |
integer | Volume: max snapshots. | Sentinel.UNSET |
--backups |
integer | Volume: max backups. | Sentinel.UNSET |
--gigabytes |
integer | Volume: total volume storage (GB). | Sentinel.UNSET |
--backup-gigabytes |
integer | Volume: total backup storage (GB). | Sentinel.UNSET |
--per-volume-gigabytes |
integer | Volume: max size per volume (GB). | Sentinel.UNSET |
--networks |
integer | Network: max networks. | Sentinel.UNSET |
--subnets |
integer | Network: max subnets. | Sentinel.UNSET |
--ports |
integer | Network: max ports. | Sentinel.UNSET |
--routers |
integer | Network: max routers. | Sentinel.UNSET |
--floating-ips |
integer | Network: max floating IPs. | Sentinel.UNSET |
--security-groups |
integer | Network: max security groups. | Sentinel.UNSET |
--security-group-rules |
integer | Network: max security-group rules. | Sentinel.UNSET |
--subnetpools |
integer | Network: max subnet pools. | Sentinel.UNSET |
--rbac-policies |
integer | Network: max RBAC policies. | Sentinel.UNSET |
--force |
boolean | Compute only: bypass the over-limit check on resources in use. | False |
--help |
boolean | Show this message and exit. | False |
orca quota show¶
Show project quotas — Nova, Neutron and Cinder usage vs limits.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--project |
text | Project ID (default: current project). | Sentinel.UNSET |
--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 rating¶
Manage CloudKitty rating.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca rating dataframes¶
Show raw rated dataframes (historical cost records).
Falls back to v1 storage if the v2 endpoint is not exposed.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--begin |
text | N/A | None |
--end |
text | N/A | None |
--limit |
integer | Max dataframes to return. | None |
--help |
boolean | Show this message and exit. | False |
orca rating hashmap¶
Configure the HashMap rating module. Admin only.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca rating hashmap field-create¶
Create a HashMap field under a service.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca rating hashmap field-delete¶
Delete a HashMap field.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca rating hashmap field-list¶
List HashMap fields (metadata keys a service is rated on).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--service-id |
text | Filter fields by service ID. | Sentinel.UNSET |
--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 rating hashmap group-create¶
Create a HashMap group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca rating hashmap group-delete¶
Delete a HashMap group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca rating hashmap group-list¶
List HashMap groups (shared metadata across mappings).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 rating hashmap mapping-create¶
Create a HashMap mapping.
Examples:
# Flat 0.05/hour for flavor m1.small:
orca rating hashmap mapping-create --field-id
# Service-level 0.10 multiplier:
orca rating hashmap mapping-create --service-id
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--field-id |
text | Field ID the mapping applies to. Required unless --service-id is given. | None |
--service-id |
text | Service ID for a service-level mapping (no field). | None |
--value |
text | Field value to match. Omit for service-level mappings. | None |
--cost |
text | Price (e.g. 0.05). | Sentinel.UNSET |
--type |
choice (flat | rate) |
flat = price per unit, rate = multiplier. | flat |
--group-id |
text | Group ID (HashMap group). | None |
--help |
boolean | Show this message and exit. | False |
orca rating hashmap mapping-delete¶
Delete a HashMap mapping.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca rating hashmap mapping-list¶
List HashMap mappings (value → price).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--service-id |
text | N/A | None |
--field-id |
text | N/A | None |
--group-id |
text | N/A | 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 rating hashmap service-create¶
Create a HashMap service (one per rated metric).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca rating hashmap service-delete¶
Delete a HashMap service.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca rating hashmap service-list¶
List HashMap services (one per rated metric).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 rating hashmap threshold-create¶
Create a HashMap threshold.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--field-id |
text | N/A | None |
--service-id |
text | N/A | None |
--level |
text | Quantity level at which this tier starts. | Sentinel.UNSET |
--cost |
text | N/A | Sentinel.UNSET |
--type |
choice (flat | rate) |
N/A | flat |
--group-id |
text | N/A | None |
--help |
boolean | Show this message and exit. | False |
orca rating hashmap threshold-delete¶
Delete a HashMap threshold.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca rating hashmap threshold-list¶
List HashMap thresholds.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--service-id |
text | N/A | None |
--field-id |
text | N/A | None |
--group-id |
text | N/A | 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 rating info¶
Show CloudKitty configuration (collector, metrics, fetcher).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca rating metric¶
Inspect CloudKitty metrics.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca rating metric list¶
List metrics that CloudKitty is configured to rate.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 rating metric show¶
Show collection details for a rated metric.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 rating metric-list¶
List metrics that CloudKitty is configured to rate.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 rating metric-show¶
Show collection details for a rated metric.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 rating module¶
Manage CloudKitty rating modules.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca rating module disable¶
Disable a rating module. Admin only.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca rating module enable¶
Enable a rating module. Admin only.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca rating module list¶
List rating modules (hashmap, pyscripts, noop, …). Admin only.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 rating module set-priority¶
Set module priority (higher runs first). Admin only.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca rating module show¶
Show a rating module. Admin only.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 rating module-disable¶
Disable a rating module. Admin only.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca rating module-enable¶
Enable a rating module. Admin only.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca rating module-list¶
List rating modules (hashmap, pyscripts, noop, …). Admin only.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 rating module-set-priority¶
Set module priority (higher runs first). Admin only.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca rating module-show¶
Show a rating module. Admin only.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 rating quote¶
Get a price estimate for a set of resources (pre-deployment).
Sends a quote request to CloudKitty's rating engine. The payload
format mirrors a rated dataframe: each --resource is one line
item (service + metadata + volume).
Example: orca rating quote --resource '{"service":"instance","desc":{"flavor_id":"2"},"volume":"1"}'
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--resource |
text | Resource JSON, e.g. '{"service":"instance","desc":{"flavor":"m1.small"},"volume":"1"}' (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca rating summary¶
Show rating summary (total cost per resource type / project / …).
Examples: orca rating summary orca rating summary --groupby type orca rating summary --begin 2026-01-01T00:00:00 --end 2026-02-01T00:00:00 --groupby project_id
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--begin |
text | Start of the rating window. Defaults to start of current month. | None |
--end |
text | End of the rating window. Defaults to now. | None |
--groupby |
text | Group results by field (repeatable). Common: type, project_id, user_id. | Sentinel.UNSET |
--filters |
text | Filter results (repeatable). | Sentinel.UNSET |
--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 recordset¶
Manage DNS recordsets (Designate).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca recordset create¶
Create a recordset in a zone.
Examples: orca recordset create example.com. www.example.com. --type A --record 1.2.3.4 orca recordset create example.com. example.com. --type MX --record "10 mail.example.com." orca recordset create example.com. example.com. --type A --record 1.2.3.4 --record 5.6.7.8
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
text | Record type (A, AAAA, CNAME, MX, TXT, …). | Sentinel.UNSET |
--record |
text | Record value (repeatable for multiple values). | Sentinel.UNSET |
--ttl |
integer | TTL in seconds. | None |
--description |
text | Recordset description. | None |
--help |
boolean | Show this message and exit. | False |
orca recordset delete¶
Delete a recordset.
ZONE and RECORDSET can be IDs or names.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca recordset list¶
List recordsets in a zone.
ZONE can be a zone ID or name.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
text | Filter by record type (A, AAAA, CNAME, MX, …). | None |
--name |
text | Filter by record name. | 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 recordset set¶
Update a recordset in a zone.
ZONE and RECORDSET can be IDs or names. The --record option replaces
all existing record values.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--record |
text | Record value (repeatable — replaces all existing values). | Sentinel.UNSET |
--ttl |
integer | TTL in seconds. | None |
--description |
text | Recordset description. | None |
--help |
boolean | Show this message and exit. | False |
orca recordset show¶
Show recordset details.
ZONE and RECORDSET can be IDs or names.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 region¶
Manage Keystone regions.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca region create¶
Create a region.
The ID is the region name (e.g. RegionOne, dc3-a).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | Region description. | None |
--parent |
text | Parent region ID. | None |
--help |
boolean | Show this message and exit. | False |
orca region delete¶
Delete a region.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca region list¶
List regions.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--parent |
text | Filter by parent region ID. | 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 region set¶
Update a region's description.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | New description. | None |
--help |
boolean | Show this message and exit. | False |
orca region show¶
Show region details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 registered-limit¶
Manage Keystone registered limits (defaults per service/resource).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca registered-limit create¶
Create a registered limit.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--service-id |
text | Service ID. | Sentinel.UNSET |
--resource-name |
text | Resource name (e.g. server). | Sentinel.UNSET |
--default-limit |
integer | Default limit value. | Sentinel.UNSET |
--region-id |
text | Region ID. | None |
--description |
text | Description. | `` |
--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 registered-limit delete¶
Delete a registered limit.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca registered-limit list¶
List registered limits.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--service-id |
text | Filter by service ID. | None |
--region-id |
text | Filter by region ID. | None |
--resource-name |
text | Filter by resource name. | 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 registered-limit set¶
Update a registered limit.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--service-id |
text | N/A | None |
--resource-name |
text | N/A | None |
--default-limit |
integer | N/A | None |
--region-id |
text | N/A | None |
--description |
text | N/A | None |
--help |
boolean | Show this message and exit. | False |
orca registered-limit show¶
Show a registered limit.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 resource¶
Placement resources (class / provider / usage) — OSC parity.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca resource resource-class¶
Manage Placement resource classes (compound noun).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca resource resource-class create¶
Create a custom resource class (must start with CUSTOM_).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca resource resource-class delete¶
Delete a custom resource class.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca resource resource-class list¶
List resource classes.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 resource resource-class set¶
Rename a custom resource class (OSC parity).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New resource class name (must start with CUSTOM_). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca resource resource-class show¶
Show a resource class.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider¶
Manage Placement resource providers (compound noun).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider aggregate¶
Aggregate associations of a resource provider (OSC parity).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider aggregate aggregate-delete¶
Remove all aggregate associations from a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider aggregate aggregate-list¶
List aggregates associated with a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 resource resource-provider aggregate aggregate-set¶
Set (replace) aggregates on a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider aggregate-delete¶
Remove all aggregate associations from a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider aggregate-list¶
List aggregates associated with a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 resource resource-provider aggregate-set¶
Set (replace) aggregates on a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider allocation¶
Allocations against a resource provider (OSC parity).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider allocation delete¶
Delete all allocations for a consumer.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider allocation set¶
Set (replace) allocations for a consumer against a single resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--resource-provider |
text | Resource provider UUID. | Sentinel.UNSET |
--resource |
text | Resource class and amount, e.g. VCPU=4. Repeatable. | Sentinel.UNSET |
--project-id |
text | Consumer project UUID. | Sentinel.UNSET |
--user-id |
text | Consumer user UUID. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider allocation show¶
Show allocations for a consumer.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 resource resource-provider allocation unset¶
Drop a single resource-class allocation for a consumer.
Reads the consumer's full allocations, strips rc_name from
each provider entry (optionally only on --rp-uuid), then PUTs
the remaining allocations back. Empty entries are dropped.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--resource-class |
text | Resource class to clear (e.g. VCPU, MEMORY_MB). | Sentinel.UNSET |
--rp-uuid |
text | Optional: limit to allocations on this resource provider (default: all providers). | None |
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider create¶
Create a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--uuid |
text | Explicit UUID for the new provider. | None |
--parent-uuid |
text | UUID of the parent provider. | 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 resource resource-provider delete¶
Delete a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider inventory¶
Inventories of a resource provider (OSC parity).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider inventory class¶
Per-resource-class inventory verbs (OSC parity).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
# orca resource resource-provider inventory class inventory-set¶
Create or update a single inventory for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--total |
integer | Total inventory units. | Sentinel.UNSET |
--reserved |
integer | N/A | 0 |
--min-unit |
integer | N/A | 1 |
--max-unit |
integer | N/A | None |
--step-size |
integer | N/A | 1 |
--allocation-ratio |
float | N/A | 1.0 |
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider inventory inventory-delete¶
Delete an inventory for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider inventory inventory-delete-all¶
Delete all inventories for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider inventory inventory-list¶
List inventories for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 resource resource-provider inventory inventory-set¶
Create or update a single inventory for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--total |
integer | Total inventory units. | Sentinel.UNSET |
--reserved |
integer | N/A | 0 |
--min-unit |
integer | N/A | 1 |
--max-unit |
integer | N/A | None |
--step-size |
integer | N/A | 1 |
--allocation-ratio |
float | N/A | 1.0 |
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider inventory inventory-show¶
Show a single inventory for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 resource resource-provider inventory-delete¶
Delete an inventory for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider inventory-delete-all¶
Delete all inventories for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider inventory-list¶
List inventories for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 resource resource-provider inventory-set¶
Create or update a single inventory for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--total |
integer | Total inventory units. | Sentinel.UNSET |
--reserved |
integer | N/A | 0 |
--min-unit |
integer | N/A | 1 |
--max-unit |
integer | N/A | None |
--step-size |
integer | N/A | 1 |
--allocation-ratio |
float | N/A | 1.0 |
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider inventory-show¶
Show a single inventory for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 resource resource-provider list¶
List resource providers.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Filter by name. | None |
--uuid |
text | Filter by UUID. | None |
--in-tree |
text | Limit to providers in this tree. | 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 resource resource-provider set¶
Update a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--parent-uuid |
text | New parent provider UUID. | None |
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider show¶
Show a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 resource resource-provider trait¶
Traits associated with a resource provider (OSC parity).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider trait trait-delete¶
Remove all traits from a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider trait trait-list¶
List traits associated with a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 resource resource-provider trait trait-set¶
Set (replace) traits on a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider trait-delete¶
Remove all traits from a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider trait-list¶
List traits associated with a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 resource resource-provider trait-set¶
Set (replace) traits on a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider usage¶
Per-resource-provider usage (OSC parity).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca resource resource-provider usage usage¶
Show usages for a resource provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 resource usage¶
Inspect Placement usage.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca resource usage list¶
Show aggregated usages by project/user.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--project-id |
text | Filter by project UUID. | None |
--user-id |
text | Filter by user UUID. | 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 resource usage list¶
Show aggregated usages by project/user.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--project-id |
text | Filter by project UUID. | None |
--user-id |
text | Filter by user UUID. | 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 role¶
Manage roles and assignments (Keystone v3).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca role add¶
Grant a role to a user or group on a project or domain.
Examples:
orca role add --user
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--user |
text | User ID. | None |
--group |
text | Group ID. | None |
--project |
text | Project ID. | None |
--domain |
text | Domain ID. | None |
--help |
boolean | Show this message and exit. | False |
orca role assignment¶
Inspect role assignments (user/group on project/domain).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca role assignment list¶
List role assignments.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--user |
text | N/A | None |
--group |
text | N/A | None |
--project |
text | N/A | None |
--domain |
text | N/A | None |
--role |
text | N/A | None |
--effective |
boolean | Include inherited/effective assignments. | False |
--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 role assignment-list¶
List role assignments.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--user |
text | N/A | None |
--group |
text | N/A | None |
--project |
text | N/A | None |
--domain |
text | N/A | None |
--role |
text | N/A | None |
--effective |
boolean | Include inherited/effective assignments. | False |
--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 role create¶
Create a role.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | N/A | None |
--domain |
text | N/A | None |
--help |
boolean | Show this message and exit. | False |
orca role delete¶
Delete a role.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca role implied¶
Manage role inference (one role implies another).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca role implied create¶
Create an implied role (prior implies implied).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca role implied delete¶
Delete an implied role relationship.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip the interactive confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca role implied list¶
List all implied role relationships.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 role implied-create¶
Create an implied role (prior implies implied).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca role implied-delete¶
Delete an implied role relationship.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip the interactive confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca role implied-list¶
List all implied role relationships.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 role list¶
List roles.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--domain |
text | Filter by domain ID. | 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 role remove¶
Revoke a role from a user or group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--user |
text | User ID. | None |
--group |
text | Group ID. | None |
--project |
text | Project ID. | None |
--domain |
text | Domain ID. | None |
--help |
boolean | Show this message and exit. | False |
orca role set¶
Set role properties (rename or update description).
Examples:
orca role set
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New role name. | None |
--description |
text | New description. | None |
--help |
boolean | Show this message and exit. | False |
orca role show¶
Show role details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 router¶
Manage Neutron routers (alias of orca network router).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca router add¶
Attach a sub-resource to a router (interface, route).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca router add gateway¶
Set an external gateway on a router (OSC router add gateway).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--network |
text | External network ID to use as gateway. | Sentinel.UNSET |
--fixed-ip |
text | Fixed IP on the external network (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca router add interface¶
Add a subnet interface to a router.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--subnet-id |
text | Subnet to attach. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca router add port¶
Attach an existing port to a router (OSC router add port).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca router add route¶
Add a static route to a router (requires extraroute-atomic extension).
Example:
orca network router-add-route
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--destination |
text | Destination network (e.g. 10.1.0.0/24). | Sentinel.UNSET |
--nexthop |
text | Next-hop IP address. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca router add subnet¶
Add a subnet to a router (OSC router add subnet).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca router create¶
Create a router.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--external-network |
text | External network ID for gateway. | None |
--help |
boolean | Show this message and exit. | False |
orca router delete¶
Delete a router.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca router list¶
List routers.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 router ndp-proxy¶
Manage IPv6 NDP proxies on a router.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca router ndp-proxy create¶
Create an NDP proxy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--router-id |
text | N/A | Sentinel.UNSET |
--port-id |
text | N/A | Sentinel.UNSET |
--ip-address |
text | Specific IPv6 address (autopicked if omitted). | None |
--help |
boolean | Show this message and exit. | False |
orca router ndp-proxy delete¶
Delete an NDP proxy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca router ndp-proxy list¶
List NDP proxies.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--router-id |
text | Filter by router. | 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 router ndp-proxy set¶
Update an NDP proxy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | N/A | None |
--description |
text | N/A | None |
--help |
boolean | Show this message and exit. | False |
orca router ndp-proxy show¶
Show an NDP proxy.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 router remove¶
Detach a sub-resource from a router.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca router remove gateway¶
Clear a router's external gateway (OSC router remove gateway).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca router remove interface¶
Remove a subnet interface from a router.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--subnet-id |
text | Subnet to detach. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca router remove port¶
Detach a port from a router (OSC router remove port).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca router remove route¶
Remove a static route from a router (requires extraroute-atomic extension).
Example:
orca network router-remove-route
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--destination |
text | Destination network to remove. | Sentinel.UNSET |
--nexthop |
text | Next-hop IP address. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca router remove subnet¶
Remove a subnet from a router (OSC router remove subnet).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca router show¶
Show router details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 router update¶
Update a router.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--external-network |
text | New external gateway network ID. | None |
--help |
boolean | Show this message and exit. | False |
orca router update¶
Update a router.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--external-network |
text | New external gateway network ID. | None |
--help |
boolean | Show this message and exit. | False |
orca router update¶
Update a router.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--external-network |
text | New external gateway network ID. | None |
--help |
boolean | Show this message and exit. | False |
orca secret¶
Manage secrets & containers (Barbican key-manager).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca secret acl¶
Manage per-secret ACLs (read access).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca secret acl delete¶
Delete the ACL on a secret (revert to project-wide access).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca secret acl get¶
Get the ACL for a secret.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 secret acl set¶
Set the ACL on a secret.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--user |
text | User ID to grant read access to (repeatable). | Sentinel.UNSET |
--project-access / --no-project-access |
boolean | Allow all project users read access. | True |
--help |
boolean | Show this message and exit. | False |
orca secret acl set¶
Set the ACL on a secret.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--user |
text | User ID to grant read access to (repeatable). | Sentinel.UNSET |
--project-access / --no-project-access |
boolean | Allow all project users read access. | True |
--help |
boolean | Show this message and exit. | False |
orca secret acl user¶
Per-user ACL operations on a secret.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca secret acl user add¶
Add users to a secret's read ACL.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--user |
text | User ID to grant read access (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca secret acl user remove¶
Remove users from a secret's read ACL.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--user |
text | User ID to revoke read access from (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca secret acl-delete¶
Delete the ACL on a secret (revert to project-wide access).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca secret acl-get¶
Get the ACL for a secret.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 secret acl-set¶
Set the ACL on a secret.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--user |
text | User ID to grant read access to (repeatable). | Sentinel.UNSET |
--project-access / --no-project-access |
boolean | Allow all project users read access. | True |
--help |
boolean | Show this message and exit. | False |
orca secret consumer¶
Manage consumers registered on Barbican containers.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca secret consumer create¶
Register a consumer on a container.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Consumer name (free-form). | Sentinel.UNSET |
--url |
text | Consumer URL (e.g. the resource that uses the secret). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca secret consumer delete¶
Remove a consumer from a container.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Consumer name to remove. | Sentinel.UNSET |
--url |
text | Consumer URL to remove. | Sentinel.UNSET |
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca secret consumer list¶
List consumers registered on a container.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 secret container¶
Manage Barbican secret containers.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca secret container container-create¶
Create a secret container.
Example:
orca secret container-create --name my-cert --type certificate \
--secret certificate=
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Container name. | None |
--type |
choice (generic | rsa | certificate) |
Container type. | generic |
--secret |
text | Secret reference (repeatable): name= |
Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca secret container container-delete¶
Delete a secret container.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca secret container container-list¶
List secret containers.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 secret container container-show¶
Show secret container details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 secret container container-show¶
Show secret container details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 secret container-create¶
Create a secret container.
Example:
orca secret container-create --name my-cert --type certificate \
--secret certificate=
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Container name. | None |
--type |
choice (generic | rsa | certificate) |
Container type. | generic |
--secret |
text | Secret reference (repeatable): name= |
Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca secret container-delete¶
Delete a secret container.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca secret container-list¶
List secret containers.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 secret container-show¶
Show secret container details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 secret create¶
Create a secret.
Examples: orca secret create my-password --payload "s3cret" --secret-type passphrase orca secret create my-key --algorithm AES --bit-length 256 --secret-type symmetric
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--payload |
text | Secret payload (inline). | None |
--payload-content-type |
text | MIME type of payload. | text/plain |
--secret-type |
choice (symmetric | public | private | passphrase | certificate | opaque) |
N/A | opaque |
--algorithm |
text | Algorithm (e.g. AES, RSA). | None |
--bit-length |
integer | Bit length. | None |
--expiration |
text | Expiration datetime (ISO 8601). | None |
--help |
boolean | Show this message and exit. | False |
orca secret delete¶
Delete a secret.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca secret get-payload¶
Retrieve secret payload.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca secret list¶
List secrets.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--limit |
integer | Max results. | 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 secret order¶
Manage Barbican key/certificate orders.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca secret order order-create¶
Create a secret order (async key/certificate generation).
Examples: orca secret order-create --type key --algorithm aes --bit-length 256 orca secret order-create --type asymmetric --algorithm rsa --bit-length 2048
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (key | asymmetric | certificate) |
Order type. | Sentinel.UNSET |
--name |
text | Secret name for the resulting secret. | None |
--algorithm |
text | Key algorithm (e.g. aes, rsa). | None |
--bit-length |
integer | Key bit length. | None |
--mode |
text | Encryption mode (e.g. cbc). | None |
--help |
boolean | Show this message and exit. | False |
orca secret order order-delete¶
Delete a secret order.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca secret order order-list¶
List secret orders.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 secret order order-show¶
Show an order's details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 secret order order-show¶
Show an order's details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 secret order-create¶
Create a secret order (async key/certificate generation).
Examples: orca secret order-create --type key --algorithm aes --bit-length 256 orca secret order-create --type asymmetric --algorithm rsa --bit-length 2048
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (key | asymmetric | certificate) |
Order type. | Sentinel.UNSET |
--name |
text | Secret name for the resulting secret. | None |
--algorithm |
text | Key algorithm (e.g. aes, rsa). | None |
--bit-length |
integer | Key bit length. | None |
--mode |
text | Encryption mode (e.g. cbc). | None |
--help |
boolean | Show this message and exit. | False |
orca secret order-delete¶
Delete a secret order.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca secret order-list¶
List secret orders.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 secret order-show¶
Show an order's details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 secret show¶
Show secret metadata.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 secret show¶
Show secret metadata.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 secret store¶
Upload payload data to an existing metadata-only secret.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--payload |
text | Inline payload (use --payload-file for binary). | Sentinel.UNSET |
--payload-file |
file | File containing the payload (binary safe). | Sentinel.UNSET |
--content-type |
text | Payload MIME type. | application/octet-stream |
--content-encoding |
text | Payload encoding (e.g. base64 for binary inside text). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca secret store¶
Upload payload data to an existing metadata-only secret.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--payload |
text | Inline payload (use --payload-file for binary). | Sentinel.UNSET |
--payload-file |
file | File containing the payload (binary safe). | Sentinel.UNSET |
--content-type |
text | Payload MIME type. | application/octet-stream |
--content-encoding |
text | Payload encoding (e.g. base64 for binary inside text). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca security-group¶
Manage security groups.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca security-group cleanup¶
Find security groups not attached to any port.
Lists orphaned SGs that are likely leftovers from tests or deleted instances. Use --delete to remove them.
The 'default' security group is always skipped.
Examples: orca security-group cleanup # dry run orca security-group cleanup --delete # interactive delete orca security-group cleanup --delete -y # auto-delete all
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--delete, -d |
boolean | Actually delete the unused security groups. | False |
--yes, -y |
boolean | Skip confirmation (with --delete). | False |
--help |
boolean | Show this message and exit. | False |
orca security-group clone¶
Clone a security group (copy all rules to a new group).
Examples:
orca security-group clone
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | Description for the new group. | None |
--help |
boolean | Show this message and exit. | False |
orca security-group create¶
Create a security group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | Description. | `` |
--help |
boolean | Show this message and exit. | False |
orca security-group delete¶
Delete a security group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca security-group list¶
List security groups.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 security-group rule¶
Manage security group rules.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca security-group rule add¶
Add a rule to a security group.
Examples:
orca security-group rule-add
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--direction |
choice (ingress | egress) |
N/A | Sentinel.UNSET |
--protocol |
text | Protocol (tcp, udp, icmp, or number). | None |
--port-min |
integer | Min port (or single port). | None |
--port-max |
integer | Max port. Defaults to port-min. | None |
--remote-ip |
text | Remote IP prefix (CIDR). | None |
--remote-group |
text | Remote security group ID. | None |
--ethertype |
choice (IPv4 | IPv6) |
N/A | IPv4 |
--help |
boolean | Show this message and exit. | False |
orca security-group rule add¶
Add a rule to a security group.
Examples:
orca security-group rule-add
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--direction |
choice (ingress | egress) |
N/A | Sentinel.UNSET |
--protocol |
text | Protocol (tcp, udp, icmp, or number). | None |
--port-min |
integer | Min port (or single port). | None |
--port-max |
integer | Max port. Defaults to port-min. | None |
--remote-ip |
text | Remote IP prefix (CIDR). | None |
--remote-group |
text | Remote security group ID. | None |
--ethertype |
choice (IPv4 | IPv6) |
N/A | IPv4 |
--help |
boolean | Show this message and exit. | False |
orca security-group rule delete¶
Delete a security group rule.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca security-group rule list¶
List security group rules (across all groups, or filtered).
Examples:
orca security-group rule list
orca security-group rule list --group-id
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--group-id |
text | Filter rules to a single security group. | None |
--direction |
choice (ingress | egress) |
Filter by direction. | None |
--protocol |
text | Filter by protocol. | 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 security-group rule show¶
Show a security group rule's details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 security-group rule-add¶
Add a rule to a security group.
Examples:
orca security-group rule-add
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--direction |
choice (ingress | egress) |
N/A | Sentinel.UNSET |
--protocol |
text | Protocol (tcp, udp, icmp, or number). | None |
--port-min |
integer | Min port (or single port). | None |
--port-max |
integer | Max port. Defaults to port-min. | None |
--remote-ip |
text | Remote IP prefix (CIDR). | None |
--remote-group |
text | Remote security group ID. | None |
--ethertype |
choice (IPv4 | IPv6) |
N/A | IPv4 |
--help |
boolean | Show this message and exit. | False |
orca security-group rule-delete¶
Delete a security group rule.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca security-group show¶
Show security group details and rules.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 security-group update¶
Update a security group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--help |
boolean | Show this message and exit. | False |
orca security-group update¶
Update a security group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--help |
boolean | Show this message and exit. | False |
orca security-group update¶
Update a security group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--help |
boolean | Show this message and exit. | False |
orca server¶
Manage compute servers.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server add¶
Attach a sub-resource to a server (volume, port, network, ...).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server add fixed-ip¶
Add a fixed IP from a network to a server.
Example:
orca server add-fixed-ip
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server add floating-ip¶
Associate a floating IP with a server (OSC parity).
IP_ADDRESS may be either the floating IP itself (e.g.
172.24.4.10) or its ID.
Examples:
orca server add floating-ip
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--fixed-ip-address |
text | Bind the FIP to a specific fixed IP of the server (otherwise the first port is chosen). | None |
--help |
boolean | Show this message and exit. | False |
orca server add network¶
Attach a network to a server (creates a new port automatically).
Examples:
orca server add network
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--fixed-ip |
text | Pin the new port to a specific fixed IP on the network. | None |
--help |
boolean | Show this message and exit. | False |
orca server add port¶
Attach an existing Neutron port to a server.
Example:
orca server add-port
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server add security-group¶
Add a security group to a running server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server add volume¶
Attach a volume to a server.
Examples:
orca server attach-volume
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--device |
text | Device name (e.g. /dev/vdb). Auto-assigned if omitted. | None |
--help |
boolean | Show this message and exit. | False |
orca server add-fixed-ip¶
Add a fixed IP from a network to a server.
Example:
orca server add-fixed-ip
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server add-network¶
Attach a network to a server (creates a new port automatically).
Examples:
orca server add network
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--fixed-ip |
text | Pin the new port to a specific fixed IP on the network. | None |
--help |
boolean | Show this message and exit. | False |
orca server add-port¶
Attach an existing Neutron port to a server.
Example:
orca server add-port
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server add-security-group¶
Add a security group to a running server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server attach-interface¶
Attach a network interface to a server (deprecated façade).
Use one of these instead, depending on what you have:
orca server add port
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--port-id |
text | Existing port ID to attach. | None |
--net-id |
text | Network ID (creates a new port automatically). | None |
--fixed-ip |
text | Fixed IP for the new port (requires --net-id). | None |
--help |
boolean | Show this message and exit. | False |
orca server attach-volume¶
Attach a volume to a server.
Examples:
orca server attach-volume
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--device |
text | Device name (e.g. /dev/vdb). Auto-assigned if omitted. | None |
--help |
boolean | Show this message and exit. | False |
orca server backup¶
Create a Nova-managed backup image with rotation.
Unlike orca server snapshot / server image create (one-shot
snapshot), this triggers Nova's createBackup action which tags
the produced image with the backup type and keeps only the rotation
most recent images of that type.
Examples:
orca server backup
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Backup image name. | Sentinel.UNSET |
--type |
text | Backup type tag (e.g. daily, weekly). Nova rotates backups per type independently. |
daily |
--rotation |
integer | Keep at most this many backups of the same type — Nova deletes the oldest beyond it. | 7 |
--property |
text | Image metadata (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca server backup_group¶
OSC-style server backup sub-group (Nova createBackup).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server bulk¶
Perform an action on multiple servers at once.
Examples: orca server bulk stop --name "dev-" orca server bulk delete --status ERROR --yes orca server bulk reboot --name "web-" --status ACTIVE
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Filter by name (supports wildcards: dev-*). | None |
--status |
text | Filter by status (e.g. ERROR, SHUTOFF). | None |
--all |
boolean | Select all servers (use with caution). | False |
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca server clone¶
Clone a server — recreate one with the same config.
Copies flavor, network, security groups, key pair, and image from
the source server into a new one. The clone's boot mode follows the
same policy as orca server create: boot-from-image by default,
fallback to boot-from-volume only when the flavor has disk == 0.
Override with --boot-from-image / --boot-from-volume.
Examples:
orca server clone
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Name for the cloned server. | Sentinel.UNSET |
--disk-size |
integer | Boot volume size in GB (BFV only). Default: same as source. | None |
--boot-from-image |
boolean | Force boot from the image on the compute's local disk (requires flavor disk > 0). | False |
--boot-from-volume |
boolean | Force boot from a Cinder volume created from the image. | False |
--help |
boolean | Show this message and exit. | False |
orca server confirm-resize¶
Confirm a pending resize.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server console¶
Inspect the server console (log, URL).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server console log¶
Show the server console output (boot log).
Examples:
orca server console-log
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--lines |
integer | Number of lines to retrieve (0 = all). | 50 |
--help |
boolean | Show this message and exit. | False |
orca server console url¶
Get a URL to access the server console (VNC/SPICE/serial).
Examples:
orca server console-url
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (novnc | xvpvnc | spice-html5 | rdp-html5 | serial) |
Console type. | novnc |
--open |
boolean | Open the URL in the default system browser immediately. | False |
--help |
boolean | Show this message and exit. | False |
orca server console-log¶
Show the server console output (boot log).
Examples:
orca server console-log
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--lines |
integer | Number of lines to retrieve (0 = all). | 50 |
--help |
boolean | Show this message and exit. | False |
orca server console-url¶
Get a URL to access the server console (VNC/SPICE/serial).
Examples:
orca server console-url
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
choice (novnc | xvpvnc | spice-html5 | rdp-html5 | serial) |
Console type. | novnc |
--open |
boolean | Open the URL in the default system browser immediately. | False |
--help |
boolean | Show this message and exit. | False |
orca server create¶
Create a new server.
By default the server boots from the image directly on the compute's
local disk (flavor disk field). Flavors declared with disk=0
fall back to boot-from-volume automatically since Nova cannot boot
them otherwise. Use --boot-from-image or --boot-from-volume
to override the auto-detection.
Non-interactive example:
orca server create \
--name my-vm \
--flavor
Interactive wizard: orca server create -i
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Server name. | None |
--flavor |
text | Flavor ID (see 'orca flavor list'). | None |
--image |
text | Image ID (see 'orca image list'). | None |
--disk-size |
integer | Boot volume size in GB. | 20 |
--network |
text | Network ID (see 'orca network list'). | None |
--key-name |
text | SSH key pair name (see 'orca keypair list'). | None |
--security-group |
text | Security group name (repeatable). | Sentinel.UNSET |
--boot-from-image |
boolean | Force boot from the image on the compute's local disk (requires flavor disk > 0). | False |
--boot-from-volume |
boolean | Force boot from a Cinder volume created from the image. | False |
--wait |
boolean | Wait until the server reaches ACTIVE status. | False |
--interactive, -i |
boolean | Step-by-step wizard — browse images, flavors, and networks interactively. | False |
--help |
boolean | Show this message and exit. | False |
orca server create-image¶
Create a snapshot image from a server.
See also: For boot-from-volume instances, the resulting image is a 0-byte shell that points at a Cinder snapshot — not a downloadable image. To obtain a self-contained, transportable image, use: orca volume snapshot create --force orca volume create --snapshot-id ... orca volume upload-to-image ...
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server delete¶
Delete a server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--dry-run |
boolean | Show what would be deleted without deleting. | False |
--wait |
boolean | Wait until the server is fully deleted. | False |
--help |
boolean | Show this message and exit. | False |
orca server detach-interface¶
Detach a network interface (port) from a server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server detach-volume¶
Detach a volume from a server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server diff¶
Compare two servers side by side.
Highlights differences in flavor, image, network, security groups, status, and other configuration.
Examples:
orca server diff
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server dump¶
Manage crash dumps for a server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server dump create¶
Trigger a crash dump on a server (requires Nova microversion ≥ 2.17).
Sends an NMI to the server which causes the guest OS to generate a crash dump. The server must be ACTIVE.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server dump-create¶
Trigger a crash dump on a server (requires Nova microversion ≥ 2.17).
Sends an NMI to the server which causes the guest OS to generate a crash dump. The server must be ACTIVE.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server evacuate¶
Evacuate a server from a failed host to another.
Examples:
orca server evacuate
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--host |
text | Target host (admin only, optional). | None |
--on-shared-storage / --no-shared-storage |
boolean | Whether server disks are on shared storage. | False |
--password |
text | Admin password for the evacuated server. | None |
--help |
boolean | Show this message and exit. | False |
orca server event¶
Browse Nova instance actions for a server (alias of orca event).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server event list¶
List instance actions for a server.
Examples:
orca event list
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 server event show¶
Show details for a single instance action, including sub-events.
Examples:
orca event show
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 server image¶
Image-level operations on a server (snapshot, ...).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server image create¶
Create a snapshot image from a server.
See also: For boot-from-volume instances, the resulting image is a 0-byte shell that points at a Cinder snapshot — not a downloadable image. To obtain a self-contained, transportable image, use: orca volume snapshot create --force orca volume create --snapshot-id ... orca volume upload-to-image ...
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server interface¶
Network interfaces attached to a server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server interface list¶
List network interfaces attached to a server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 server list¶
List servers.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--limit |
integer | Max number of servers to return. | 50 |
--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 server list-interfaces¶
List network interfaces attached to a server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 server list-volumes¶
List volumes attached to a server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 server live-migrate¶
Live-migrate a server (deprecated — use 'server migrate --live').
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--host |
text | Target host (admin only, optional). | None |
--block-migration / --no-block-migration |
boolean | Copy disk over the network (no shared storage needed). | False |
--help |
boolean | Show this message and exit. | False |
orca server lock¶
Lock a server (prevent actions by non-admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server metadata¶
Read or modify server metadata.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server metadata list¶
Show all metadata key/value pairs for a server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server metadata-list¶
Show all metadata key/value pairs for a server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server migrate¶
Migrate a server to another host (cold by default).
Examples:
orca server migrate
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--host |
text | Target host (admin only, optional). | None |
--live |
boolean | Live-migrate (no downtime) instead of cold migration. | False |
--block-migration / --no-block-migration |
boolean | Live mode only: copy disk over the network (slower but no shared storage needed). | False |
--help |
boolean | Show this message and exit. | False |
orca server migration¶
Inspect or control server migrations.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server migration abort¶
Abort an in-progress live migration.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server migration confirm-resize¶
Confirm a pending resize.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server migration force-complete¶
Force an in-progress live migration to complete.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server migration list¶
List migrations for a server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 server migration revert-resize¶
Revert a pending resize (restore original flavor).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server migration show¶
Show details of a specific migration.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 server migration-abort¶
Abort an in-progress live migration.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server migration-force-complete¶
Force an in-progress live migration to complete.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server migration-list¶
List migrations for a server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 server migration-show¶
Show details of a specific migration.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 server password¶
Retrieve and decrypt the server admin password.
The password is encrypted with your SSH public key at boot and stored in the server metadata. This command fetches it and decrypts it locally with your private key (RSA only).
Examples:
orca server password
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--key |
path | Path to the RSA private key used to decrypt. Tries ~/.ssh/orca-* if omitted. | None |
--raw |
boolean | Print the encrypted password without decrypting. | False |
--help |
boolean | Show this message and exit. | False |
orca server pause¶
Pause a server (freeze in memory).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server port-forward¶
Create an SSH tunnel (port forward) to a server.
PORT_MAPPING format: LOCAL_PORT:REMOTE_HOST:REMOTE_PORT
Examples:
orca server port-forward
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--user, -u |
text | SSH user. Default: 'root'. | None |
--key, -i |
path | Private key path. | None |
--ssh-port, -p |
integer | SSH port on the server. | 22 |
--reverse, -R |
boolean | Reverse tunnel (remote → local). | False |
--background, -b |
boolean | Run tunnel in background (-f -N). | False |
--help |
boolean | Show this message and exit. | False |
orca server reboot¶
Reboot a server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--hard |
boolean | Perform a hard reboot. | False |
--wait |
boolean | Wait until the server reaches ACTIVE status. | False |
--help |
boolean | Show this message and exit. | False |
orca server rebuild¶
Rebuild a server with a new image (reinstall).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--image |
text | New image ID. | Sentinel.UNSET |
--name |
text | New server name (optional). | None |
--password |
text | New admin password (optional). | None |
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca server remove¶
Detach a sub-resource from a server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server remove fixed-ip¶
Remove a specific fixed IP from a server.
Example:
orca server remove-fixed-ip
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server remove floating-ip¶
Disassociate a floating IP from a server (OSC parity).
Example:
orca server remove floating-ip
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server remove interface¶
Detach a network interface (port) from a server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server remove network¶
Detach all interfaces on a specific network from a server.
Looks up interfaces by network ID and removes each one.
Example:
orca server remove-network
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server remove port¶
Detach a Neutron port from a server.
Example:
orca server remove-port
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server remove security-group¶
Remove a security group from a running server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server remove volume¶
Detach a volume from a server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server remove-fixed-ip¶
Remove a specific fixed IP from a server.
Example:
orca server remove-fixed-ip
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server remove-network¶
Detach all interfaces on a specific network from a server.
Looks up interfaces by network ID and removes each one.
Example:
orca server remove-network
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server remove-port¶
Detach a Neutron port from a server.
Example:
orca server remove-port
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server remove-security-group¶
Remove a security group from a running server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server rename¶
Rename a server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server rescue¶
Put a server in rescue mode.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--image |
text | Rescue image ID (optional). | None |
--password |
text | Admin password for rescue mode. | None |
--help |
boolean | Show this message and exit. | False |
orca server resize¶
Resize a server to a new flavor.
OSC's server resize confirm/revert form is exposed under
orca server migration confirm/revert (same Nova action) —
Click does not support a group with both a positional argument
and sub-commands.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--flavor |
text | Target flavor ID. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca server restore¶
Restore a soft-deleted server.
Only valid when Nova is configured with soft-delete (reclaim_instance_interval > 0) and the server status is SOFT_DELETED.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server resume¶
Resume a suspended server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server revert-resize¶
Revert a pending resize (restore original flavor).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server server-group¶
Manage server groups (Nova).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server server-group create¶
Create a server group.
Policies: anti-affinity — servers on different hosts (hard) affinity — servers on same host (hard) soft-anti-affinity — prefer different hosts soft-affinity — prefer same host
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--policy |
choice (anti-affinity | affinity | soft-anti-affinity | soft-affinity) |
Scheduling policy. | anti-affinity |
--help |
boolean | Show this message and exit. | False |
orca server server-group delete¶
Delete a server group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca server server-group list¶
List server groups.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--all |
boolean | List server groups for all projects (admin). | False |
--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 server server-group show¶
Show server group details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 server set¶
Set server properties, metadata, tags, or admin password.
Examples:
orca server set
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New display name. | None |
--property |
text | Metadata key=value (repeatable). | Sentinel.UNSET |
--tag |
text | Tag to set (repeatable, replaces all existing tags). | Sentinel.UNSET |
--admin-password |
text | New admin/root password (injected via Nova). | None |
--help |
boolean | Show this message and exit. | False |
orca server shelve¶
Shelve a server (snapshot + shut down, frees resources).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--wait |
boolean | Wait until the server reaches SHELVED_OFFLOADED status. | False |
--help |
boolean | Show this message and exit. | False |
orca server show¶
Show server details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 server snapshot¶
Snapshot a server AND all its attached volumes.
Creates a server image snapshot plus a Cinder snapshot for each attached volume — all in one command.
Examples:
orca server snapshot
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Snapshot name prefix. Default: server name. | None |
--help |
boolean | Show this message and exit. | False |
orca server ssh¶
SSH into a server by name or ID.
Auto-resolves the IP (floating > fixed), the SSH user (from image
os_distro metadata), and the private key (matched from the attached
keypair name in ~/.ssh/).
Examples: orca server ssh web-1 # auto-detect everything orca server ssh web-1 ls /var/log # run a remote command orca server ssh web-1 -u root -i ~/.ssh/k # override user / key orca server ssh web-1 --fixed # use fixed IP orca server ssh web-1 --dry-run # print command, don't exec
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--user, -u |
text | SSH user. Default: auto-detected from image os_distro. | None |
--key, -i |
path | Private key path. Default: matched from keypair name in ~/.ssh. | None |
--port, -p |
integer | SSH port. | 22 |
--fixed |
boolean | Use the fixed IP instead of the floating IP. | False |
--dry-run |
boolean | Print the ssh command without executing it. | False |
--extra |
text | Extra SSH options (e.g. '-o StrictHostKeyChecking=no'). | None |
--help |
boolean | Show this message and exit. | False |
orca server start¶
Start (resume) a stopped server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--wait |
boolean | Wait until the server reaches ACTIVE status. | False |
--help |
boolean | Show this message and exit. | False |
orca server stop¶
Stop (shut down) a server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--wait |
boolean | Wait until the server reaches SHUTOFF status. | False |
--help |
boolean | Show this message and exit. | False |
orca server suspend¶
Suspend a server (save to disk).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server tag¶
Read or modify server tags.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server tag list¶
List tags on a server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server tag-list¶
List tags on a server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server unlock¶
Unlock a locked server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server unpause¶
Unpause a paused server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server unrescue¶
Exit rescue mode.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server unset¶
Remove metadata keys or tags from a server.
Examples:
orca server unset
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--property |
text | Metadata key to remove (repeatable). | Sentinel.UNSET |
--tag |
text | Tag to remove (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca server unshelve¶
Unshelve (restore) a shelved server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--wait |
boolean | Wait until the server reaches ACTIVE status. | False |
--help |
boolean | Show this message and exit. | False |
orca server volume¶
Volumes attached to a server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server volume list¶
List volumes attached to a server.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 server volume set¶
Update a volume attachment (flip delete-on-termination).
Examples:
orca server volume set
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--delete-on-termination / --preserve-on-termination |
boolean | Whether deleting the server should also delete this volume attachment. Requires Nova microversion 2.85 (Yoga+). | None |
--help |
boolean | Show this message and exit. | False |
orca server volume set¶
Update a volume attachment (flip delete-on-termination).
Examples:
orca server volume set
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--delete-on-termination / --preserve-on-termination |
boolean | Whether deleting the server should also delete this volume attachment. Requires Nova microversion 2.85 (Yoga+). | None |
--help |
boolean | Show this message and exit. | False |
orca server wait¶
Wait for a server to reach a target status.
Polls the server status until it matches the target or the timeout is reached. Useful in scripts and automation.
Examples:
orca server wait
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--status |
text | Target status to wait for. | ACTIVE |
--timeout |
integer | Timeout in seconds. | 300 |
--interval |
integer | Poll interval in seconds. | 5 |
--help |
boolean | Show this message and exit. | False |
orca server-group¶
Manage server groups (Nova).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca server-group create¶
Create a server group.
Policies: anti-affinity — servers on different hosts (hard) affinity — servers on same host (hard) soft-anti-affinity — prefer different hosts soft-affinity — prefer same host
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--policy |
choice (anti-affinity | affinity | soft-anti-affinity | soft-affinity) |
Scheduling policy. | anti-affinity |
--help |
boolean | Show this message and exit. | False |
orca server-group delete¶
Delete a server group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca server-group list¶
List server groups.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--all |
boolean | List server groups for all projects (admin). | False |
--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 server-group show¶
Show server group details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 service¶
Manage Keystone services (service catalog).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca service create¶
Create a Keystone service.
Accepts the service name as either a positional argument
(orca service create my-svc --type ...) — matching the
user / project / domain / role / group
CRUDs — or via the legacy --name flag.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Service name (alternative to the positional argument). | None |
--type |
text | Service type (e.g. identity, compute). | Sentinel.UNSET |
--description |
text | Service description. | None |
--enable / --disable |
boolean | Enable or disable the service. | True |
--help |
boolean | Show this message and exit. | False |
orca service delete¶
Delete a Keystone service.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca service list¶
List Keystone services.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
text | Filter by service type. | 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 service set¶
Update a Keystone service.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--type |
text | New type. | None |
--description |
text | New description. | None |
--enable / --disable |
boolean | Enable or disable. | None |
--help |
boolean | Show this message and exit. | False |
orca service show¶
Show service details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 service-provider¶
Manage Keystone service providers (federation).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca service-provider create¶
Create a service provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--auth-url |
text | Remote Keystone auth URL. | Sentinel.UNSET |
--sp-url |
text | Service provider SAML2 endpoint. | Sentinel.UNSET |
--description |
text | N/A | `` |
--enable / --disable |
boolean | N/A | True |
--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 service-provider delete¶
Delete a service provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | N/A | False |
--help |
boolean | Show this message and exit. | False |
orca service-provider list¶
List service providers.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 service-provider set¶
Update a service provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--auth-url |
text | N/A | None |
--sp-url |
text | N/A | None |
--description |
text | N/A | None |
--enable / --disable |
boolean | N/A | None |
--help |
boolean | Show this message and exit. | False |
orca service-provider show¶
Show a service provider.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 setup¶
Interactive assistant to configure your OpenStack credentials.
Creates or edits a profile. Use --profile to target a specific profile.
Examples: orca setup # edit the active profile orca setup --profile staging # create/edit 'staging' profile
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--profile, -p |
text | Profile name to create/edit. Default: active profile. | None |
--help |
boolean | Show this message and exit. | False |
orca share¶
Manage Manila shared file systems (shares, access rules, snapshots).
Manila is a multi-tenant NFS/CIFS/CephFS-as-a-service. Use orca share
create to allocate a share, orca share access allow to expose it
to a client IP, then mount the export location.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca share access¶
Manage share access rules (NFS IP allow, CIFS user, CephFS x509).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca share access allow¶
Grant access to a share.
Examples:
orca share access allow
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--access-type |
choice (ip | user | cert | cephx) |
ip (NFS) | user (CIFS) |
--access-to |
text | The principal: IP/CIDR for ip, username for user, CN for cert, client name for cephx. | Sentinel.UNSET |
--access-level |
choice (rw | ro) |
N/A | rw |
--help |
boolean | Show this message and exit. | False |
orca share access deny¶
Revoke an access rule from a share.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca share access list¶
List access rules attached to a share.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 share create¶
Create a share.
Examples:
orca share create my-nfs --size 50
orca share create scratch --size 100 --protocol CEPHFS --availability-zone az1
orca share create from-snap --size 10 --snapshot-id
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--size |
integer | Share size in GB. | Sentinel.UNSET |
--protocol |
choice (NFS | CIFS | GLUSTERFS | HDFS | CEPHFS | MAPRFS) |
Share protocol. | NFS |
--description |
text | Free-text description. | None |
--share-type |
text | Share type name or ID (omit for the operator default). | None |
--share-network |
text | Share network ID for multi-tenant deployments. | None |
--snapshot-id |
text | Create from an existing snapshot. | None |
--availability-zone |
text | Target AZ. | None |
--public / --private |
boolean | Share visibility (default: private). | False |
--help |
boolean | Show this message and exit. | False |
orca share delete¶
Delete a share.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca share extend¶
Extend a share (grow only).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--size |
integer | New total size in GB. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca share list¶
List shares.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 share set¶
Update a share's name / description / visibility.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New display name. | None |
--description |
text | New description. | None |
--public / --private |
boolean | Switch visibility. | None |
--help |
boolean | Show this message and exit. | False |
orca share show¶
Show share details + export locations.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 share shrink¶
Shrink a share (only allowed if the backend supports it).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--size |
integer | New total size in GB. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca share snapshot¶
Manage share snapshots.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca share snapshot create¶
Snapshot a share.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Snapshot name. | None |
--description |
text | Snapshot description. | None |
--help |
boolean | Show this message and exit. | False |
orca share snapshot delete¶
Delete a snapshot.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca share snapshot list¶
List share snapshots.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 share snapshot show¶
Show snapshot details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 share type¶
Inspect share types (admin defines, users select).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca share type list¶
List share types defined by the operator.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 share type show¶
Show a share type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 software¶
Heat software configs and deployments.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca software config¶
Heat software configurations.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca software config create¶
Create a Heat software config.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--group |
text | Config group (e.g. script, ansible, puppet). | script |
--config |
text | Raw config payload (inline text). | None |
--config-file |
path | Read the config payload from this file. | None |
--definition-file |
path | YAML/JSON file with inputs / outputs definitions. |
None |
--help |
boolean | Show this message and exit. | False |
orca software config delete¶
Delete a software config.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
-y, --yes |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca software config list¶
List software configs.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--limit |
integer | Server-side pagination limit. | 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 software config show¶
Show a software config.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 software deployment¶
Heat software deployments.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca software deployment create¶
Create a software deployment.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--server |
text | Server (Nova UUID) running this deployment. | Sentinel.UNSET |
--config |
text | Software config to deploy. | Sentinel.UNSET |
--action |
choice (CREATE | UPDATE | DELETE | SUSPEND | RESUME) |
Action to record on the deployment. | CREATE |
--help |
boolean | Show this message and exit. | False |
orca software deployment delete¶
Delete a software deployment.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
-y, --yes |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca software deployment list¶
List software deployments (optionally filtered by server).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--server |
text | Filter by server (Nova UUID). | 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 software deployment metadata¶
Per-server deployment metadata.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca software deployment metadata show¶
Show the aggregated deployment metadata for a server.
Heat exposes GET /v1/software_deployments/metadata/{server_id}
which returns the list of metadata snippets all deployments on
that server have produced.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 software deployment output¶
Software deployment output access.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca software deployment output show¶
Show a software deployment's output values.
Without OUTPUT_NAME, lists every output the deployment recorded. With OUTPUT_NAME, only that key (or 404 if absent).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 software deployment show¶
Show a software deployment.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 stack¶
Manage Heat stacks (orchestration).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca stack abandon¶
Abandon a stack (delete without destroying resources).
Exports the stack's resource data, then removes the stack record from Heat without actually deleting the underlying OpenStack resources.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--output-file |
text | Save abandoned stack data to a JSON file. | None |
--help |
boolean | Show this message and exit. | False |
orca stack adopt¶
Adopt existing resources into a new stack.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
-t, --template |
file | Template file (yaml/json). | Sentinel.UNSET |
--adopt-file |
file | JSON file with the adopt_stack_data payload (existing resources to adopt). | Sentinel.UNSET |
--parameter |
text | Parameter key=value (repeatable). | Sentinel.UNSET |
--timeout |
integer | Timeout in minutes. | None |
--help |
boolean | Show this message and exit. | False |
orca stack cancel¶
Cancel an in-progress stack update.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca stack check¶
Check a stack (verify resource states).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca stack create¶
Create a stack.
Examples: orca stack create my-stack -t template.yaml orca stack create my-stack -t template.yaml -e env.yaml --parameter key1=val1 orca stack create my-stack -t template.yaml --timeout 30 --wait
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--template, -t |
text | Template file path or URL. | Sentinel.UNSET |
--environment, -e |
text | Environment file path. | None |
--parameter |
text | Parameter key=value (repeatable). | Sentinel.UNSET |
--timeout |
integer | Timeout in minutes. | None |
--wait |
boolean | Wait for stack to reach terminal state. | False |
--help |
boolean | Show this message and exit. | False |
orca stack delete¶
Delete a stack.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--wait |
boolean | Wait for stack deletion to complete. | False |
--help |
boolean | Show this message and exit. | False |
orca stack diff¶
Compare a local template with a deployed stack's template.
Fetches the currently deployed template from Heat and diffs it
against the local file so you can review changes before running
orca stack update.
Examples: orca stack diff my-stack -t template.yaml orca stack diff my-stack -t updated-template.yaml
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--template, -t |
path | Local template file to compare against. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca stack environment¶
Inspect a stack's resolved environment.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca stack environment show¶
Show the resolved environment of a stack.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca stack event¶
Inspect stack events.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca stack event list¶
List stack events.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--resource |
text | Filter by resource name. | None |
--limit |
integer | Limit number of events. | 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 stack event show¶
Show event details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 stack event-list¶
List stack events.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--resource |
text | Filter by resource name. | None |
--limit |
integer | Limit number of events. | 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 stack event-show¶
Show event details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 stack export¶
Export the full serialised state of a stack.
Heat GET /v1/stacks/{name}/{id}/export returns the same body
as abandon would, without actually removing the stack.
Useful as a backup or for stack adopt later.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 stack failures¶
Inspect failed events on a stack.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca stack failures list¶
List events on a stack whose resource_status is FAILED.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca stack file¶
Inspect files referenced by a stack template.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca stack file list¶
List local files referenced by a stack template.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca stack hook¶
Manage pre-create / pre-update hooks on stack resources.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca stack hook clear¶
Clear a hook so the paused resource can proceed.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--hook |
choice (pre-create | pre-update | pre-delete) |
Hook to clear on the resource. | pre-create |
--help |
boolean | Show this message and exit. | False |
orca stack hook poll¶
List resources whose hooks are still pending on a stack.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 stack list¶
List stacks.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 stack output¶
Inspect stack outputs.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca stack output list¶
List stack outputs.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 stack output show¶
Show a specific stack output value.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 stack output-list¶
List stack outputs.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 stack output-show¶
Show a specific stack output value.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 stack resource¶
Per-resource actions and inspection on a stack.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca stack resource list¶
List resources in a stack.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 stack resource mark-unhealthy¶
Mark a stack resource as unhealthy (forces re-create on update).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--reason |
text | Status reason. | None |
--help |
boolean | Show this message and exit. | False |
orca stack resource metadata¶
Show the metadata of a stack resource.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca stack resource show¶
Show resource details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 stack resource signal¶
Send a signal to a stack resource (e.g. WaitCondition).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--data |
text | JSON body to send as the signal payload. | None |
--help |
boolean | Show this message and exit. | False |
orca stack resource-list¶
List resources in a stack.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 stack resource-show¶
Show resource details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 stack resource-type¶
Inspect Heat resource types (compound noun).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca stack resource-type list¶
List available Heat resource types.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--filter |
text | Filter resource types by name substring. | 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 stack resource-type show¶
Show the schema for a Heat resource type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--template-type |
choice (cfn | hot) |
Template format for the resource schema. | hot |
--help |
boolean | Show this message and exit. | False |
orca stack resource-type-list¶
List available Heat resource types.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--filter |
text | Filter resource types by name substring. | 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 stack resource-type-show¶
Show the schema for a Heat resource type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--template-type |
choice (cfn | hot) |
Template format for the resource schema. | hot |
--help |
boolean | Show this message and exit. | False |
orca stack resume¶
Resume a suspended stack.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca stack show¶
Show stack details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 stack snapshot¶
Manage stack snapshots (Heat snapshot/restore).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca stack snapshot create¶
Take a snapshot of a stack's current state.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Snapshot name (auto if omitted). | None |
--help |
boolean | Show this message and exit. | False |
orca stack snapshot delete¶
Delete a stack snapshot.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca stack snapshot list¶
List snapshots of a stack.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 stack snapshot restore¶
Restore a stack to a previous snapshot.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca stack snapshot show¶
Show a stack snapshot.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 stack suspend¶
Suspend a stack.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca stack template¶
Inspect or validate Heat templates.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca stack template show¶
Show the stack template (YAML output).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca stack template validate¶
Validate a Heat template.
Examples: orca stack template-validate -t template.yaml orca stack template-validate -t template.yaml -e env.yaml
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--template, -t |
text | Template file path or URL. | Sentinel.UNSET |
--environment, -e |
text | Environment file path. | None |
--parameter |
text | Parameter key=value (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca stack template-show¶
Show the stack template (YAML output).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca stack template-validate¶
Validate a Heat template.
Examples: orca stack template-validate -t template.yaml orca stack template-validate -t template.yaml -e env.yaml
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--template, -t |
text | Template file path or URL. | Sentinel.UNSET |
--environment, -e |
text | Environment file path. | None |
--parameter |
text | Parameter key=value (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca stack topology¶
Show stack resource topology as a tree.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca stack update¶
Update a stack.
Examples: orca stack update my-stack -t template.yaml orca stack update my-stack -t template.yaml -e env.yaml --parameter key1=val1 --wait
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--template, -t |
text | Template file path or URL. | Sentinel.UNSET |
--environment, -e |
text | Environment file path. | None |
--parameter |
text | Parameter key=value (repeatable). | Sentinel.UNSET |
--timeout |
integer | Timeout in minutes. | None |
--wait |
boolean | Wait for stack to reach terminal state. | False |
--help |
boolean | Show this message and exit. | False |
orca subnet¶
Manage Neutron subnets (alias of orca network subnet).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca subnet create¶
Create a subnet.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--network-id |
text | Parent network ID. | Sentinel.UNSET |
--cidr |
text | CIDR (e.g. 10.0.0.0/24). | Sentinel.UNSET |
--ip-version |
choice (4 | 6) |
N/A | 4 |
--gateway |
text | Gateway IP. Auto if omitted. | None |
--dhcp / --no-dhcp |
boolean | Enable DHCP. | True |
--dns |
text | DNS nameserver (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca subnet delete¶
Delete a subnet.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca subnet inspect¶
Full inspection of a subnet — fields + IP usage + attached ports + servers.
Cross-references three Neutron endpoints so you don't have to run
subnet show + port list + ip-availability show by hand:
GET /subnets/{id}— the subnet fieldsGET /network-ip-availabilities/{network_id}— IP usage per subnetGET /ports?fixed_ips=subnet_id=<id>— who actually uses each IP
For each port, follow device_id when device_owner is
compute:* to surface the server name (single Nova servers/{id}
GET per attached VM).
Example:
orca network subnet inspect
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca subnet list¶
List subnets.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 subnet show¶
Show subnet details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 subnet update¶
Update a subnet.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--dns-nameserver |
text | DNS nameserver IP (repeatable, replaces existing list). | Sentinel.UNSET |
--enable-dhcp / --disable-dhcp |
boolean | Enable or disable DHCP. | None |
--help |
boolean | Show this message and exit. | False |
orca subnet update¶
Update a subnet.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--dns-nameserver |
text | DNS nameserver IP (repeatable, replaces existing list). | Sentinel.UNSET |
--enable-dhcp / --disable-dhcp |
boolean | Enable or disable DHCP. | None |
--help |
boolean | Show this message and exit. | False |
orca subnet update¶
Update a subnet.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--dns-nameserver |
text | DNS nameserver IP (repeatable, replaces existing list). | Sentinel.UNSET |
--enable-dhcp / --disable-dhcp |
boolean | Enable or disable DHCP. | None |
--help |
boolean | Show this message and exit. | False |
orca subnet-pool¶
Manage Neutron subnet pools for automatic IP allocation.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca subnet-pool create¶
Create a subnet pool.
Example: orca subnet-pool create \ --name my-pool \ --pool-prefix 10.0.0.0/8 \ --default-prefix-length 24
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Pool name. | Sentinel.UNSET |
--pool-prefix |
text | CIDR prefix for the pool (repeatable). | Sentinel.UNSET |
--default-prefix-length |
integer | Default prefix length for subnets from this pool. | None |
--min-prefix-length |
integer | Minimum prefix length. | None |
--max-prefix-length |
integer | Maximum prefix length. | None |
--shared |
boolean | Make the pool shared. | False |
--default |
boolean | Set as the default pool. | False |
--description |
text | Description. | None |
--help |
boolean | Show this message and exit. | False |
orca subnet-pool delete¶
Delete a subnet pool.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca subnet-pool list¶
List subnet pools.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--shared |
boolean | Show only shared pools. | False |
--default |
boolean | Show only the default pool. | False |
--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 subnet-pool set¶
Update a subnet pool.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--default-prefix-length |
integer | New default prefix length. | None |
--pool-prefix |
text | Add a prefix to the pool (repeatable). | Sentinel.UNSET |
--default / --no-default |
boolean | Set or unset as the default pool. | None |
--help |
boolean | Show this message and exit. | False |
orca subnet-pool show¶
Show subnet pool details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 subnet-pool unset¶
Remove address prefixes from a subnet pool.
Neutron has no atomic "remove prefix" endpoint — we fetch the current list, subtract, and PUT the result back. Other concurrent writes lose; race-tolerant patterns should rebuild the pool.
Example:
orca subnet-pool unset
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--prefix |
text | CIDR prefix to drop from the pool (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca tld¶
Manage Designate Top-Level Domains (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca tld create¶
Create a TLD (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | Description. | None |
--help |
boolean | Show this message and exit. | False |
orca tld delete¶
Delete a TLD (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca tld list¶
List allowed TLDs (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 tld set¶
Update a Designate TLD.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New TLD name (e.g. com). |
None |
--description |
text | Update the description. | None |
--help |
boolean | Show this message and exit. | False |
orca tld show¶
Show a Designate TLD.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 token¶
Manage Keystone tokens.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca token issue¶
Issue a token for the current credentials (show token details).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 token revoke¶
Revoke a token.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca trait¶
Placement traits — OSC parity.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca trait create¶
Create a custom trait (must start with CUSTOM_).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca trait delete¶
Delete a custom trait.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca trait list¶
List traits.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Filter traits by name prefix. | None |
--associated |
boolean | Only traits associated with a resource provider. | False |
--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 trait show¶
Show a trait (existence check — Placement traits have no body).
Equivalent to openstack trait show. Raises OrcaCLIError
if the trait does not exist.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca trunk¶
Manage Neutron trunks (VLAN trunk ports).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca trunk add-subport¶
Add a sub-port to a trunk.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--port |
text | Sub-port port ID. | Sentinel.UNSET |
--segmentation-type |
choice (vlan | inherit) |
Segmentation type. | vlan |
--segmentation-id |
integer | VLAN ID (1–4094). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca trunk create¶
Create a trunk.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--port |
text | Parent port ID (the trunk port). | Sentinel.UNSET |
--name |
text | Trunk name. | None |
--description |
text | Description. | None |
--disable |
boolean | Create trunk in administratively down state. | False |
--help |
boolean | Show this message and exit. | False |
orca trunk delete¶
Delete a trunk.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca trunk list¶
List trunks.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 trunk remove-subport¶
Remove a sub-port from a trunk.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--port |
text | Sub-port port ID to remove. | Sentinel.UNSET |
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca trunk set¶
Update a trunk.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--enable / --disable |
boolean | Enable or disable the trunk. | None |
--help |
boolean | Show this message and exit. | False |
orca trunk show¶
Show trunk details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 trunk subport¶
Manage sub-ports on a trunk.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca trunk subport add¶
Add a sub-port to a trunk.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--port |
text | Sub-port port ID. | Sentinel.UNSET |
--segmentation-type |
choice (vlan | inherit) |
Segmentation type. | vlan |
--segmentation-id |
integer | VLAN ID (1–4094). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca trunk subport list¶
List sub-ports on a trunk.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 trunk subport remove¶
Remove a sub-port from a trunk.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--port |
text | Sub-port port ID to remove. | Sentinel.UNSET |
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca trunk subport-list¶
List sub-ports on a trunk.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 trunk unset¶
Clear optional fields on a trunk (description, …).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
boolean | Clear the description. | False |
--help |
boolean | Show this message and exit. | False |
orca trust¶
Manage Keystone trusts (token delegation).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca trust create¶
Create a trust (delegation from trustor to trustee).
Example:
orca trust create \
--trustor
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--trustor |
text | Trustor user ID (delegating identity). | Sentinel.UNSET |
--trustee |
text | Trustee user ID (receiving delegation). | Sentinel.UNSET |
--project |
text | Project ID for the trust scope. | None |
--role |
text | Role name to delegate (repeatable). | Sentinel.UNSET |
--impersonate / --no-impersonate |
boolean | Allow trustee to impersonate trustor. | False |
--expires-at |
text | Expiry datetime in ISO 8601 (e.g. 2026-12-31T23:59:59Z). | None |
--uses |
integer | Maximum number of times the trust can be used. | None |
--help |
boolean | Show this message and exit. | False |
orca trust delete¶
Delete a trust.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca trust list¶
List trusts.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--trustor |
text | Filter by trustor user ID. | None |
--trustee |
text | Filter by trustee user ID. | 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 trust show¶
Show trust details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 tsigkey¶
Manage Designate TSIG keys (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca tsigkey create¶
Create a TSIG key.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | TSIG key name. | Sentinel.UNSET |
--algorithm |
choice (hmac-md5 | hmac-sha1 | hmac-sha224 | hmac-sha256 | hmac-sha384 | hmac-sha512) |
N/A | Sentinel.UNSET |
--secret |
text | Base64 shared secret. | Sentinel.UNSET |
--scope |
choice (POOL | ZONE) |
Scope of the key. | POOL |
--resource-id |
text | UUID of the pool (scope=POOL) or zone (scope=ZONE). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca tsigkey delete¶
Delete a TSIG key.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
-y, --yes |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca tsigkey list¶
List TSIG keys.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 tsigkey set¶
Update a TSIG key.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | N/A | None |
--algorithm |
choice (hmac-md5 | hmac-sha1 | hmac-sha224 | hmac-sha256 | hmac-sha384 | hmac-sha512) |
N/A | None |
--secret |
text | N/A | None |
--scope |
choice (POOL | ZONE) |
N/A | None |
--resource-id |
text | N/A | None |
--help |
boolean | Show this message and exit. | False |
orca tsigkey show¶
Show a TSIG key.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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¶
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 |
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 |
orca user¶
Manage users (Keystone v3).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca user create¶
Create a user.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--password |
text | User password. | Sentinel.UNSET |
--email |
text | Email address. | None |
--description |
text | Description. | None |
--domain |
text | Domain ID. | None |
--project |
text | Default project ID. | None |
--enable / --disable |
boolean | Enable or disable the user. | True |
--help |
boolean | Show this message and exit. | False |
orca user delete¶
Delete a user.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca user list¶
List users.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--domain |
text | Filter by domain name or ID. | None |
--project |
text | Filter by project ID. | None |
--enabled / --disabled |
boolean | Filter by enabled state. | 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 user password¶
Manage a user's password (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca user password set¶
Set a user's password (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--password |
text | New password. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca user set¶
Update a user.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--email |
text | New email. | None |
--description |
text | New description. | None |
--password |
text | New password. | None |
--enable / --disable |
boolean | Enable or disable. | None |
--help |
boolean | Show this message and exit. | False |
orca user set-password¶
Set a user's password (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--password |
text | New password. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca user show¶
Show user details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 versions¶
List API versions advertised by Keystone.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca versions show¶
List Keystone API versions and their state (stable / deprecated).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume¶
Manage block storage volumes & snapshots.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume attachment¶
Manage volume attachments (low-level).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume attachment complete¶
Mark a volume attachment as complete (os-complete action).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume attachment create¶
Create a volume attachment (Cinder v3 attachment API).
Examples:
orca volume attachment-create
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--mode |
choice (rw | ro) |
Attach mode: read-write or read-only. | rw |
--connector |
text | Connector info as JSON (host, initiator, etc.). | 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 volume attachment delete¶
Delete a volume attachment.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca volume attachment list¶
List volume attachments (Cinder v3 attachment API).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--volume-id |
text | Filter by volume ID. | 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 volume attachment set¶
Update (finalize) a volume attachment with connector info.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--connector |
text | Updated connector info as JSON. | Sentinel.UNSET |
--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 volume attachment show¶
Show a volume attachment.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume attachment-complete¶
Mark a volume attachment as complete (os-complete action).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume attachment-create¶
Create a volume attachment (Cinder v3 attachment API).
Examples:
orca volume attachment-create
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--mode |
choice (rw | ro) |
Attach mode: read-write or read-only. | rw |
--connector |
text | Connector info as JSON (host, initiator, etc.). | 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 volume attachment-delete¶
Delete a volume attachment.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca volume attachment-list¶
List volume attachments (Cinder v3 attachment API).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--volume-id |
text | Filter by volume ID. | 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 volume attachment-set¶
Update (finalize) a volume attachment with connector info.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--connector |
text | Updated connector info as JSON. | Sentinel.UNSET |
--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 volume attachment-show¶
Show a volume attachment.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume backend¶
Inspect Cinder backend driver capabilities (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume backend capability¶
Backend capabilities — OSC volume backend capability show.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume backend capability capability¶
Show the capabilities advertised by a backend driver.
Useful for debugging scheduler decisions or onboarding a new backend. Returns the raw driver capabilities dict.
Example: orca volume backend capability cinder@lvm
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume backend pool¶
Cinder scheduler pools, surfaced under volume backend.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume backend pool list¶
List Cinder scheduler backend pools.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--detail |
boolean | Include detailed capabilities per pool. | False |
--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 volume backup¶
Manage Cinder backups.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume backup create¶
Create a Cinder backup of a volume.
Examples:
orca volume backup-create
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Backup name. | None |
--description |
text | Backup description. | None |
--container |
text | Swift container for the backup. | None |
--incremental |
boolean | Create an incremental backup. | False |
--force |
boolean | Backup even if the volume is attached (may create inconsistent backup). | False |
--snapshot-id |
text | Create backup from a specific snapshot instead of the volume. | None |
--wait |
boolean | Wait until the backup reaches 'available' status. | False |
--help |
boolean | Show this message and exit. | False |
orca volume backup delete¶
Delete a volume backup.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--force |
boolean | Force deletion even if backup is not available. | False |
--help |
boolean | Show this message and exit. | False |
orca volume backup list¶
List Cinder volume backups.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--all-projects |
boolean | List backups from all projects (admin). | False |
--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 volume backup record¶
Export / import backup records for cross-cloud migration (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume backup record export¶
Export a backup record (admin) — JSON dump usable to re-import.
The record contains the metadata needed to recreate the backup
entry on another Cinder deployment via volume backup record
import (the actual backup data must already live in shared
storage like Swift / Ceph).
Examples:
orca volume backup record export
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--output, -o |
text | Write the record to a file (JSON) instead of stdout. | None |
--help |
boolean | Show this message and exit. | False |
orca volume backup record import¶
Recreate a backup entry from a previously exported record (admin).
Two ways to feed the record: either pass --backup-service /
--backup-url directly, or point --file at the JSON file produced
by volume backup record export.
Examples:
orca volume backup record import -f /tmp/rec.json
orca volume backup record import --backup-service swift --backup-url
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--backup-service |
text | Backup service identifier from the exported record (e.g. cinder.backup.drivers.swift.SwiftBackupDriver). |
Sentinel.UNSET |
--backup-url |
text | The base64 backup_url from the exported record. Mutually exclusive with --file. |
None |
--file, -f |
path | Path to a JSON file produced by volume backup record export — reads backup_service and backup_url from it (overrides --backup-service / --backup-url). |
None |
--help |
boolean | Show this message and exit. | False |
orca volume backup restore¶
Restore a Cinder backup to a volume.
If --volume-id is not specified, a new volume is created.
Examples:
orca volume backup-restore
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--volume-id |
text | Restore to an existing volume ID (must be same size). | None |
--name |
text | Name for the new restored volume. | None |
--wait |
boolean | Wait until the restored volume is available. | False |
--help |
boolean | Show this message and exit. | False |
orca volume backup set¶
Update a backup's name, description, or metadata.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--property |
text | Metadata key=value (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume backup show¶
Show details of a volume backup.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume backup unset¶
Remove metadata keys from a backup.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--property |
text | Metadata key to remove (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume backup-create¶
Create a Cinder backup of a volume.
Examples:
orca volume backup-create
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Backup name. | None |
--description |
text | Backup description. | None |
--container |
text | Swift container for the backup. | None |
--incremental |
boolean | Create an incremental backup. | False |
--force |
boolean | Backup even if the volume is attached (may create inconsistent backup). | False |
--snapshot-id |
text | Create backup from a specific snapshot instead of the volume. | None |
--wait |
boolean | Wait until the backup reaches 'available' status. | False |
--help |
boolean | Show this message and exit. | False |
orca volume backup-delete¶
Delete a volume backup.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--force |
boolean | Force deletion even if backup is not available. | False |
--help |
boolean | Show this message and exit. | False |
orca volume backup-list¶
List Cinder volume backups.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--all-projects |
boolean | List backups from all projects (admin). | False |
--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 volume backup-restore¶
Restore a Cinder backup to a volume.
If --volume-id is not specified, a new volume is created.
Examples:
orca volume backup-restore
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--volume-id |
text | Restore to an existing volume ID (must be same size). | None |
--name |
text | Name for the new restored volume. | None |
--wait |
boolean | Wait until the restored volume is available. | False |
--help |
boolean | Show this message and exit. | False |
orca volume backup-show¶
Show details of a volume backup.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume cluster¶
Manage Cinder active/active clusters (admin).
Maps to OSC openstack block storage cluster ….
Requires Cinder micro-version >= 3.7 on the cloud.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume cluster list¶
List Cinder clusters.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Filter by cluster name. | Sentinel.UNSET |
--binary |
text | Filter by service binary (e.g. cinder-volume). | Sentinel.UNSET |
--detail |
boolean | Include extended fields. | False |
--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 volume cluster set¶
Enable/disable a cluster or set a disable-reason.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--binary |
text | Service binary (required if ambiguous). | Sentinel.UNSET |
--disable |
boolean | Disable the cluster. | None |
--enable |
boolean | Enable the cluster. | None |
--disable-reason |
text | Reason recorded when disabling. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume cluster show¶
Show one Cinder cluster.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--binary |
text | Disambiguate when several binaries share a cluster name. | Sentinel.UNSET |
--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 volume create¶
Create a volume.
Interactive wizard: orca volume create -i
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Volume name. | None |
--size |
integer | Size in GB. | None |
--type |
text | Volume type. | None |
--description |
text | Volume description. | None |
--snapshot-id |
text | Create from snapshot. | None |
--source-vol |
text | Create from existing volume (clone). | None |
--image-id |
text | Create from image. | None |
--wait |
boolean | Wait until the volume reaches 'available' status. | False |
--interactive, -i |
boolean | Step-by-step wizard — choose name, size, and type interactively. | False |
--help |
boolean | Show this message and exit. | False |
orca volume delete¶
Delete a volume.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--dry-run |
boolean | Show what would be deleted without deleting. | False |
--wait |
boolean | Wait until the volume is fully deleted. | False |
--help |
boolean | Show this message and exit. | False |
orca volume extend¶
Extend a volume to a larger size.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--size |
integer | New size in GB (must be larger). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume group¶
Manage consistency / generic volume groups.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume group create¶
Create a volume group.
Example:
orca volume group-create my-group \
--group-type
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--group-type |
text | Group type ID. | Sentinel.UNSET |
--volume-type |
text | Volume type ID (repeatable). | Sentinel.UNSET |
--description |
text | Description. | None |
--availability-zone |
text | Availability zone. | None |
--help |
boolean | Show this message and exit. | False |
orca volume group delete¶
Delete a volume group.
Example:
orca volume group-delete
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--delete-volumes |
boolean | Also delete all volumes in the group. | False |
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca volume group failover¶
Fail a replicated group over to its secondary backend (admin).
Triggers Cinder's failover_replication group action. The group
must have replication_status == enabled on a replication-
capable driver.
Examples:
orca volume group failover
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--secondary-backend-id |
text | Target replication backend ID. Omit to use the configured default. | None |
--allow-attached-volume |
boolean | Permit failover even if the group has attached volumes (dangerous on async replication — data loss risk). | False |
--help |
boolean | Show this message and exit. | False |
orca volume group list¶
List volume groups.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume group set¶
Update a volume group (OSC-parity alias for group update).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--add-volume |
text | Volume ID to add to the group (repeatable). | Sentinel.UNSET |
--remove-volume |
text | Volume ID to remove from the group (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume group show¶
Show a volume group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume group snapshot¶
Group snapshots — atomic snapshots across a group of volumes.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume group snapshot create¶
Create a snapshot of a volume group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Snapshot name. | None |
--description |
text | Snapshot description. | None |
--help |
boolean | Show this message and exit. | False |
orca volume group snapshot delete¶
Delete a volume group snapshot.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca volume group snapshot list¶
List volume group snapshots.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume group snapshot show¶
Show a volume group snapshot.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume group type¶
Group types.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume group type create¶
Create a volume group type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | Group type description. | None |
--public / --private |
boolean | Public or private group type. | True |
--help |
boolean | Show this message and exit. | False |
orca volume group type delete¶
Delete a volume group type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca volume group type list¶
List volume group types.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume group type set¶
Update a volume group type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--public / --private |
boolean | Change visibility. | None |
--property |
text | Group spec key=value (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume group type show¶
Show a volume group type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume group type unset¶
Unset group spec properties on a group type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--property |
text | Group spec key to remove (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume group update¶
Update a volume group — rename or add/remove volumes.
Examples:
orca volume group-update
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--add-volume |
text | Volume ID to add to the group (repeatable). | Sentinel.UNSET |
--remove-volume |
text | Volume ID to remove from the group (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume group-create¶
Create a volume group.
Example:
orca volume group-create my-group \
--group-type
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--group-type |
text | Group type ID. | Sentinel.UNSET |
--volume-type |
text | Volume type ID (repeatable). | Sentinel.UNSET |
--description |
text | Description. | None |
--availability-zone |
text | Availability zone. | None |
--help |
boolean | Show this message and exit. | False |
orca volume group-delete¶
Delete a volume group.
Example:
orca volume group-delete
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--delete-volumes |
boolean | Also delete all volumes in the group. | False |
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca volume group-list¶
List volume groups.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume group-show¶
Show a volume group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume group-snapshot-create¶
Create a snapshot of a volume group.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Snapshot name. | None |
--description |
text | Snapshot description. | None |
--help |
boolean | Show this message and exit. | False |
orca volume group-snapshot-delete¶
Delete a volume group snapshot.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca volume group-snapshot-list¶
List volume group snapshots.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume group-snapshot-show¶
Show a volume group snapshot.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume group-type-create¶
Create a volume group type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | Group type description. | None |
--public / --private |
boolean | Public or private group type. | True |
--help |
boolean | Show this message and exit. | False |
orca volume group-type-delete¶
Delete a volume group type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca volume group-type-list¶
List volume group types.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume group-type-set¶
Update a volume group type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--public / --private |
boolean | Change visibility. | None |
--property |
text | Group spec key=value (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume group-type-show¶
Show a volume group type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume group-type-unset¶
Unset group spec properties on a group type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--property |
text | Group spec key to remove (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume group-update¶
Update a volume group — rename or add/remove volumes.
Examples:
orca volume group-update
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--add-volume |
text | Volume ID to add to the group (repeatable). | Sentinel.UNSET |
--remove-volume |
text | Volume ID to remove from the group (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume host¶
Inspect Cinder hosts (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume host list¶
List Cinder hosts.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--zone |
text | Filter by availability zone. | 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 volume host set¶
Enable / disable / freeze a Cinder host (admin).
OSC parity with openstack volume host set. Acts on the
cinder-volume service hosted by HOST.
Examples: orca volume host set cinder@lvm#LVM --disable --disabled-reason "maintenance" orca volume host set cinder@lvm#LVM --enable orca volume host set cinder@lvm#LVM --freeze orca volume host set cinder@lvm#LVM --thaw
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--enable |
text | Enable the host's volume service. | Sentinel.UNSET |
--disable |
text | Disable the host's volume service. | Sentinel.UNSET |
--disabled-reason |
text | Reason for disabling (sets disable-log-reason). | None |
--freeze |
text | Freeze the host (block new attaches, allow existing ones). | Sentinel.UNSET |
--thaw |
text | Thaw a previously frozen host. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume list¶
List volumes.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume log-level¶
Inspect or change live log levels of Cinder services (admin).
Maps to OSC openstack block storage log level ….
Requires Cinder micro-version >= 3.32.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume log-level list¶
List current log levels per service / logger.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--binary |
text | Filter by service binary (cinder-api, cinder-volume, …). | Sentinel.UNSET |
--server |
text | Filter by host. | Sentinel.UNSET |
--prefix |
text | Filter by logger prefix. | Sentinel.UNSET |
--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 volume log-level set¶
Change the runtime log level of a Cinder service.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--binary |
text | Restrict to one service binary. | Sentinel.UNSET |
--server |
text | Restrict to one host. | Sentinel.UNSET |
--prefix |
text | Restrict to one logger prefix. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume manageable¶
Discover Cinder-manageable existing backend resources (admin).
Maps to OSC openstack block storage volume manageable list.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume manageable list¶
List volumes on the backend that are not (yet) managed by Cinder.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--host |
text | Filter by Cinder host (required on most backends). | Sentinel.UNSET |
--cluster |
text | Filter by cluster name. | Sentinel.UNSET |
--detail |
boolean | Include extra backend fields. | False |
--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 volume message¶
User-facing Cinder messages (failures, info).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume message delete¶
Delete a Cinder error message.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca volume message list¶
List Cinder error messages.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--resource-id |
text | Filter by resource UUID. | None |
--resource-type |
choice (VOLUME | SNAPSHOT | BACKUP | GROUP) |
Filter by resource type. | 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 volume message show¶
Show a Cinder error message.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume message-delete¶
Delete a Cinder error message.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca volume message-list¶
List Cinder error messages.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--resource-id |
text | Filter by resource UUID. | None |
--resource-type |
choice (VOLUME | SNAPSHOT | BACKUP | GROUP) |
Filter by resource type. | 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 volume message-show¶
Show a Cinder error message.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume migrate¶
Migrate a volume to a different Cinder host/backend.
Example:
orca volume migrate
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--host |
text | Destination host (e.g. cinder@lvm#LVM). | Sentinel.UNSET |
--force-host-copy |
boolean | Bypass the driver, force host-level copy. | False |
--lock-volume |
boolean | Lock the volume during migration. | False |
--help |
boolean | Show this message and exit. | False |
orca volume pool¶
Inspect Cinder scheduler backend pools (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume pool list¶
List Cinder scheduler backend pools.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--detail |
boolean | Include detailed capabilities per pool. | False |
--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 volume qos¶
QoS specifications.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume qos associate¶
Associate a QoS spec with a volume type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume qos create¶
Create a volume QoS spec.
Example: orca volume qos-create my-qos --consumer back-end \ --property total_iops_sec=1000
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--consumer |
choice (front-end | back-end | both) |
Consumer of the QoS. | both |
--property |
text | QoS spec key=value (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume qos delete¶
Delete a volume QoS spec.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--force |
boolean | Delete even if associated with a volume type. | False |
--help |
boolean | Show this message and exit. | False |
orca volume qos disassociate¶
Disassociate a QoS spec from a volume type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--all |
boolean | Disassociate from all volume types. | False |
--help |
boolean | Show this message and exit. | False |
orca volume qos list¶
List volume QoS specs.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume qos set¶
Add or update keys on a volume QoS spec.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--property |
text | QoS spec key=value to add or update (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume qos show¶
Show volume QoS spec details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume qos unset¶
Remove keys from a volume QoS spec.
Example:
orca volume qos unset
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--property |
text | QoS spec key to remove (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume qos-associate¶
Associate a QoS spec with a volume type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume qos-create¶
Create a volume QoS spec.
Example: orca volume qos-create my-qos --consumer back-end \ --property total_iops_sec=1000
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--consumer |
choice (front-end | back-end | both) |
Consumer of the QoS. | both |
--property |
text | QoS spec key=value (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume qos-delete¶
Delete a volume QoS spec.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--force |
boolean | Delete even if associated with a volume type. | False |
--help |
boolean | Show this message and exit. | False |
orca volume qos-disassociate¶
Disassociate a QoS spec from a volume type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--all |
boolean | Disassociate from all volume types. | False |
--help |
boolean | Show this message and exit. | False |
orca volume qos-list¶
List volume QoS specs.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume qos-set¶
Add or update keys on a volume QoS spec.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--property |
text | QoS spec key=value to add or update (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume qos-show¶
Show volume QoS spec details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume resource-filter¶
List/show server-side filters available for Cinder list APIs (admin).
Maps to OSC openstack block storage resource filter ….
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume resource-filter list¶
List all resource types that support server-side filters.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume resource-filter show¶
Show filters available for one resource type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume retype¶
Change volume type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--type |
text | New volume type. | Sentinel.UNSET |
--migration-policy |
choice (never | on-demand) |
Migration policy. | never |
--help |
boolean | Show this message and exit. | False |
orca volume revert¶
Revert a volume to a previous snapshot (OSC-parity alias).
Equivalent to orca volume snapshot revert <volume-id> <snapshot-id>;
exposed at the top level for parity with openstack volume revert.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume revert-to-snapshot¶
Revert a volume to a previous snapshot.
The volume must be in 'available' status and the snapshot must be the most recent one for this volume.
Example:
orca volume snapshot revert
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume service¶
Cinder backend services (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume service list¶
List Cinder services.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--host |
text | Filter by host. | None |
--binary |
text | Filter by binary (e.g. cinder-volume). | 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 volume service set¶
Enable or disable a Cinder service.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--enable |
text | Enable the service. | Sentinel.UNSET |
--disable |
text | Disable the service. | Sentinel.UNSET |
--disabled-reason |
text | Reason for disabling. | None |
--help |
boolean | Show this message and exit. | False |
orca volume service-list¶
List Cinder services.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--host |
text | Filter by host. | None |
--binary |
text | Filter by binary (e.g. cinder-volume). | 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 volume service-set¶
Enable or disable a Cinder service.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--enable |
text | Enable the service. | Sentinel.UNSET |
--disable |
text | Disable the service. | Sentinel.UNSET |
--disabled-reason |
text | Reason for disabling. | None |
--help |
boolean | Show this message and exit. | False |
orca volume set¶
Set volume properties, metadata, or flags.
Examples:
orca volume set
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--property |
text | Metadata key=value pair (repeatable). | Sentinel.UNSET |
--name |
text | New name. | None |
--description |
text | New description. | None |
--bootable / --no-bootable |
boolean | Mark volume as bootable or non-bootable. | None |
--read-only / --no-read-only |
boolean | Mark volume as read-only or read-write. | None |
--help |
boolean | Show this message and exit. | False |
orca volume set-bootable¶
Set bootable flag (deprecated — use 'volume set --bootable').
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--bootable / --no-bootable |
boolean | Mark volume as bootable or non-bootable. | True |
--help |
boolean | Show this message and exit. | False |
orca volume set-readonly¶
Set read-only flag (deprecated — use 'volume set --read-only').
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--readonly / --no-readonly |
boolean | Mark volume as read-only or read-write. | True |
--help |
boolean | Show this message and exit. | False |
orca volume show¶
Show volume details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume snapshot¶
Manage volume snapshots.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume snapshot create¶
Create a snapshot of a volume (accepts UUID or name).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Snapshot name. | Sentinel.UNSET |
--description |
text | Snapshot description. | None |
--force |
boolean | Force snapshot of in-use volume. | False |
--help |
boolean | Show this message and exit. | False |
orca volume snapshot delete¶
Delete a volume snapshot.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca volume snapshot list¶
List volume snapshots.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume snapshot manageable¶
Discover Cinder-manageable existing snapshots on the backend.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume snapshot manageable list¶
List snapshots on the backend that are not (yet) managed by Cinder.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--host |
text | Filter by Cinder host. | Sentinel.UNSET |
--cluster |
text | Filter by cluster name. | Sentinel.UNSET |
--detail |
boolean | Include extra backend fields. | False |
--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 volume snapshot revert¶
Revert a volume to a previous snapshot.
The volume must be in 'available' status and the snapshot must be the most recent one for this volume.
Example:
orca volume snapshot revert
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume snapshot set¶
Update a snapshot's name, description, or metadata.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--property |
text | Metadata key=value (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume snapshot show¶
Show snapshot details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume snapshot unset¶
Remove metadata keys from a snapshot.
Example:
orca volume snapshot unset
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--property |
text | Metadata key to remove (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume snapshot-create¶
Create a snapshot of a volume (accepts UUID or name).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Snapshot name. | Sentinel.UNSET |
--description |
text | Snapshot description. | None |
--force |
boolean | Force snapshot of in-use volume. | False |
--help |
boolean | Show this message and exit. | False |
orca volume snapshot-delete¶
Delete a volume snapshot.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca volume snapshot-list¶
List volume snapshots.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume snapshot-set¶
Update a snapshot's name, description, or metadata.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--property |
text | Metadata key=value (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume snapshot-show¶
Show snapshot details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume summary¶
Show aggregated volume count and total size for the project.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume transfer¶
Volume transfers between projects.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume transfer accept¶
Accept a volume transfer request.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume transfer create¶
Create a volume transfer request.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Transfer name. | None |
--help |
boolean | Show this message and exit. | False |
orca volume transfer delete¶
Delete a volume transfer request.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca volume transfer list¶
List volume transfer requests.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--all-projects |
boolean | List transfers from all projects (admin). | False |
--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 volume transfer request¶
OSC parity alias — same callbacks as volume transfer.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume transfer request accept¶
Accept a volume transfer request.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume transfer request create¶
Create a volume transfer request.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Transfer name. | None |
--help |
boolean | Show this message and exit. | False |
orca volume transfer request delete¶
Delete a volume transfer request.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca volume transfer request list¶
List volume transfer requests.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--all-projects |
boolean | List transfers from all projects (admin). | False |
--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 volume transfer request show¶
Show a volume transfer request.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume transfer show¶
Show a volume transfer request.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume transfer-accept¶
Accept a volume transfer request.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume transfer-create¶
Create a volume transfer request.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | Transfer name. | None |
--help |
boolean | Show this message and exit. | False |
orca volume transfer-delete¶
Delete a volume transfer request.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca volume transfer-list¶
List volume transfer requests.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--all-projects |
boolean | List transfers from all projects (admin). | False |
--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 volume transfer-show¶
Show a volume transfer request.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume tree¶
Display a volume / snapshot dependency tree.
Shows every volume with its snapshots, child volumes (clones), and server attachments — making it easy to debug chains and see what depends on what.
Examples:
orca volume tree
orca volume tree --volume-id
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--volume-id |
text | Show only this volume and its snapshots. | None |
--help |
boolean | Show this message and exit. | False |
orca volume type¶
Volume types.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume type access¶
Project-level access to a volume type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume type access add¶
Grant a project access to a private volume type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume type access list¶
List projects that have access to a private volume type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume type access remove¶
Revoke a project's access to a private volume type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca volume type create¶
Create a volume type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | Description. | None |
--public / --private |
boolean | Make type public or private. | True |
--property |
text | Extra spec (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume type delete¶
Delete a volume type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca volume type list¶
List volume types.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--default |
boolean | Show the default type only. | False |
--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 volume type set¶
Update a volume type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--property |
text | Extra spec to add or update (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume type show¶
Show volume type details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume type unset¶
Remove extra-spec keys from a volume type.
Example: orca volume type unset gold --property bandwidth_limit --property iops_limit
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--property |
text | Extra spec key to remove (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume type-access-add¶
Grant a project access to a private volume type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca volume type-access-list¶
List projects that have access to a private volume type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume type-access-remove¶
Revoke a project's access to a private volume type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca volume type-create¶
Create a volume type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | Description. | None |
--public / --private |
boolean | Make type public or private. | True |
--property |
text | Extra spec (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume type-delete¶
Delete a volume type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca volume type-list¶
List volume types.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--default |
boolean | Show the default type only. | False |
--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 volume type-set¶
Update a volume type.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--property |
text | Extra spec to add or update (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume type-show¶
Show volume type details.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 volume unset¶
Unset volume metadata keys.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--property |
text | Metadata key to remove (repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca volume update¶
Update volume name or description.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New name. | None |
--description |
text | New description. | None |
--help |
boolean | Show this message and exit. | False |
orca volume upload-to-image¶
Materialize a volume's data as a downloadable Glance image.
Wraps Cinder's os-volume_upload_image action. The resulting image is
a self-contained binary (unlike a server snapshot of a boot-from-volume
instance, which is a 0-byte shell pointing at a Cinder snapshot) and can
therefore be downloaded with orca image download.
Examples:
orca volume upload-to-image
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--disk-format |
choice (raw | qcow2 | vmdk | vdi | vhd | vhdx | iso | aki | ari | ami) |
Disk format. | qcow2 |
--container-format |
choice (bare | ovf | ova | aki | ari | ami | docker) |
Container format. | bare |
--visibility |
choice (private | shared | community | public) |
Image visibility. Only sent to Cinder when explicit (older microversions reject the field); otherwise Glance applies its own default. | None |
--protected / --no-protected |
boolean | Mark the resulting image as protected (deletion-locked). Only sent to Cinder when explicit; otherwise omitted from the action body for older-microversion compatibility. | None |
--force |
boolean | Required when uploading from an in-use volume. | False |
--property |
text | Custom Glance property to set on the resulting image. Repeatable. Applied via JSON-Patch after the upload action. | Sentinel.UNSET |
--wait |
boolean | Poll the resulting image until it reaches 'active' (or 'killed'/'deleted', in which case exit non-zero). | False |
--help |
boolean | Show this message and exit. | False |
orca watch¶
Live dashboard — auto-refreshing project overview.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--interval, -i |
integer range (1 and above) |
Refresh interval in seconds. | 10 |
--help |
boolean | Show this message and exit. | False |
orca zone¶
Manage DNS zones (Designate).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca zone abandon¶
Drop a zone from Designate without notifying the backend (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca zone axfr¶
Trigger an AXFR transfer on a secondary zone.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca zone blacklist¶
Manage DNS zone blacklists (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca zone blacklist create¶
Add a blacklist rule (regex pattern matched against zone names).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | Blacklist description. | None |
--help |
boolean | Show this message and exit. | False |
orca zone blacklist delete¶
Delete a blacklist rule.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca zone blacklist list¶
List blacklist rules.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 zone blacklist set¶
Update a blacklist rule.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--pattern |
text | New pattern. | None |
--description |
text | New description. | None |
--help |
boolean | Show this message and exit. | False |
orca zone blacklist show¶
Show a blacklist rule.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca zone create¶
Create a DNS zone.
NAME must be a fully-qualified domain name ending with a dot, e.g.: orca zone create example.com. --email admin@example.com
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--email |
text | Zone administrator email. | Sentinel.UNSET |
--ttl |
integer | Default TTL in seconds. | None |
--description |
text | Zone description. | None |
--type |
choice (PRIMARY | SECONDARY) |
Zone type. | PRIMARY |
--masters |
text | Master servers (for SECONDARY zones, repeatable). | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca zone delete¶
Delete a DNS zone.
ZONE can be a zone ID or name.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca zone export¶
Manage zone export tasks (BIND-format).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca zone export create¶
Trigger a zone export and stream the resulting BIND file.
Examples: orca zone export create example.com. orca zone export create example.com. --file example.com.zone
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--file |
path | Write zone file to this path (default: stdout). | None |
--help |
boolean | Show this message and exit. | False |
orca zone export delete¶
Delete a recorded export task.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
-y, --yes |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca zone export list¶
List recorded zone export tasks (OSC parity).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 zone export show¶
Show a zone export task.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 zone export showfile¶
Fetch the BIND content produced by a completed zone export.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--file |
path | Write the BIND file to this path (default: stdout). | None |
--help |
boolean | Show this message and exit. | False |
orca zone import¶
Manage zone import tasks (BIND-format).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca zone import create¶
Import a zone from a BIND-format zone file.
Example: orca zone import create --file example.com.zone
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--file |
path | BIND-format zone file to import. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca zone import delete¶
Delete a recorded import task.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
-y, --yes |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca zone import list¶
List recorded zone import tasks (OSC parity).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 zone import show¶
Show a zone import task.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 zone list¶
List DNS zones.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 zone move¶
Move a zone to a different project (admin, OSC zone move).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--project |
text | Destination project ID for the zone. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca zone reverse-lookup¶
Find PTR records for an IP address.
Queries Designate reverse DNS for floating IPs and searches for matching in-addr.arpa / ip6.arpa zones.
Examples: orca zone reverse-lookup 192.0.2.1
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca zone set¶
Update a DNS zone.
ZONE can be a zone ID or name.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--email |
text | Zone administrator email. | None |
--ttl |
integer | Default TTL in seconds. | None |
--description |
text | Zone description. | None |
--help |
boolean | Show this message and exit. | False |
orca zone share¶
Share a zone with other projects.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca zone share create¶
Share a zone with a target project.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--target-project |
text | Project ID to share the zone with. | Sentinel.UNSET |
--help |
boolean | Show this message and exit. | False |
orca zone share delete¶
Revoke a zone share.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca zone share list¶
List share grants on a zone.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 zone share show¶
Show a single zone share.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca zone show¶
Show DNS zone details.
ZONE can be a zone ID or name.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 zone tld¶
Manage allowed TLDs (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca zone tld create¶
Create a TLD (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | Description. | None |
--help |
boolean | Show this message and exit. | False |
orca zone tld delete¶
Delete a TLD (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca zone tld list¶
List allowed TLDs (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 zone tld set¶
Update a Designate TLD.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--name |
text | New TLD name (e.g. com). |
None |
--description |
text | Update the description. | None |
--help |
boolean | Show this message and exit. | False |
orca zone tld show¶
Show a Designate TLD.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 zone tld-create¶
Create a TLD (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | Description. | None |
--help |
boolean | Show this message and exit. | False |
orca zone tld-delete¶
Delete a TLD (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca zone tld-list¶
List allowed TLDs (admin).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 zone transfer¶
Manage zone transfer requests and accepts.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca zone transfer accept¶
Manage zone transfer accepts (OSC parity).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca zone transfer accept list¶
List all zone-transfer accepts visible to the caller.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 zone transfer accept request¶
Submit an accept for a pending zone-transfer request.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca zone transfer accept show¶
Show a zone-transfer accept by ID.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 zone transfer request¶
Manage zone transfer requests (sender side).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca zone transfer request create¶
Create a zone transfer request.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--target-project-id |
text | Restrict transfer to a specific project ID. | None |
--description |
text | Description. | None |
--help |
boolean | Show this message and exit. | False |
orca zone transfer request delete¶
Delete a zone transfer request.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca zone transfer request list¶
List zone transfer requests.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 zone transfer request set¶
Update a zone-transfer request (OSC zone transfer request set).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--description |
text | N/A | None |
--target-project |
text | Restrict the request to this target project. | None |
--help |
boolean | Show this message and exit. | False |
orca zone transfer request show¶
Show a zone transfer request.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 zone transfer-accept¶
Manage zone transfer accepts (OSC parity).
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |
orca zone transfer-request-create¶
Create a zone transfer request.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--target-project-id |
text | Restrict transfer to a specific project ID. | None |
--description |
text | Description. | None |
--help |
boolean | Show this message and exit. | False |
orca zone transfer-request-delete¶
Delete a zone transfer request.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--yes, -y |
boolean | Skip confirmation. | False |
--help |
boolean | Show this message and exit. | False |
orca zone transfer-request-list¶
List zone transfer requests.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 zone transfer-request-show¶
Show a zone transfer request.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--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 zone tree¶
Show a zone as a Rich tree grouped by record type.
Displays SOA at the top, then NS, then A/AAAA/CNAME/MX/TXT and other types — each colour-coded for quick scanning.
ZONE can be a zone ID or name.
Usage:
Options:
| Name | Type | Description | Default |
|---|---|---|---|
--help |
boolean | Show this message and exit. | False |