Skip to content

Capabilities

Description#

The [cap | capabilities] command represents the gNMI Capabilities RPC.

It is used to send a Capability Request to the specified target(s) and expects one Capability Response per target.

Capabilities allows the client to retrieve the set of capabilities that is supported by the target:

  • gNMI version
  • available data models
  • supported encodings
  • gNMI extensions

This allows the client to, for example, validate the service version that is implemented and retrieve the set of models that the target supports. The models can then be specified in subsequent Get/Subscribe RPCs to precisely tell the target which models to use.

Usage#

gnmic [global-flags] capabilities [local-flags]

Examples#

single host#

gnmic -a <ip:port> --username <user> --password <password> \
      --insecure capabilities

gNMI_Version: 0.7.0
supported models:
  - nokia-conf, Nokia, 19.10.R2
  - nokia-state, Nokia, 19.10.R2
  - nokia-li-state, Nokia, 19.10.R2
  - nokia-li-conf, Nokia, 19.10.R2
<< SNIPPED >>
supported encodings:
  - JSON
  - BYTES

multiple hosts#

gnmic -a <ip:port>,<ip:port> -u <user> -p <password> \
      --insecure cap