ktm resources list
List available resources (SIMs, web agents, smartphones) for a product
List available resources (SIMs, web agents, smartphones) for a product
Usage
ktm resources list [flags]
Examples
# List available resources for a product (default: --available=true)
ktm resources list --product acme~web-portal
# List only SIMs
ktm resources list --product acme~web-portal --type sim
# List only web agents (table format)
ktm resources list --product acme~web-portal --type web-agent -o table
# List all resources including offline
ktm resources list --product acme~web-portal --available=false
Flags
| Flag | Type | Default | Description |
|---|---|---|---|
--available | boolean | true | Show only available/online resources (default: true, set --available=false to include offline) |
--product | string | Product slug (required, from 'products list') | |
--type | string | Resource type filter: sim, web-agent, smartphone (omit for all) |
Details
List hardware and software resources available for test execution.
Resources are scoped to a product. Use --type to filter by resource type, or omit it to fetch all three types.
Resource types and their identifiers (used in campaign JSON): sim — SIM cards, identified by national_msisdn web-agent — Ethernet/web agents, identified by hostname smartphone — Smartphones, identified by uuid
These identifiers are used as values for owner-type variables and direct_owners when constructing campaign JSON via "ci build".
For test creation: these identifiers are used as the "owner" field in test actions. SIM national_msisdn → owner for SIM action types (USSD, SMS_GET, DATA_, CALL_, etc.) Web-agent hostname → owner for ETHERNET action types (ETH_HTTP_API, ETH_PING, etc.) Smartphone UUID → owner for SMARTPHONE action types
Smartphone installed apps are not part of this listing — use "ktm resources get <serial> --include-apps" to see the apps on one device.
SIM and smartphone status is an object with value and detail fields (e.g. "Available", "Disconnected (Sim not inserted)"). EthernetAgent status is a boolean. By default only available/online resources are shown; use --available=false to include offline resources.
Related
Global flags (--output, --debug, --host, …) apply to every command. See the command reference overview.
What's next?
Last updated on