Skip to main content
Version: v5.8.0

opschain governance references

Included from Basic tier

opschain governance references (--run <id> | --external-id <id> [--system <system>]) [--limit <n>]

Reads the external references steps reported (GovernanceService.ListExternalReferences). --external-id is the auditor's lookup: starting from an entry in a target system's own audit log — an ARM operation, a Cloudflare audit entry, a commit, an issue key — it finds the OpsChain steps that reported that id, with their run, node, chain and principal id. --run lists every reference one run's steps reported. -o json / -o yaml emit the references (opschain docs resources/governed_activity).

A run you cannot read answers not found; in an --external-id lookup a step on a node you cannot read never appears.

Flags​

FlagMeaning
--run <id>Every reference this run's steps reported.
--external-id <id>The id a target system minted: every step that reported it.
--system <system>Narrow --external-id to one target system, e.g. azure.
--limit <n>At most this many references (default 100).

Name exactly one of --run and --external-id.

Exit codes​

CodeMeaning
0Listed (possibly none).
1The server refused or is unreachable; the run is not readable.
2Usage error — neither or both of --run and --external-id, --system with --run, a non-positive --limit.

Examples​

opschain governance references --external-id 8f2c41d0 --system cloudflare
SYSTEM KIND ID RUN STEP NODE RECORDED
cloudflare rule 8f2c41d0 019a…-7c21 edge_apply /projects/hosted_ops/environments/prod 2026-11-17T22:31:09Z