CLI
ops

ops

List and inspect operations.

Usage

onvera ops ls [--status <status>] [--type <type>] [--resource-id <id>]
onvera ops get <operation_id>

Subcommands

ops ls

List operations with optional filtering.

Flags:

  • --status <status> - Filter by status: queued, running, succeeded, failed, canceled
  • --type <type> - Filter by operation type (e.g., deployment.create)
  • --resource-id <id> - Filter by resource ID

ops get

Get detailed information about an operation.

Arguments:

  • <operation_id> - Operation ID

Examples

List all operations:

onvera ops ls

List running operations:

onvera ops ls --status running

List deployment creation operations:

onvera ops ls --type deployment.create

List operations for a specific deployment:

onvera ops ls --resource-id dep_550e8400-e29b-41d4-a716-446655440000

Get operation details:

onvera ops get op_660e8400-e29b-41d4-a716-446655440001

JSON output:

onvera ops ls --json
onvera ops get op_660e8400-e29b-41d4-a716-446655440001 --json

Output

List output:

ID                                    TYPE                STATUS      PHASE           RESOURCE                              REQUESTED
op_660e8400-e29b-41d4-a716-446655440001  deployment.create   succeeded   ready           deployment/dep_550e8400-e29b-41d4-a716-446655440000  2024-01-20T12:00:00Z
op_770e8400-e29b-41d4-a716-446655440002  deployment.destroy  running     tearing_down_infra  deployment/dep_660e8400-e29b-41d4-a716-446655440001  2024-01-20T13:00:00Z

Get output:

Operation:     op_660e8400-e29b-41d4-a716-446655440001
Type:          deployment.create
Status:        succeeded
Phase:         ready
Message:       Deployment ready
Resource:      deployment/dep_550e8400-e29b-41d4-a716-446655440000
Requested:     2024-01-20T12:00:00Z
Started:       2024-01-20T12:00:15Z
Ended:         2024-01-20T12:06:15Z

Common Failure Modes

Not authenticated

Error:

not authenticated. Run 'onvera auth login' first

Solution: Run onvera auth login to authenticate.

Operation not found

Error:

API error: Operation not found

Solution: Verify the operation ID is correct and that you have access to it.

Related Commands

  • inspect - Inspect a deployment or operation
  • deploy - Create a deployment (returns operation ID)
lsconfig