Skip to main content

List

expanso-cli node list

List nodes

Synopsis

List all nodes with optional filtering and pagination.

expanso-cli node list [flags]

Examples

  # List all nodes
expanso-cli node list

# List nodes with specific states
expanso-cli node list --state healthy --state degraded

# List nodes with labels
expanso-cli node list --label region=us-west --label env=prod

# Limit results with pagination
expanso-cli node list --limit 10

# Continue to next page with token
expanso-cli node list --limit 10 --next-token `<token-from-previous-response>`

# Sort results
expanso-cli node list --order-by name --order asc

Options

  -f, --format {table|json|yaml|csv}   Output format (default table)
-h, --help help for list
-L, --label strings Filter by labels (format: key=value)
-l, --limit int Maximum number of results to return (default 50)
--next-token string Continuation token for pagination
--no-header Hide table headers (table format only)
--no-style Disable colors and styling
--order string Order direction (asc, desc)
--order-by string Field to order by
--state node connection state Filter by node connection state
-w, --wide Show full values without truncation (table format only)

Options inherited from parent commands

      --auth-token string   API bearer authentication token
-e, --endpoint string API endpoint URL
-k, --insecure Skip TLS certificate verification
-p, --profile string Profile to use for configuration
--timeout string Request timeout duration
-v, --verbose Enable verbose logging

SEE ALSO

Auto generated by spf13/cobra on 19-Nov-2025