opschain infrastructure list

packs:infrastructure

Lists infrastructure nodes code-ascending under a scope — the whole estate, or one project, environment or asset subtree rolled up (the node's own infrastructure plus every descendant's). Filters run server-side over the indexed hot columns; pages ride a keyset token. Deregistered nodes are hidden unless asked for. A row whose address is shared by another node in the same environment prints DUP_ADDR yes.

opschain infrastructure list --scope /projects/web --type host
PATH                                        TYPE  NAME     ADDRESS   FQDN             LIFECYCLE    DUP_ADDR
/projects/web/infrastructure/jump01         host  Jump 1   10.0.9.9  jump01.example   registered   no

-o, --output json|yaml emits the rows as a machine document.

Flags

Flag	Meaning
--scope <node-path>	Scope root (a project, environment or asset); the whole estate when omitted.
--type <type>	Keep one registry type: host, hypervisor, network_device or link.
--lifecycle-state <state>	Keep one lifecycle state: registered, deregistered, provisioned or destroyed.
--address <address>	Exact address match.
--fqdn <fqdn>	Exact FQDN match.
--code <code>	Exact code match.
--search <text>	Case-insensitive substring over code and name.
--include-deregistered	Include deregistered (soft-closed) rows.
--page-size <n>	Rows per page (server default 100, maximum 1000).
--page-token <token>	Resume from a previous page's token.
--all	Follow pagination and list every page.
--server <url>	Server base URL (default: the active context / OPSCHAIN_SERVER).
--auth-token <token>	Admin bearer token override (default: your opschain login session, then $OPSCHAIN_ADMIN_TOKEN, then the token stored by opschain admin login).
--filter <column>[!]=<value>	Keep only rows matching the term (repeatable; terms AND). Columns are the printed table headers lowercased; * wildcards match the whole cell case-insensitively, != negates, commas mean any-of. Applied client-side. Grammar: opschain docs cli.

See also

• opschain docs cli/infrastructure-show — one node in full.