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