Edit this page on GitHub

network-show-version

network-show-version retrieves system version information from any network device that has a registered profile. It returns normalized hostname, software version, and chassis type through the best available protocol.

Canonical output fields

FieldDescription
HostnameDevice hostname
SoftwareVersionRunning software version string
ChassisTypeHardware chassis / platform type

Unmapped vendor-specific fields are captured in VendorExtensions.

Key behavior

  • executes the get_system_version operation from the device profile
  • read-only by default
  • supports single source or fleet sourceSelector
  • automatic protocol selection based on source capabilities
  • optional transforms for per-tool jq post-processing
  • YANG-schema-aware when --schema-dir is set

Runtime parameters

  • device (optional, fleet mode): target a specific device in the selector

Example configurations

Single source

kind: tools
name: show_spine1_version
type: network-show-version
source: nokia-yang-lab/spine-1/gnmi

Fleet mode

kind: tools
name: show_all_versions
type: network-show-version
sourceSelector:
  matchLabels:
    role: spine
  maxConcurrency: 4