Cisco Nexus 3000 and 9000 Series NX-API REST SDK API, Release 9.3(x)

Cisco Nexus 3000 and 9000 Series NX-API REST Documentation

Configuring NBM VRF in PIM Active Mode to Restrict Reserving RPF Bandwidth if Only Valid Receivers

DME

YANG

Copy
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf/global.json
{
  "nbmGlobalConf": {
    "children": [
      {
        "nbmGlobalConfDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmGlobalConfig": {
                "attributes": {
                  "resBwRxOnly": "ENABLED"
}}}]}}]}}
Response
{
    imdata:[]
}

Copy
<System>
  <nbm-items>
    <conf-items>
      <global-items>
        <dom-items>
          <GlobalConfDom-list>
            <name>default</name>
            <global-items>
              <resBwRxOnly>ENABLED</resBwRxOnly>
            </global-items>
          </GlobalConfDom-list>
        </dom-items>
      </global-items>
    </conf-items>
  </nbm-items>
</System>

Optimizing Bandwidth Utilization

This section demonstrates the optimization of bandwidth utilization by determination of no valid receivers on the RP and releases the unneeded RPF bandwidth. (Prevents RP from pre-reserving bandwidth towards FHR.)

For more information, see the Cisco Nexus 9000 Series NX-OS IP Fabric for Media Solution Guide:

https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-installation-and-configuration-guides-list.html/

Configuring NBM VRF in PIM Active Mode to Restrict Reserving RPF Bandwidth if Only Valid Receivers

Note: This example was added in Release 9.3(5).

CLI Commands

The CLI commands are equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload. Click the YANG tab to view the XML payload.

nbm flow reserve-bandwidth receiver-only

Verifying a DME Configuration

The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.

MO	DN
nbmGlobalConf	sys/nbm/conf/global
nbmGlobalConfDom	sys/nbm/conf/global/dom-default
nbmGlobalConfig	sys/nbm/conf/global/dom-default/global

nbmGlobalConfig Properties

The following table contains information about the nbmGlobalConfig 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
resBwRxOnly	nbm:nbmDisEn (scalar:Enum8)	Enable or Disable Bandwidth Reservation on Receiver Start Only	SELECTION: 0 - DISABLED 1 - ENABLED DEFAULT: DISABLED

nbmGlobalConfDom Properties

The following table contains information about the nbmGlobalConfDom 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
name	naming:Name256 (string:Basic)	The name of the object.	MAX SIZE: 63

Related Documentation

For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:

http://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-command-reference-list.html

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:

https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html

Deleting Global Knob to Restrict Reserving RPF Bandwidth if Only Valid Receivers