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
| Option | Description | Default |
|---|---|---|
-s, --site SLUG | Filter by site slug | All sites |
-z, --zone SLUG | Filter by zone slug | All zones |
-c, --category SLUG | Filter by category slug | All categories |
--status STATUS | Filter by operational status | All |
-u, --usage-status STATUS | Filter by: active, stored, failed, retired, pending | All |
-l, --limit N | Maximum results | 50 |
Prerequisites
- Repo: ra-infrastructure
- Install:
pip install -e ".[dev]"fromcli/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
Related Commands
inv device show SLUG-- show device detailsinv device count-- count devices grouped by category, type, zone, status, or usageinv device create-- add a new device to inventory