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

FlagTypeDefaultDescription
--availablebooleantrueShow only available/online resources (default: true, set --available=false to include offline)
--productstringProduct slug (required, from 'products list')
--typestringResource 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.

Global flags (--output, --debug, --host, …) apply to every command. See the command reference overview.

What's next?

All commands

Browse the full CLI reference.

Get started

Install the CLI and authenticate.

Last updated on