Skip to main content

inv device list

Overview​

Lists devices in the ra-infrastructure inventory with filtering by site, zone, category, operational status, and usage status. Returns a Rich-formatted table with device name, type, zone, status, and IP address.

Usage​

inv device list [OPTIONS]

Options​

OptionDescriptionDefault
-s, --site SLUGFilter by site slugAll sites
-z, --zone SLUGFilter by zone slugAll zones
-c, --category SLUGFilter by category slugAll categories
--status STATUSFilter by operational statusAll
-u, --usage-status STATUSFilter by: active, stored, failed, retired, pendingAll
-l, --limit NMaximum results50

Prerequisites​

  • Repo: ra-infrastructure
  • Install: pip install -e ".[dev]" from cli/ directory
  • Database: PostgreSQL container running

Examples​

List all devices​

inv device list

List active devices at a specific site​

inv device list --site home --usage-status active

List network devices​

inv device list --category network --limit 100

Count devices by category​

inv device count --by category
  • inv device show SLUG -- show device details
  • inv device count -- count devices grouped by category, type, zone, status, or usage
  • inv device create -- add a new device to inventory