Querying an OSPFv2 Instance
Querying an OSPFv2 Instance
GET http://<IP_Address>/api/node/mo/sys/ospf/inst-my_ospf.json?rsp-subtree=full
{
"totalCount": "1",
"imdata": [
{
"ospfInst": {
"attributes": {
"adminSt": "enabled",
"childAction": "",
"ctrl": "",
"dn": "sys/ospf/inst-my_ospf",
"memAlert": "normal",
"modTs": "2016-12-13T02:57:36.789+00:00",
"monPolDn": "uni/fabric/monfab-default",
"name": "my_ospf",
"operErr": "",
"persistentOnReload": "true",
"status": "",
"uid": "0"
},
"children": [
{
"ospfDom": {
"attributes": {
"adjChangeLogLevel": "none",
"adminSt": "enabled",
"bwRef": "40000",
"bwRefUnit": "mbps",
"childAction": "",
"ctrl": "",
"defMetric": "unspecified",
"discardRoute": "ext,int",
"dist": "110",
"downbitIgnore": "no",
"maxEcmp": "8",
"modTs": "2016-12-13T02:57:36.789+00:00",
"monPolDn": "uni/fabric/monfab-default",
"name": "default",
"operRtrId": "0.0.0.0",
"operSt": "down",
"persistentOnReload": "true",
"rfc1583Compat": "no",
"rn": "dom-default",
"rtrId": "0.0.0.0",
"status": "",
"uid": "0"
},
"children": [
{
"ospfGr": {
"attributes": {
"childAction": "",
"ctrl": "complete",
"gracePeriod": "60",
"helper": "yes",
"modTs": "2016-12-13T02:57:36.789+00:00",
"persistentOnReload": "true",
"restartAge": "0",
"restartExitReason": "none",
"restartStatus": "not-restarting",
"rn": "gr",
"status": "",
"uid": "0"
}
}
},
{
"ospfArea": {
"attributes": {
"asbrCnt": "0",
"authType": "unspecified",
"brCnt": "0",
"childAction": "",
"cost": "1",
"ctrl": "",
"id": "0.0.0.10",
"lsaCksumSum": "0",
"modTs": "2016-12-14T22:38:25.014+00:00",
"monPolDn": "uni/fabric/monfab-default",
"nssaTransRole": "candidate",
"nssaTransSt": "elected",
"nssaTransStabIntvl": "40",
"persistentOnReload": "true",
"rn": "area-0.0.0.10",
"status": "",
"type": "regular",
"uid": "0"
},
"children": [
{
"ospfVLink": {
"attributes": {
"childAction": "",
"deadIntvl": "unspecified",
"helloIntvl": "10",
"modTs": "2016-12-14T22:38:25.014+00:00",
"monPolDn": "uni/fabric/monfab-default",
"nbrRtrId": "10.1.2.3",
"persistentOnReload": "true",
"rexmitIntvl": "5",
"rn": "vlink-10.1.2.3",
"status": "",
"uid": "0",
"xmitDelay": "1"
}}}]}}]}}]}}]}
Displays OSPF information.
CLI Command
The CLI command below is the equivalent to the payload example displayed in the pane on the right.
show ip ospf my_ospf
Note: The property information for this example was added in Release 9.3(3).
ospfInst Properties
The following table contains information about the ospfInst properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name Data Type Description Values adminSt nw:AdminSt
(scalar:Enum8)The administrative state of the object or policy. SELECTION: childAction
mo:ModificationChildAction
scalar:Bitmask32Delete or ignore. For internal use only. SELECTION:
ctrl nw:InstCtrl
(scalar:Bitmask64)The control state. SELECTION: dn
reference:BinRefA tag or metadata is a non-hierarchical keyword or term assigned to the fabric module. memAlert nw:MemAlertLevel
(scalar:Enum8)Specifies the memory alert level SELECTION: modTs mo:TStamp
(scalar:Date)The time when this object was last modified. SELECTION: monPolDn
reference:BinRefThe object that represents the OSPF instance monitoring policy information. name naming:Name256
(string:Basic)The name of the object. operErr nw:OperErrQual
(scalar:Bitmask64)Operational Errors Qualifier SELECTION: persistentOnReload
mo:Persistent
scalar:Enum8NO COMMENTS SELECTION:
status mo:ModificationStatus
(scalar:Bitmask32)The upgrade status. This property is for internal use only. SELECTION: uid
scalar:Uint16A unique identifier for this object.
ospfDom Properties
The following table contains information about the ospfDom properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name Data Type Description Values adjChangeLogLevel ospf:AdjChangeLogLevel
(scalar:Enum8)Adjacency change logging level SELECTION: adminSt nw:AdminSt
(scalar:Enum8)Holds the administrative state of domain SELECTION: bwRef ospf:BwRef
(scalar:Uint32)Bandwidth reference value, holds the range from 1-4000000 if unit is mbps and holds range from 1-4000 if unit is gbps RANGE: [0, 4294967295] bwRefUnit ospf:BwRefUnit
(scalar:Enum8)Bandwidth reference unit (Mbps or Gbps) SELECTION: childAction
mo:ModificationChildAction
scalar:Bitmask32Delete or ignore. For internal use only. SELECTION:
ctrl ospf:DomControl
(scalar:Bitmask8)Holds the controls bfd, name-lookup, default-passive and Segment Routing SELECTION: defMetric ospf:Metric
(scalar:Uint32)Default metric cost for redistributed routes discardRoute ospf:DiscardRoute
(scalar:Bitmask8)Control bits for discard-route external and internal SELECTION: dist ospf:Dist
(scalar:UByte)Administrative distance preference downbitIgnore scalar:Bool Holds the status of Down-bit ignore SELECTION: true or false maxEcmp ospf:Ecmp
(scalar:UByte)Maximum Equal Cost Multi Path(ECMP) modTs mo:TStamp
(scalar:Date)The time when this object was last modified. SELECTION: monPolDn
reference:BinRefThe monitoring policy attached to this observable object. name naming:Name256
(string:Basic)The name of the object. operRtrId ip:RtrId
(address:IPv4)Operational router identifier for this domain Value must match ipv4 format operSt ospf:OperSt
(scalar:Enum8)Operational state of Layer 3 virtualization related commands(l3vm) SELECTION: persistentOnReload
mo:Persistent
scalar:Enum8NO COMMENTS SELECTION:
rfc1583Compat scalar:Bool RFC 1583 compatibility for external path preferences SELECTION: true or false rn
reference:BinRNIdentifies an object from its siblings within the context of its parent object. The distinguished name contains a sequence of relative names. rtrId ip:RtrId
(address:IPv4)Router identifier for this domain Value must match ipv4 format status mo:ModificationStatus
(scalar:Bitmask32)The upgrade status. This property is for internal use only. SELECTION: uid
scalar:Uint16A unique identifier for this object.
ospfGr Properties
The following table contains information about the ospfGr properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name Data Type Description Values childAction
mo:ModificationChildAction
scalar:Bitmask32Delete or ignore. For internal use only. SELECTION:
ctrl ospf:GrCtrl
(scalar:Enum8)Graceful restart controls like planned, complete and disabled state SELECTION: gracePeriod ospf:GrPeriod
(scalar:Uint32)Graceful restart period in seconds starting from 5 to 1800 helper scalar:Bool Graceful restart helper mode SELECTION: true or false modTs mo:TStamp
(scalar:Date)The time when this object was last modified. SELECTION: persistentOnReload
mo:Persistent
scalar:Enum8NO COMMENTS SELECTION:
restartAge scalar:Uint32 Graceful restart age RANGE: [0, 4294967295] restartExitReason ospf:RestartExitReason
(scalar:Enum8)Graceful restart exit reason SELECTION: restartStatus ospf:RestartStatus
(scalar:Enum8)Graceful restart status includes planned, unplanned and not-restarting SELECTION: rn
reference:BinRNIdentifies an object from its siblings within the context of its parent object. The distinguished name contains a sequence of relative names. status mo:ModificationStatus
(scalar:Bitmask32)The upgrade status. This property is for internal use only. SELECTION: uid
scalar:Uint16A unique identifier for this object.
ospfArea Properties
The following table contains information about the ospfArea properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name Data Type Description Values asbrCnt ospf:AsbrCnt
(scalar:Uint32)Autonomous system border router count RANGE: [0, 4294967295] authType ospf:AuthT
(scalar:Enum8)Authentication type can be simple, none or md5 SELECTION: brCnt ospf:BrCnt
(scalar:Uint32)Area border router count RANGE: [0, 4294967295] childAction
mo:ModificationChildAction
scalar:Bitmask32Delete or ignore. For internal use only. SELECTION:
cost ospf:AreaCost
(scalar:Uint32)Area cost, specifies cost for default summary LSAs, Used with nssa/stub area types ctrl ospf:AreaControl
(scalar:Bitmask8)Area controls can be ABRs originate summary LSAs into other areas, redistributed LSAs or suppress forwarding address SELECTION: id ospf:AreaId
(address:IPv4)Area identifier to which a network or interface belongs lsaCksumSum ospf:LsaCksumSum
(scalar:Uint32)Link-state advertisement(LSA) checksum sum RANGE: [0, 4294967295] modTs mo:TStamp
(scalar:Date)The time when this object was last modified. SELECTION: monPolDn
reference:BinRefThe monitoring policy attached to this observable object. nssaTransRole ospf:NssaTransRole
(scalar:Enum8)Not-so-stubby area(NSSA) translator role SELECTION: nssaTransSt ospf:NssaTransSt
(scalar:Enum8)Not-so-stubby area (NSSA) translator state SELECTION: nssaTransStabIntvl ospf:NssaTransStabIntvl
(scalar:Uint32)Not-so-stubby area (NSSA) translator stability interval persistentOnReload
mo:Persistent
scalar:Enum8NO COMMENTS SELECTION:
rn
reference:BinRNIdentifies an object from its siblings within the context of its parent object. The distinguished name contains a sequence of relative names. status mo:ModificationStatus
(scalar:Bitmask32)The upgrade status. This property is for internal use only. SELECTION: type ospf:AreaT
(scalar:Enum8)Area types can be stub, nssa, backbone etc. SELECTION: uid
scalar:Uint16A unique identifier for this object.
ospfVLink Properties
The following table contains information about the ospfVLink properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.
Property Name Data Type Description Values childAction
mo:ModificationChildAction
scalar:Bitmask32Delete or ignore. For internal use only. SELECTION:
deadIntvl ospf:DeadIntvl
(scalar:Uint32)Dead interval, interval after which router declares that neighbor as down helloIntvl ospf:HelloIntvl
(scalar:Uint16)Hello interval, interval between hello packets that OSPF sends on the interface modTs mo:TStamp
(scalar:Date)The time when this object was last modified. SELECTION: monPolDn
reference:BinRefThe monitoring policy attached to this observable object. nbrRtrId ip:RtrId
(address:IPv4)Router id associated with virtual link neighbor Value must match ipv4 format persistentOnReload
mo:Persistent
scalar:Enum8NO COMMENTS SELECTION:
rexmitIntvl ospf:RexmitIntvl
(scalar:Uint16)Retransmit interval, time between LSA retransmissions rn
reference:BinRNIdentifies an object from its siblings within the context of its parent object. The distinguished name contains a sequence of relative names. status mo:ModificationStatus
(scalar:Bitmask32)The upgrade status. This property is for internal use only. SELECTION: uid
scalar:Uint16A unique identifier for this object. xmitDelay ospf:XmitDelay
(scalar:Uint16)Transmit delay, estimated time needed to send an LSA update packet
Related Documentation
For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:
See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload:
https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/
For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide: