Configuring NBM in PIM Active Mode

This section describes how to configure Non-blocking Multicast (NBM) in PIM Active mode, which ensures that the bandwidth coming into the fabric is the same as the bandwidth that is going out.

NOTE: IPFM is not supported on Nexus 3000 Series of switches.

This section contains payload examples and CLIs to demonstrate how to use the NX-API REST API to configure NBM on Cisco Nexus 9000 Series switches and to show how the REST APIs correspond to the CLI commands. For more information, see the Cisco Nexus 9000 Series NX-OS IP Fabric for Media Solution Guide, Releases 7.0(3)I4(5), 7.0(3)F2(1), and Later Releases configuration guide:

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

Configuring the Percentage of Bandwidth for Unicast Flow

Configuring the Percentage of Bandwidth for Unicast Flow
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmGlobalConf": {
    "children": [
      {
        "nbmGlobalConfDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmGlobalConfig": {
                "attributes": {
                  "unicastBwPercent": "75"
}}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <global-items>
        <dom-items>
          <GlobalConfDom-list>
            <name>default</name>
            <global-items>
              <unicastBwPercent>75</unicastBwPercent>
            </global-items>
          </GlobalConfDom-list>
        </dom-items>
      </global-items>
    </conf-items>
  </nbm-items>
</System>


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 reserve unicast fabric bandwidth 75

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmGlobalConf sys/nbm/conf/global
nbmGlobalConfDom sys/nbm/conf/global/dom-{name}
nbmGlobalConfig sys/nbm/conf/global/dom-{name}/global


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 NameData TypeDescriptionValues
namenaming:Name256
(string:Basic)
The name of the object.
MAX SIZE: 63


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 NameData TypeDescriptionValues
unicastBwPercentscalar:UByte
Unicast Bandwidth Reservation.
RANGE: [0 , 100]
DEFAULT: 0


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 the Percentage of Bandwidth for Unicast Flow

Deleting the Percentage of Bandwidth for Unicast Flow
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmGlobalConf": {
    "children": [
      {
        "nbmGlobalConfDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmGlobalConfig": {
                "attributes": {
                  "unicastBwPercent": "0"
}}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <global-items>
        <dom-items>
          <GlobalConfDom-list>
            <name>default</name>
            <global-items>
              <unicastBwPercent>0</unicastBwPercent>
            </global-items>
          </GlobalConfDom-list>
        </dom-items>
      </global-items>
    </conf-items>
  </nbm-items>
</System>


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.

no nbm reserve unicast fabric bandwidth

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmGlobalConf sys/nbm/conf/global
nbmGlobalConfDom sys/nbm/conf/global/dom-{name}
nbmGlobalConfig sys/nbm/conf/global/dom-{name}/global


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 NameData TypeDescriptionValues
namenaming:Name256
(string:Basic)
The name of the object.
MAX SIZE: 63


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 NameData TypeDescriptionValues
unicastBwPercentscalar:UByte
Unicast Bandwidth Reservation.
RANGE: [0 , 100]
DEFAULT: 0


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

Configuring Explicit Group Ranges

Configuring Explicit Group Ranges
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmGroupRangeList": {
    "children": [
      {
        "nbmGroupRangeDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmGroupRange": {
                "attributes": {
                  "group": "237.1.1.0",
                  "groupMask": "24"
}}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <grouprangelist-items>
        <dom-items>
          <GroupRangeDom-list>
            <name>default</name>
            <g-items>
              <GroupRange-list>
                <group>237.1.1.0</group>
                <groupMask>24</groupMask>
              </GroupRange-list>
            </g-items>
          </GroupRangeDom-list>
        </dom-items>
      </grouprangelist-items>
    </conf-items>
  </nbm-items>
</System>


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 asm range 237.1.1.0/24

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmGroupRangeList sys/nbm/conf/grouprangelist
nbmGroupRangeDom sys/nbm/conf/grouprangelist/dom-{name}
nbmGroupRange sys/nbm/conf/grouprangelist/dom-{name}/g-{[group]}-m-{groupMask}


nbmGroupRangeDom Properties

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


nbmGroupRange Properties

The following table contains information about the nbmGroupRange 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 NameData TypeDescriptionValues
groupnbm:nbmMcastIpAddr
(address:Ip)
ASM Range Multicast Group.
Multicast Group Range IP only.
Value must match ipv4 or ipv6 known format
groupMasknbm:nbmIpMask
(scalar:Uint16)
ASM Range Group Mask as integer.
IP Addr mask between 5 and 32.
RANGE: [0 , 32]


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

Configuring More than 1 Explicit Group Range in a Line

Configuring More than 1 Explicit Group Range in a Line
POST http://<mgmt0_IP>/api/mo/sys.json
{
  "topSystem": {
    "children": [
      {
        "nbmNbmTop": {
          "children": [
            {
              "nbmConfTables": {
                "children": [
                  {
                    "nbmGroupRangeList": {
                      "children": [
                        {
                          "nbmGroupRangeDom": {
                            "attributes": {
                              "name": "default"
                            },
                            "children": [
                              {
                                "nbmGroupRange": {
                                  "attributes": {
                                    "group": "225.0.0.0",
                                    "groupMask": "8"
                                  }
                                }
                              },
                              {
                                "nbmGroupRange": {
                                  "attributes": {
                                    "group": "225.0.0.1",
                                    "groupMask": "8"
                                  }
                                }
                              },
                              {
                                "nbmGroupRange": {
                                  "attributes": {
                                    "group": "237.1.1.0",
                                    "groupMask": "24"
                                  }
                                }
                              }
                            ]
                          }
                        }
                      ]
                    }
                  }
                ]
              }
            }
          ]
        }
      }
    ]
  }
}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <grouprangelist-items>
        <dom-items>
          <GroupRangeDom-list>
            <name>default</name>
            <g-items>
              <GroupRange-list>
                <group>225.0.0.0</group>
                <groupMask>8</groupMask>
              </GroupRange-list>
              <GroupRange-list>
                <group>225.0.0.1</group>
                <groupMask>8</groupMask>
              </GroupRange-list>
              <GroupRange-list>
                <group>237.1.1.0</group>
                <groupMask>24</groupMask>
              </GroupRange-list>
            </g-items>
          </GroupRangeDom-list>
        </dom-items>
      </grouprangelist-items>
    </conf-items>
  </nbm-items>
</System>


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 asm range 237.1.1.0/24 225.0.0.0/8 225.0.0.1/8

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
topSystem sys
nbmNbmTop sys/nbm
nbmConfTables sys/nbm/conf
nbmGroupRangeList sys/nbm/conf/grouprangelist
nbmGroupRangeDom sys/nbm/conf/grouprangelist/dom-{name}
nbmGroupRange sys/nbm/conf/grouprangelist/dom-{name}/g-{[group]}-m-{groupMask}


nbmGroupRangeDom Properties

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


nbmGroupRange Properties

The following table contains information about the nbmGroupRange 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 NameData TypeDescriptionValues
groupnbm:nbmMcastIpAddr
(address:Ip)
ASM Range Multicast Group.
Multicast Group Range IP only.
Value must match ipv4 or ipv6 known format
groupMasknbm:nbmIpMask
(scalar:Uint16)
ASM Range Group Mask as integer.
IP Addr mask between 5 and 32.
RANGE: [0 , 32]


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 Explicit Group Ranges

Deleting Explicit Group Ranges
POST http://<mgmt0_IP>/api/mo/sys.json
{
  "topSystem": {
    "children": [
      {
        "nbmNbmTop": {
          "children": [
            {
              "nbmConfTables": {
                "children": [
                  {
                    "nbmGroupRangeList": {
                      "children": [
                        {
                          "nbmGroupRangeDom": {
                            "attributes": {
                              "name": "default"
                            },
                            "children": [
                              {
                                "nbmGroupRange": {
                                  "attributes": {
                                    "group": "237.1.1.0",
                                    "groupMask": "24",
                                    "status": "deleted"
                                  }
                                }
                              }
                            ]
                          }
                        }
                      ]
                    }
                  }
                ]
              }
            }
          ]
        }
      }
    ]
  }
}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <grouprangelist-items>
        <dom-items>
          <GroupRangeDom-list>
            <name>default</name>
            <g-items>
              <GroupRange-list xc:operation="delete">
                <group>237.1.1.0</group>
                <groupMask>24</groupMask>
              </GroupRange-list>
            </g-items>
          </GroupRangeDom-list>
        </dom-items>
      </grouprangelist-items>
    </conf-items>
  </nbm-items>
</System>


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.

no nbm flow asm range 237.1.1.0/24

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
topSystem sys
nbmNbmTop sys/nbm
nbmConfTables sys/nbm/conf
nbmGroupRangeList sys/nbm/conf/grouprangelist
nbmGroupRangeDom sys/nbm/conf/grouprangelist/dom-{name}
nbmGroupRange sys/nbm/conf/grouprangelist/dom-{name}/g-{[group]}-m-{groupMask}


nbmGroupRangeDom Properties

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


nbmGroupRange Properties

The following table contains information about the nbmGroupRange 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 NameData TypeDescriptionValues
groupnbm:nbmMcastIpAddr
(address:Ip)
ASM Range Multicast Group.
Multicast Group Range IP only.
Value must match ipv4 or ipv6 known format
groupMasknbm:nbmIpMask
(scalar:Uint16)
ASM Range Group Mask as integer.
IP Addr mask between 5 and 32.
RANGE: [0 , 32]
statusmo:ModificationStatus
(scalar:Bitmask32)
The upgrade status. This property is for internal use only.SELECTION:
2 - created
4 - modified
8 - deleted
16 - replaced


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 Custom Flow Policies

Deleting Custom Flow Policies
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmFlowPolicyTable": {
    "children": [
      {
        "nbmFlowPolicyDom": {
          "attributes": {
            "name": "default",
            "status": "deleted"
}}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <flowpolicytable-items>
        <dom-items>
          <FlowPolicyDom-list xc:operation="delete">
            <name>default</name>
          </FlowPolicyDom-list>
        </dom-items>
      </flowpolicytable-items>
    </conf-items>
  </nbm-items>
</System>


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.

no nbm flow-policy

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmFlowPolicyTable sys/nbm/conf/flowpolicytable
nbmFlowPolicyDom sys/nbm/conf/flowpolicytable/dom-{name}


nbmFlowPolicyDom Properties

The following table contains information about the nbmFlowPolicyDom 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 NameData TypeDescriptionValues
namenaming:Name256
(string:Basic)
The name of the object.
MAX SIZE: 63
statusmo:ModificationStatus
(scalar:Bitmask32)
The upgrade status. This property is for internal use only.SELECTION:
2 - created
4 - modified
8 - deleted
16 - replaced


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

Configuring the Default Flow Bandwidth Value in Kbps

Configuring the Default Flow Bandwidth Value in Kbps
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmGlobalConf": {
    "children": [
      {
        "nbmGlobalConfDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmGlobalConfig": {
                "attributes": {
                  "defaultflowBw": "123",
                  "defaultflowBwUnit": "KBPS"
}}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <global-items>
        <dom-items>
          <GlobalConfDom-list>
            <name>default</name>
            <global-items>
              <defaultflowBw>123</defaultflowBw>
              <defaultflowBwUnit>KBPS</defaultflowBwUnit>
            </global-items>
          </GlobalConfDom-list>
        </dom-items>
      </global-items>
    </conf-items>
  </nbm-items>
</System>


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 bandwidth 123 kbps

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmGlobalConf sys/nbm/conf/global
nbmGlobalConfDom sys/nbm/conf/global/dom-{name}
nbmGlobalConfig sys/nbm/conf/global/dom-{name}/global


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 NameData TypeDescriptionValues
namenaming:Name256
(string:Basic)
The name of the object.
MAX SIZE: 63


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 NameData TypeDescriptionValues
defaultflowBwscalar:Uint32
Flow Policy Default BW.RANGE: [0, 4294967295]
DEFAULT: 0
defaultflowBwUnitnbm:nbmBwUnitEn
(scalar:Enum8)
bandwidth units - Mbps, Kbps, or GbpsSELECTION:
0 - UNSPECIFIED
1 - KBPS
2 - MBPS
3 - GBPS
DEFAULT: KBPS


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

Configuring the Default Flow Bandwidth Value in Mbps

Configuring the Default Flow Bandwidth Value in Mbps
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmGlobalConf": {
    "children": [
      {
        "nbmGlobalConfDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmGlobalConfig": {
                "attributes": {
                  "defaultflowBw": "123",
                  "defaultflowBwUnit": "MBPS"
}}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <global-items>
        <dom-items>
          <GlobalConfDom-list>
            <name>default</name>
            <global-items>
              <defaultflowBw>123</defaultflowBw>
              <defaultflowBwUnit>MBPS</defaultflowBwUnit>
            </global-items>
          </GlobalConfDom-list>
        </dom-items>
      </global-items>
    </conf-items>
  </nbm-items>
</System>


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 bandwidth 123 mbps

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmGlobalConf sys/nbm/conf/global
nbmGlobalConfDom sys/nbm/conf/global/dom-{name}
nbmGlobalConfig sys/nbm/conf/global/dom-{name}/global


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 NameData TypeDescriptionValues
namenaming:Name256
(string:Basic)
The name of the object.
MAX SIZE: 63


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 NameData TypeDescriptionValues
defaultflowBwscalar:Uint32
Flow Policy Default BW.RANGE: [0, 4294967295]
DEFAULT: 0
defaultflowBwUnitnbm:nbmBwUnitEn
(scalar:Enum8)
bandwidth units - Mbps, Kbps, or GbpsSELECTION:
0 - UNSPECIFIED
1 - KBPS
2 - MBPS
3 - GBPS
DEFAULT: KBPS


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

Configuring the Default Flow Bandwidth Value in Gbps

Configuring the Default Flow Bandwidth Value in Gbps
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmGlobalConf": {
    "children": [
      {
        "nbmGlobalConfDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmGlobalConfig": {
                "attributes": {
                  "defaultflowBw": "12",
                  "defaultflowBwUnit": "GBPS"
}}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <global-items>
        <dom-items>
          <GlobalConfDom-list>
            <name>default</name>
            <global-items>
              <defaultflowBw>12</defaultflowBw>
              <defaultflowBwUnit>GBPS</defaultflowBwUnit>
            </global-items>
          </GlobalConfDom-list>
        </dom-items>
      </global-items>
    </conf-items>
  </nbm-items>
</System>

You can define specific bandwidth requirements for given multicast groups. Multicast groups without a specific flow bandwidth definition are specified as having a default flow bandwidth.


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 bandwidth 12 gbps

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmGlobalConf sys/nbm/conf/global
nbmGlobalConfDom sys/nbm/conf/global/dom-{name}
nbmGlobalConfig sys/nbm/conf/global/dom-{name}/global


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 NameData TypeDescriptionValues
namenaming:Name256
(string:Basic)
The name of the object.
MAX SIZE: 63


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 NameData TypeDescriptionValues
defaultflowBwscalar:Uint32
Flow Policy Default BW.RANGE: [0, 4294967295]
DEFAULT: 0
defaultflowBwUnitnbm:nbmBwUnitEn
(scalar:Enum8)
bandwidth units - Mbps, Kbps, or GbpsSELECTION:
0 - UNSPECIFIED
1 - KBPS
2 - MBPS
3 - GBPS
DEFAULT: KBPS


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 a Flow Bandwidth Policy

Deleting a Flow Bandwidth Policy
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmGlobalConf": {
    "children": [
      {
        "nbmGlobalConfDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmGlobalConfig": {
                "attributes": {
                  "defaultflowBw": "0",
                  "defaultflowBwUnit": "KBPS"
}}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <global-items>
        <dom-items>
          <GlobalConfDom-list>
            <name>default</name>
            <global-items>
              <defaultflowBw>0</defaultflowBw>
              <defaultflowBwUnit>KBPS</defaultflowBwUnit>
            </global-items>
          </GlobalConfDom-list>
        </dom-items>
      </global-items>
    </conf-items>
  </nbm-items>
</System>


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.

no nbm flow bandwidth

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmGlobalConf sys/nbm/conf/global
nbmGlobalConfDom sys/nbm/conf/global/dom-{name}
nbmGlobalConfig sys/nbm/conf/global/dom-{name}/global


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 NameData TypeDescriptionValues
namenaming:Name256
(string:Basic)
The name of the object.
MAX SIZE: 63


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 NameData TypeDescriptionValues
defaultflowBwscalar:Uint32
Flow Policy Default BW.RANGE: [0, 4294967295]
DEFAULT: 0
defaultflowBwUnitnbm:nbmBwUnitEn
(scalar:Enum8)
bandwidth units - Mbps, Kbps, or GbpsSELECTION:
0 - UNSPECIFIED
1 - KBPS
2 - MBPS
3 - GBPS
DEFAULT: KBPS


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

Configuring a Link Connected to an External Router
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmInterfaces": {
    "children": [
      {
        "nbmInterfacesDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmIf": {
                "attributes": {
                  "if": "436208128",
                  "role": "EXTERNAL_LINK"
}}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <interfaces-items>
        <dom-items>
          <InterfacesDom-list>
            <name>default</name>
            <if-items>
              <If-list>
                <if>436208128</if>
                <role>EXTERNAL_LINK</role>
              </If-list>
            </if-items>
          </InterfacesDom-list>
        </dom-items>
      </interfaces-items>
    </conf-items>
  </nbm-items>
</System>

You can install an NBM fabric in a Multisite topology where different fabrics are interconnected to each other. For a given fabric, all other fabrics are considered to be external routers, and the interfaces used to connect two fabrics are called, and should be configured as, external links.


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.

interface ethernet 1/2
 nbm external-link

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmInterfaces sys/nbm/conf/interfaces
nbmInterfacesDom sys/nbm/conf/interfaces/dom-{name}
nbmIf sys/nbm/conf/interfaces/dom-{name}/if-{if}


nbmInterfacesDom Properties

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


nbmIf Properties

The following table contains information about the nbmIf 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 NameData TypeDescriptionValues
ifnbm:nbmIf
(scalar:Uint32)
Interface if-index.RANGE: [0, 4294967295]
rolenbm:nbmLinkRole
(scalar:Enum8)
Link Role.
EXTERNAL_LINK, FABRIC_LINK and NONE
SELECTION:
0 - EXTERNAL_LINK
1 - FABRIC_LINK
255 - NONE
DEFAULT: NONE


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

Un-Configuring a Link Connected to an External Router
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmInterfaces": {
    "children": [
      {
        "nbmInterfacesDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmIf": {
                "attributes": {
                  "if": "436208128",
                  "status": "deleted"
}}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <interfaces-items>
        <dom-items>
          <InterfacesDom-list>
            <name>default</name>
            <if-items>
              <If-list xc:operation="delete">
                <if>436208128</if>
              </If-list>
            </if-items>
          </InterfacesDom-list>
        </dom-items>
      </interfaces-items>
    </conf-items>
  </nbm-items>
</System>


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.

interface ethernet 1/2
 no nbm external-link

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmInterfaces sys/nbm/conf/interfaces
nbmInterfacesDom sys/nbm/conf/interfaces/dom-{name}
nbmIf sys/nbm/conf/interfaces/dom-{name}/if-{if}


nbmInterfacesDom Properties

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


nbmIf Properties

The following table contains information about the nbmIf 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 NameData TypeDescriptionValues
ifnbm:nbmIf
(scalar:Uint32)
Interface if-index.RANGE: [0, 4294967295]
statusmo:ModificationStatus
(scalar:Bitmask32)
The upgrade status. This property is for internal use only.SELECTION:
2 - created
4 - modified
8 - deleted
16 - replaced


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

Configuring a Custom Flow Policy

Configuring a Custom Flow Policy
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmFlowPolicyTable": {
    "children": [
      {
        "nbmFlowPolicyDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmFlowPolicy": {
                "attributes": {
                  "name": "name_1"
}}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <flowpolicytable-items>
        <dom-items>
          <FlowPolicyDom-list>
            <name>default</name>
            <name-items>
              <FlowPolicy-list>
                <name>name_1</name>
              </FlowPolicy-list>
            </name-items>
          </FlowPolicyDom-list>
        </dom-items>
      </flowpolicytable-items>
    </conf-items>
  </nbm-items>
</System>


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-policy
 policy name_1

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmFlowPolicyTable sys/nbm/conf/flowpolicytable
nbmFlowPolicyDom sys/nbm/conf/flowpolicytable/dom-{name}
nbmFlowPolicy sys/nbm/conf/flowpolicytable/dom-{name}/name-{name}


nbmFlowPolicyDom Properties

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


nbmFlowPolicy Properties

The following table contains information about the nbmFlowPolicy 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 NameData TypeDescriptionValues
namestring:Basic
Flow Policy Name String.
Must be an alphanumerical string of max size 63
A sequence of characters


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 a Custom Flow Policy

Deleting a Custom Flow Policy
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmFlowPolicyTable": {
    "children": [
      {
        "nbmFlowPolicyDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmFlowPolicy": {
                "attributes": {
                  "name": "name_1",
                  "status": "deleted"
}}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <flowpolicytable-items>
        <dom-items>
          <FlowPolicyDom-list>
            <name>default</name>
            <name-items>
              <FlowPolicy-list xc:operation="delete">
                <name>name_1</name>
              </FlowPolicy-list>
            </name-items>
          </FlowPolicyDom-list>
        </dom-items>
      </flowpolicytable-items>
    </conf-items>
  </nbm-items>
</System>


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-policy
 no policy name_1

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmFlowPolicyTable sys/nbm/conf/flowpolicytable
nbmFlowPolicyDom sys/nbm/conf/flowpolicytable/dom-{name}
nbmFlowPolicy sys/nbm/conf/flowpolicytable/dom-{name}/name-{name}


nbmFlowPolicyDom Properties

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


nbmFlowPolicy Properties

The following table contains information about the nbmFlowPolicy 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 NameData TypeDescriptionValues
namestring:Basic
Flow Policy Name String.
Must be an alphanumerical string of max size 63
A sequence of characters
statusmo:ModificationStatus
(scalar:Bitmask32)
The upgrade status. This property is for internal use only.SELECTION:
2 - created
4 - modified
8 - deleted
16 - replaced


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

Configuring a Custom IP Multicast Group

Configuring a Custom IP Multicast Group
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmFlowPolicyTable": {
    "children": [
      {
        "nbmFlowPolicyDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmFlowPolicy": {
                "attributes": {
                  "name": "POL_1"
                },
                "children": [
                  {
                    "nbmFlowPolicyRange": {
                      "attributes": {
                        "groupBegin": "237.1.1.0",
                        "groupEnd": "237.1.1.0"
}}}]}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <flowpolicytable-items>
        <dom-items>
          <FlowPolicyDom-list>
            <name>default</name>
            <name-items>
              <FlowPolicy-list>
                <name>POL_1</name>
                <bgn-items>
                  <FlowPolicyRange-list>
                    <groupBegin>237.1.1.0</groupBegin>
                    <groupEnd>237.1.1.0</groupEnd>
                  </FlowPolicyRange-list>
                </bgn-items>
              </FlowPolicy-list>
            </name-items>
          </FlowPolicyDom-list>
        </dom-items>
      </flowpolicytable-items>
    </conf-items>
  </nbm-items>
</System>


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-policy
 policy POL_1
  ip group 237.1.1.0

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmFlowPolicyTable sys/nbm/conf/flowpolicytable
nbmFlowPolicyDom sys/nbm/conf/flowpolicytable/dom-{name}
nbmFlowPolicy sys/nbm/conf/flowpolicytable/dom-{name}/name-{name}
nbmFlowPolicyRange sys/nbm/conf/flowpolicytable/dom-{name}/name-{name}/bgn-{[groupBegin]}-end-{[groupEnd]}


nbmFlowPolicyDom Properties

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


nbmFlowPolicy Properties

The following table contains information about the nbmFlowPolicy 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 NameData TypeDescriptionValues
namestring:Basic
Flow Policy Name String.
Must be an alphanumerical string of max size 63
A sequence of characters


nbmFlowPolicyRange Properties

The following table contains information about the nbmFlowPolicyRange 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 NameData TypeDescriptionValues
groupBeginnbm:nbmMcastIpAddr
(address:Ip)
Flow Policy Group range start.
Multicast Group Range IP only
Value must match ipv4 or ipv6 known format
groupEndnbm:nbmMcastIpAddr
(address:Ip)
Flow Policy Group range end.
Multicast Group Range IP only. Must be same as groupBegin in case of specific group policy. i.e when range is not desired.
Value must match ipv4 or ipv6 known format


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 a Custom Multicast Group

Deleting a Custom Multicast Group
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmFlowPolicyTable": {
    "children": [
      {
        "nbmFlowPolicyDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmFlowPolicy": {
                "attributes": {
                  "name": "POL_1"
                },
                "children": [
                  {
                    "nbmFlowPolicyRange": {
                      "attributes": {
                        "groupBegin": "237.1.1.0",
                        "groupEnd": "237.1.1.0",
                        "status": "deleted"
}}}]}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <flowpolicytable-items>
        <dom-items>
          <FlowPolicyDom-list>
            <name>default</name>
            <name-items>
              <FlowPolicy-list>
                <name>POL_1</name>
                <bgn-items>
                  <FlowPolicyRange-list xc:operation="delete">
                    <groupBegin>237.1.1.0</groupBegin>
                    <groupEnd>237.1.1.0</groupEnd>
                  </FlowPolicyRange-list>
                </bgn-items>
              </FlowPolicy-list>
            </name-items>
          </FlowPolicyDom-list>
        </dom-items>
      </flowpolicytable-items>
    </conf-items>
  </nbm-items>
</System>


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.

no ip group 237.1.1.0

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmFlowPolicyTable sys/nbm/conf/flowpolicytable
nbmFlowPolicyDom sys/nbm/conf/flowpolicytable/dom-{name}
nbmFlowPolicy sys/nbm/conf/flowpolicytable/dom-{name}/name-{name}
nbmFlowPolicyRange sys/nbm/conf/flowpolicytable/dom-{name}/name-{name}/bgn-{[groupBegin]}-end-{[groupEnd]}


nbmFlowPolicyDom Properties

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


nbmFlowPolicy Properties

The following table contains information about the nbmFlowPolicy 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 NameData TypeDescriptionValues
namestring:Basic
Flow Policy Name String.
Must be an alphanumerical string of max size 63
A sequence of characters


nbmFlowPolicyRange Properties

The following table contains information about the nbmFlowPolicyRange 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 NameData TypeDescriptionValues
groupBeginnbm:nbmMcastIpAddr
(address:Ip)
Flow Policy Group range start.
Multicast Group Range IP only
Value must match ipv4 or ipv6 known format
groupEndnbm:nbmMcastIpAddr
(address:Ip)
Flow Policy Group range end.
Multicast Group Range IP only. Must be same as groupBegin in case of specific group policy. i.e when range is not desired.
Value must match ipv4 or ipv6 known format
statusmo:ModificationStatus
(scalar:Bitmask32)
The upgrade status. This property is for internal use only.SELECTION:
2 - created
4 - modified
8 - deleted
16 - replaced


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

Configuring a Custom Multicast Group Address Range

Configuring a Custom Multicast Group Address Range
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmFlowPolicyTable": {
    "children": [
      {
        "nbmFlowPolicyDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmFlowPolicy": {
                "attributes": {
                  "name": "POL_1"
                },
                "children": [
                  {
                    "nbmFlowPolicyRange": {
                      "attributes": {
                        "groupBegin": "237.1.1.0",
                        "groupEnd": "238.1.1.0"
}}}]}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <flowpolicytable-items>
        <dom-items>
          <FlowPolicyDom-list>
            <name>default</name>
            <name-items>
              <FlowPolicy-list>
                <name>POL_1</name>
                <bgn-items>
                  <FlowPolicyRange-list>
                    <groupBegin>237.1.1.0</groupBegin>
                    <groupEnd>238.1.1.0</groupEnd>
                  </FlowPolicyRange-list>
                </bgn-items>
              </FlowPolicy-list>
            </name-items>
          </FlowPolicyDom-list>
        </dom-items>
      </flowpolicytable-items>
    </conf-items>
  </nbm-items>
</System>


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-policy
 policy POL_1
  ip group-range 237.1.1.0 to 238.1.1.0

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmFlowPolicyTable sys/nbm/conf/flowpolicytable
nbmFlowPolicyDom sys/nbm/conf/flowpolicytable/dom-{name}
nbmFlowPolicy sys/nbm/conf/flowpolicytable/dom-{name}/name-{name}
nbmFlowPolicyRange sys/nbm/conf/flowpolicytable/dom-{name}/name-{name}/bgn-{[groupBegin]}-end-{[groupEnd]}


nbmFlowPolicyDom Properties

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


nbmFlowPolicy Properties

The following table contains information about the nbmFlowPolicy 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 NameData TypeDescriptionValues
namestring:Basic
Flow Policy Name String.
Must be an alphanumerical string of max size 63
A sequence of characters


nbmFlowPolicyRange Properties

The following table contains information about the nbmFlowPolicyRange 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 NameData TypeDescriptionValues
groupBeginnbm:nbmMcastIpAddr
(address:Ip)
Flow Policy Group range start.
Multicast Group Range IP only
Value must match ipv4 or ipv6 known format
groupEndnbm:nbmMcastIpAddr
(address:Ip)
Flow Policy Group range end.
Multicast Group Range IP only. Must be same as groupBegin in case of specific group policy. i.e when range is not desired.
Value must match ipv4 or ipv6 known format


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 a Custom Multicast Group Address Range

Deleting a Custom Multicast Group Address Range
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmFlowPolicyTable": {
    "children": [
      {
        "nbmFlowPolicyDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmFlowPolicy": {
                "attributes": {
                  "name": "POL_1"
                },
                "children": [
                  {
                    "nbmFlowPolicyRange": {
                      "attributes": {
                        "groupBegin": "237.1.1.0",
                        "groupEnd": "238.1.1.0",
                        "status": "deleted"
}}}]}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <flowpolicytable-items>
        <dom-items>
          <FlowPolicyDom-list>
            <name>default</name>
            <name-items>
              <FlowPolicy-list>
                <name>POL_1</name>
                <bgn-items>
                  <FlowPolicyRange-list xc:operation="delete">
                    <groupBegin>237.1.1.0</groupBegin>
                    <groupEnd>238.1.1.0</groupEnd>
                  </FlowPolicyRange-list>
                </bgn-items>
              </FlowPolicy-list>
            </name-items>
          </FlowPolicyDom-list>
        </dom-items>
      </flowpolicytable-items>
    </conf-items>
  </nbm-items>
</System>


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-policy
 policy POL_1
  no ip group-range 237.1.1.0 to 238.1.1.0

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmFlowPolicyTable sys/nbm/conf/flowpolicytable
nbmFlowPolicyDom sys/nbm/conf/flowpolicytable/dom-{name}
nbmFlowPolicy sys/nbm/conf/flowpolicytable/dom-{name}/name-{name}
nbmFlowPolicyRange sys/nbm/conf/flowpolicytable/dom-{name}/name-{name}/bgn-{[groupBegin]}-end-{[groupEnd]}


nbmFlowPolicyDom Properties

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


nbmFlowPolicy Properties

The following table contains information about the nbmFlowPolicy 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 NameData TypeDescriptionValues
namestring:Basic
Flow Policy Name String.
Must be an alphanumerical string of max size 63
A sequence of characters


nbmFlowPolicyRange Properties

The following table contains information about the nbmFlowPolicyRange 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 NameData TypeDescriptionValues
groupBeginnbm:nbmMcastIpAddr
(address:Ip)
Flow Policy Group range start.
Multicast Group Range IP only
Value must match ipv4 or ipv6 known format
groupEndnbm:nbmMcastIpAddr
(address:Ip)
Flow Policy Group range end.
Multicast Group Range IP only. Must be same as groupBegin in case of specific group policy. i.e when range is not desired.
Value must match ipv4 or ipv6 known format
statusmo:ModificationStatus
(scalar:Bitmask32)
The upgrade status. This property is for internal use only.SELECTION:
2 - created
4 - modified
8 - deleted
16 - replaced


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

Configuring a Custom Bandwidth Value in Kbps for a Flow Policy

Configuring a Custom Bandwidth Value in Kbps for a Flow Policy
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmFlowPolicyTable": {
    "children": [
      {
        "nbmFlowPolicyDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmFlowPolicy": {
                "attributes": {
                  "bw": "123",
                  "bwUnit": "KBPS",
                  "name": "POL_1"
}}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <flowpolicytable-items>
        <dom-items>
          <FlowPolicyDom-list>
            <name>default</name>
            <name-items>
              <FlowPolicy-list>
                <name>POL_1</name>
                <bw>123</bw>
                <bwUnit>KBPS</bwUnit>
              </FlowPolicy-list>
            </name-items>
          </FlowPolicyDom-list>
        </dom-items>
      </flowpolicytable-items>
    </conf-items>
  </nbm-items>
</System>


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-policy
 policy POL_1
  bandwidth 123 kbps

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmFlowPolicyTable sys/nbm/conf/flowpolicytable
nbmFlowPolicyDom sys/nbm/conf/flowpolicytable/dom-{name}
nbmFlowPolicy sys/nbm/conf/flowpolicytable/dom-{name}/name-{name}


nbmFlowPolicyDom Properties

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


nbmFlowPolicy Properties

The following table contains information about the nbmFlowPolicy 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 NameData TypeDescriptionValues
bwscalar:Uint64
Flow bandwidth.RANGE: [0, 18446744073709551615]
bwUnitnbm:nbmBwUnitEn
(scalar:Enum8)
bandwidth units - Mbps, Kbps, or GbpsSELECTION:
0 - UNSPECIFIED
1 - KBPS
2 - MBPS
3 - GBPS
DEFAULT: KBPS
namestring:Basic
Flow Policy Name String.
Must be an alphanumerical string of max size 63
A sequence of characters


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

Configuring a Custom Bandwidth Value in Mbps for a Flow Policy

Configuring a Custom Bandwidth Value in Mbps for a Flow Policy
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmFlowPolicyTable": {
    "children": [
      {
        "nbmFlowPolicyDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmFlowPolicy": {
                "attributes": {
                  "bw": "123",
                  "bwUnit": "MBPS",
                  "name": "POL_1"
}}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <flowpolicytable-items>
        <dom-items>
          <FlowPolicyDom-list>
            <name>default</name>
            <name-items>
              <FlowPolicy-list>
                <name>POL_1</name>
                <bw>123</bw>
                <bwUnit>MBPS</bwUnit>
              </FlowPolicy-list>
            </name-items>
          </FlowPolicyDom-list>
        </dom-items>
      </flowpolicytable-items>
    </conf-items>
  </nbm-items>
</System>


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-policy
 policy POL_1
  bandwidth 123 mbps

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmFlowPolicyTable sys/nbm/conf/flowpolicytable
nbmFlowPolicyDom sys/nbm/conf/flowpolicytable/dom-{name}
nbmFlowPolicy sys/nbm/conf/flowpolicytable/dom-{name}/name-{name}


nbmFlowPolicyDom Properties

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


nbmFlowPolicy Properties

The following table contains information about the nbmFlowPolicy 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 NameData TypeDescriptionValues
bwscalar:Uint64
Flow bandwidth.RANGE: [0, 18446744073709551615]
bwUnitnbm:nbmBwUnitEn
(scalar:Enum8)
bandwidth units - Mbps, Kbps, or GbpsSELECTION:
0 - UNSPECIFIED
1 - KBPS
2 - MBPS
3 - GBPS
DEFAULT: KBPS
namestring:Basic
Flow Policy Name String.
Must be an alphanumerical string of max size 63
A sequence of characters


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

Configuring a Custom Bandwidth Value in Gbps for a Flow Policy

Configuring a Custom Bandwidth Value in Gbps for a Flow Policy
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmFlowPolicyTable": {
    "children": [
      {
        "nbmFlowPolicyDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmFlowPolicy": {
                "attributes": {
                  "bw": "12",
                  "bwUnit": "GBPS",
                  "name": "POL_1"
}}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <flowpolicytable-items>
        <dom-items>
          <FlowPolicyDom-list>
            <name>default</name>
            <name-items>
              <FlowPolicy-list>
                <name>POL_1</name>
                <bw>12</bw>
                <bwUnit>GBPS</bwUnit>
              </FlowPolicy-list>
            </name-items>
          </FlowPolicyDom-list>
        </dom-items>
      </flowpolicytable-items>
    </conf-items>
  </nbm-items>
</System>


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-policy
 policy POL_1
  bandwidth 12 gbps

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmFlowPolicyTable sys/nbm/conf/flowpolicytable
nbmFlowPolicyDom sys/nbm/conf/flowpolicytable/dom-{name}
nbmFlowPolicy sys/nbm/conf/flowpolicytable/dom-{name}/name-{name}


nbmFlowPolicyDom Properties

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


nbmFlowPolicy Properties

The following table contains information about the nbmFlowPolicy 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 NameData TypeDescriptionValues
bwscalar:Uint64
Flow bandwidth.RANGE: [0, 18446744073709551615]
bwUnitnbm:nbmBwUnitEn
(scalar:Enum8)
bandwidth units - Mbps, Kbps, or GbpsSELECTION:
0 - UNSPECIFIED
1 - KBPS
2 - MBPS
3 - GBPS
DEFAULT: KBPS
namestring:Basic
Flow Policy Name String.
Must be an alphanumerical string of max size 63
A sequence of characters


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

Configuring DSCP for a Custom Flow Policy

Configuring DSCP for a Custom Flow Policy
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmFlowPolicyTable": {
    "children": [
      {
        "nbmFlowPolicyDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmFlowPolicy": {
                "attributes": {
                  "dscp": "10",
                  "name": "POL_1"
}}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <flowpolicytable-items>
        <dom-items>
          <FlowPolicyDom-list>
            <name>default</name>
            <name-items>
              <FlowPolicy-list>
                <name>POL_1</name>
                <dscp>10</dscp>
              </FlowPolicy-list>
            </name-items>
          </FlowPolicyDom-list>
        </dom-items>
      </flowpolicytable-items>
    </conf-items>
  </nbm-items>
</System>

The default DSCP value is 0.


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-policy
 policy POL_1
  dscp 10

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmFlowPolicyTable sys/nbm/conf/flowpolicytable
nbmFlowPolicyDom sys/nbm/conf/flowpolicytable/dom-{name}
nbmFlowPolicy sys/nbm/conf/flowpolicytable/dom-{name}/name-{name}


nbmFlowPolicyDom Properties

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


nbmFlowPolicy Properties

The following table contains information about the nbmFlowPolicy 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 NameData TypeDescriptionValues
dscpscalar:Uint32
DSCP value for the flow.
RANGE: [0 , 63]
DEFAULT: 0
namestring:Basic
Flow Policy Name String.
Must be an alphanumerical string of max size 63
A sequence of characters


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 a DSCP Configuration for a Custom Flow Policy

Deleting a DSCP Configuration for a Custom Flow Policy
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
"nbmFlowPolicyTable": {
  "children": [
    {
      "nbmFlowPolicyDom": {
        "attributes": {
          "name": "default"
        },
        "children": [
          {
            "nbmFlowPolicy": {
              "attributes": {
                "dscp": "0",
                "name": "POL_1"
}}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <flowpolicytable-items>
        <dom-items>
          <FlowPolicyDom-list>
            <name>default</name>
            <name-items>
              <FlowPolicy-list>
                <name>POL_1</name>
                <dscp>0</dscp>
              </FlowPolicy-list>
            </name-items>
          </FlowPolicyDom-list>
        </dom-items>
      </flowpolicytable-items>
    </conf-items>
  </nbm-items>
</System>

The default DSCP value is 0.


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-policy
 policy POL_1
  no dscp

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmFlowPolicyTable sys/nbm/conf/flowpolicytable
nbmFlowPolicyDom sys/nbm/conf/flowpolicytable/dom-{name}
nbmFlowPolicy sys/nbm/conf/flowpolicytable/dom-{name}/name-{name}


nbmFlowPolicyDom Properties

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


nbmFlowPolicy Properties

The following table contains information about the nbmFlowPolicy 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 NameData TypeDescriptionValues
dscpscalar:Uint32
DSCP value for the flow.
RANGE: [0 , 63]
DEFAULT: 0
namestring:Basic
Flow Policy Name String.
Must be an alphanumerical string of max size 63
A sequence of characters


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 Bandwidth for a Custom Flow Policy

Deleting Bandwidth for a Custom Flow Policy
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmFlowPolicyTable": {
    "children": [
      {
        "nbmFlowPolicyDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmFlowPolicy": {
                "attributes": {
                  "bw": "0",
                  "bwUnit": "KBPS",
                  "name": "POL_1"
}}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <flowpolicytable-items>
        <dom-items>
          <FlowPolicyDom-list>
            <name>default</name>
            <name-items>
              <FlowPolicy-list>
                <name>POL_1</name>
                <bw>0</bw>
                <bwUnit>KBPS</bwUnit>
              </FlowPolicy-list>
            </name-items>
          </FlowPolicyDom-list>
        </dom-items>
      </flowpolicytable-items>
    </conf-items>
  </nbm-items>
</System>


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-policy
 policy POL_1
  no bandwidth

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmFlowPolicyTable sys/nbm/conf/flowpolicytable
nbmFlowPolicyDom sys/nbm/conf/flowpolicytable/dom-{name}
nbmFlowPolicy sys/nbm/conf/flowpolicytable/dom-{name}/name-{name}


nbmFlowPolicyDom Properties

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


nbmFlowPolicy Properties

The following table contains information about the nbmFlowPolicy 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 NameData TypeDescriptionValues
bwscalar:Uint64
Flow bandwidth.RANGE: [0, 18446744073709551615]
bwUnitnbm:nbmBwUnitEn
(scalar:Enum8)
bandwidth units - Mbps, Kbps, or GbpsSELECTION:
0 - UNSPECIFIED
1 - KBPS
2 - MBPS
3 - GBPS
DEFAULT: KBPS
namestring:Basic
Flow Policy Name String.
Must be an alphanumerical string of max size 63
A sequence of characters


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

Configuring the Default Host Admission Permit Policy for Senders

Configuring the Default Host Admission Permit Policy for Senders
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmGlobalConf": {
    "children": [
      {
        "nbmGlobalConfDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmGlobalConfig": {
                "attributes": {
                  "defaultSenderHostPolicy": "ALLOWED"
}}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <global-items>
        <dom-items>
          <GlobalConfDom-list>
            <name>default</name>
            <global-items>
              <defaultSenderHostPolicy>ALLOWED</defaultSenderHostPolicy>
            </global-items>
          </GlobalConfDom-list>
        </dom-items>
      </global-items>
    </conf-items>
  </nbm-items>
</System>

The default value is "ALLOWED."


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 host-policy
 sender
  default permit

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmGlobalConf sys/nbm/conf/global
nbmGlobalConfDom sys/nbm/conf/global/dom-{name}
nbmGlobalConfig sys/nbm/conf/global/dom-{name}/global


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 NameData TypeDescriptionValues
namenaming:Name256
(string:Basic)
The name of the object.
MAX SIZE: 63


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 NameData TypeDescriptionValues
defaultSenderHostPolicynbm:nbmPermit
(scalar:Enum8)
Default Allow or Deny policy for Sender hosts.SELECTION:
0 - UNDEFINED
1 - DENIED
2 - ALLOWED
DEFAULT: ALLOWED


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

Configuring the Default Host Admission Deny Policy for Senders

Configuring the Default Host Admission Deny Policy for Senders
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmGlobalConf": {
    "children": [
      {
        "nbmGlobalConfDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmGlobalConfig": {
                "attributes": {
                  "defaultSenderHostPolicy": "DENIED"
}}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <global-items>
        <dom-items>
          <GlobalConfDom-list>
            <name>default</name>
            <global-items>
              <defaultSenderHostPolicy>DENIED</defaultSenderHostPolicy>
            </global-items>
          </GlobalConfDom-list>
        </dom-items>
      </global-items>
    </conf-items>
  </nbm-items>
</System>


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 host-policy
 sender
  default deny

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmGlobalConf sys/nbm/conf/global
nbmGlobalConfDom sys/nbm/conf/global/dom-{name}
nbmGlobalConfig sys/nbm/conf/global/dom-{name}/global


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 NameData TypeDescriptionValues
namenaming:Name256
(string:Basic)
The name of the object.
MAX SIZE: 63


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 NameData TypeDescriptionValues
defaultSenderHostPolicynbm:nbmPermit
(scalar:Enum8)
Default Allow or Deny policy for Sender hosts.SELECTION:
0 - UNDEFINED
1 - DENIED
2 - ALLOWED
DEFAULT: ALLOWED


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

Configuring the Default Host Admission Permit Policy for Receivers

Configuring the Default Host Admission Permit Policy for Receivers
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmGlobalConf": {
    "children": [
      {
        "nbmGlobalConfDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmGlobalConfig": {
                "attributes": {
                  "defaultReceiverHostPolicy": "ALLOWED"
}}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <global-items>
        <dom-items>
          <GlobalConfDom-list>
            <name>default</name>
            <global-items>
              <defaultReceiverHostPolicy>ALLOWED</defaultReceiverHostPolicy>
            </global-items>
          </GlobalConfDom-list>
        </dom-items>
      </global-items>
    </conf-items>
  </nbm-items>
</System>


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 host-policy
 receiver
  default permit

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmGlobalConf sys/nbm/conf/global
nbmGlobalConfDom sys/nbm/conf/global/dom-{name}
nbmGlobalConfig sys/nbm/conf/global/dom-{name}/global


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 NameData TypeDescriptionValues
namenaming:Name256
(string:Basic)
The name of the object.
MAX SIZE: 63


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 NameData TypeDescriptionValues
defaultReceiverHostPolicynbm:nbmPermit
(scalar:Enum8)
Default Allow or Deny policy for Receiver hosts.SELECTION:
0 - UNDEFINED
1 - DENIED
2 - ALLOWED
DEFAULT: ALLOWED


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

Configuring the Default Host Admission Deny Policy for Receivers

Configuring the Default Host Admission Deny Policy for Receivers
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmGlobalConf": {
    "children": [
      {
        "nbmGlobalConfDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmGlobalConfig": {
                "attributes": {
                  "defaultReceiverHostPolicy": "DENIED"
}}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <global-items>
        <dom-items>
          <GlobalConfDom-list>
            <name>default</name>
            <global-items>
              <defaultReceiverHostPolicy>DENIED</defaultReceiverHostPolicy>
            </global-items>
          </GlobalConfDom-list>
        </dom-items>
      </global-items>
    </conf-items>
  </nbm-items>
</System>


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 host-policy
 receiver
  default deny

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmGlobalConf sys/nbm/conf/global
nbmGlobalConfDom sys/nbm/conf/global/dom-{name}
nbmGlobalConfig sys/nbm/conf/global/dom-{name}/global


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 NameData TypeDescriptionValues
namenaming:Name256
(string:Basic)
The name of the object.
MAX SIZE: 63


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 NameData TypeDescriptionValues
defaultReceiverHostPolicynbm:nbmPermit
(scalar:Enum8)
Default Allow or Deny policy for Receiver hosts.SELECTION:
0 - UNDEFINED
1 - DENIED
2 - ALLOWED
DEFAULT: ALLOWED


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

Configuring the Default Host Admission Permit Policy for an External Receiver

Configuring the Default Host Admission Permit Policy for an External Receiver
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmGlobalConf": {
    "children": [
      {
        "nbmGlobalConfDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmGlobalConfig": {
                "attributes": {
                  "defaultPimHostPolicy": "ALLOWED"
}}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <global-items>
        <dom-items>
          <GlobalConfDom-list>
            <name>default</name>
            <global-items>
              <defaultPimHostPolicy>ALLOWED</defaultPimHostPolicy>
            </global-items>
          </GlobalConfDom-list>
        </dom-items>
      </global-items>
    </conf-items>
  </nbm-items>
</System>


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 host-policy
 pim
  default permit

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmGlobalConf sys/nbm/conf/global
nbmGlobalConfDom sys/nbm/conf/global/dom-{name}
nbmGlobalConfig sys/nbm/conf/global/dom-{name}/global


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 NameData TypeDescriptionValues
namenaming:Name256
(string:Basic)
The name of the object.
MAX SIZE: 63


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 NameData TypeDescriptionValues
defaultPimHostPolicynbm:nbmPermit
(scalar:Enum8)
Default Allow or Deny policy for PIM groups.SELECTION:
0 - UNDEFINED
1 - DENIED
2 - ALLOWED
DEFAULT: ALLOWED


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

Configuring the Default Host Admission Deny Policy for an External Receiver

Configuring the Default Host Admission Deny Policy for an External Receiver
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmGlobalConf": {
    "children": [
      {
        "nbmGlobalConfDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmGlobalConfig": {
                "attributes": {
                  "defaultPimHostPolicy": "DENIED"
}}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <global-items>
        <dom-items>
          <GlobalConfDom-list>
            <name>default</name>
            <global-items>
              <defaultPimHostPolicy>DENIED</defaultPimHostPolicy>
            </global-items>
          </GlobalConfDom-list>
        </dom-items>
      </global-items>
    </conf-items>
  </nbm-items>
</System>


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 host-policy
 pim
  default deny

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmGlobalConf sys/nbm/conf/global
nbmGlobalConfDom sys/nbm/conf/global/dom-{name}
nbmGlobalConfig sys/nbm/conf/global/dom-{name}/global


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 NameData TypeDescriptionValues
namenaming:Name256
(string:Basic)
The name of the object.
MAX SIZE: 63


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 NameData TypeDescriptionValues
defaultPimHostPolicynbm:nbmPermit
(scalar:Enum8)
Default Allow or Deny policy for PIM groups.SELECTION:
0 - UNDEFINED
1 - DENIED
2 - ALLOWED
DEFAULT: ALLOWED


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

Configuring a Custom Host Admission Permit Policy for the Group Range of a Sender

Configuring a Custom Host Admission Permit Policy for the Group Range of a Sender
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
"nbmHostPolicyTable": {
  "children": [
    {
      "nbmHostPolicyDom": {
        "attributes": {
          "name": "default"
        },
        "children": [
          {
            "nbmSenderHostPolicyTable": {
              "children": [
                {
                  "nbmSenderHostPolicy": {
                    "attributes": {
                      "group": "232.1.0.0",
                      "groupMask": "16",
                      "host": "1.1.1.1",
                      "permission": "ALLOWED",
                      "seqNum": "10"
}}}]}}]}}]}}
{
    imdata:[]
}
default 10 232.1.0.0 16 1.1.1.1 ALLOWED ```


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 host-policy
 sender
  default permit
  10 host 1.1.1.1 group 232.1.0.0/16 permit

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmHostPolicyTable sys/nbm/conf/hostpolicytable
nbmHostPolicyDom sys/nbm/conf/hostpolicytable/dom-{name}
nbmSenderHostPolicyTable sys/nbm/conf/hostpolicytable/dom-{name}/sender
nbmSenderHostPolicy sys/nbm/conf/hostpolicytable/dom-{name}/sender/seq-{seqNum}


nbmHostPolicyDom Properties

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


nbmSenderHostPolicy Properties

The following table contains information about the nbmSenderHostPolicy 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 NameData TypeDescriptionValues
groupnbm:nbmMcastIpAddr
(address:Ip)
Multicast Group
Multicast Group Range IP only.
Value must match ipv4 or ipv6 known format
groupMasknbm:nbmIpMask
(scalar:Uint16)
Group Mask as integer
IP Addr mask between 0 and 32
RANGE: [0 , 32]
hostnbm:nbmIpAddr
(address:Ip)
Host IP Address
Non-Multicast Group Range IP only.
Value must match ipv4 or ipv6 known format
permissionnbm:nbmPermit
(scalar:Enum8)
Is the given policy to Allow or Deny a host
ALLOWED or DENIED.
SELECTION:
0 - UNDEFINED
1 - DENIED
2 - ALLOWED
DEFAULT: DENIED
seqNumnbm:nbmHostPolicySeq
(scalar:Uint32)
Unique Sequence Number for Policies
1-19999999
RANGE: [1 , 19999999]


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

Configuring a Custom Host Admission Deny Policy for the Group Range of a Sender

Configuring a Custom Host Admission Deny Policy for the Group Range of a Sender
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
                    
{
"nbmHostPolicyTable": {
  "children": [
    {
      "nbmHostPolicyDom": {
        "attributes": {
          "name": "default"
        },
        "children": [
          {
            "nbmSenderHostPolicyTable": {
              "children": [
                {
                  "nbmSenderHostPolicy": {
                    "attributes": {
                      "group": "232.1.0.0",
                      "groupMask": "16",
                      "host": "1.1.1.1",
                      "permission": "DENIED",
                      "seqNum": "10"
}}}]}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <hostpolicytable-items>
        <dom-items>
          <HostPolicyDom-list>
            <name>default</name>
            <receiver-items>
              <seq-items>
                <ReceiverHostPolicy-list>
                  <seqNum>123</seqNum>
                  <group>237.1.1.0</group>
                  <groupMask>24</groupMask>
                  <host>1.2.3.4</host>
                  <permission>DENIED</permission>
                  <source>1.2.3.4</source>
                </ReceiverHostPolicy-list>
              </seq-items>
            </receiver-items>
          </HostPolicyDom-list>
        </dom-items>
      </hostpolicytable-items>
    </conf-items>
  </nbm-items>
</System>


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 host-policy
 sender
  10 host 1.1.1.1 group 232.1.0.0/16 deny

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmHostPolicyTable sys/nbm/conf/hostpolicytable
nbmHostPolicyDom sys/nbm/conf/hostpolicytable/dom-{name}
nbmSenderHostPolicyTable sys/nbm/conf/hostpolicytable/dom-{name}/sender
nbmSenderHostPolicy sys/nbm/conf/hostpolicytable/dom-{name}/sender/seq-{seqNum}


nbmHostPolicyDom Properties

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


nbmSenderHostPolicy Properties

The following table contains information about the nbmSenderHostPolicy 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 NameData TypeDescriptionValues
groupnbm:nbmMcastIpAddr
(address:Ip)
Multicast Group
Multicast Group Range IP only.
Value must match ipv4 or ipv6 known format
groupMasknbm:nbmIpMask
(scalar:Uint16)
Group Mask as integer
IP Addr mask between 0 and 32
RANGE: [0 , 32]
hostnbm:nbmIpAddr
(address:Ip)
Host IP Address
Non-Multicast Group Range IP only.
Value must match ipv4 or ipv6 known format
permissionnbm:nbmPermit
(scalar:Enum8)
Is the given policy to Allow or Deny a host
ALLOWED or DENIED.
SELECTION:
0 - UNDEFINED
1 - DENIED
2 - ALLOWED
DEFAULT: DENIED
seqNumnbm:nbmHostPolicySeq
(scalar:Uint32)
Unique Sequence Number for Policies
1-19999999
RANGE: [1 , 19999999]


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 a Custom Host Admission Policy for Senders

Deleting a Custom Host Admission Policy for Senders
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
"nbmHostPolicyTable": {
  "children": [
    {
      "nbmHostPolicyDom": {
        "attributes": {
          "name": "default"
        },
        "children": [
          {
            "nbmSenderHostPolicyTable": {
              "attributes": {
                "status": "deleted"
}}}]}}]}}
{
    imdata:[]
}
default ```


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 host-policy
 no sender

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmHostPolicyTable sys/nbm/conf/hostpolicytable
nbmHostPolicyDom sys/nbm/conf/hostpolicytable/dom-{name}
nbmSenderHostPolicyTable sys/nbm/conf/hostpolicytable/dom-{name}/sender


nbmHostPolicyDom Properties

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


nbmSenderHostPolicyTable Properties

The following table contains information about the nbmSenderHostPolicyTable 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 NameData TypeDescriptionValues
statusmo:ModificationStatus
(scalar:Bitmask32)
The upgrade status. This property is for internal use only.SELECTION:
2 - created
4 - modified
8 - deleted
16 - replaced


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

Configuring a Custom Host Admission Permit Policy for the Group Range of a Local Receiver

Configuring a Custom Host Admission Permit Policy for the Group Range of a Local Receiver
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmHostPolicyTable": {
    "children": [
      {
        "nbmHostPolicyDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmReceiverHostPolicyTable": {
                "children": [
                  {
                    "nbmReceiverHostPolicy": {
                      "attributes": {
                        "group": "237.1.1.0",
                        "groupMask": "24",
                        "host": "1.2.3.4",
                        "permission": "ALLOWED",
                        "seqNum": "123",
                        "source": "1.2.3.4"
}}}]}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <hostpolicytable-items>
        <dom-items>
          <HostPolicyDom-list>
            <name>default</name>
            <receiver-items>
              <seq-items>
                <ReceiverHostPolicy-list>
                  <seqNum>123</seqNum>
                  <group>237.1.1.0</group>
                  <groupMask>24</groupMask>
                  <host>1.2.3.4</host>
                  <permission>ALLOWED</permission>
                  <source>1.2.3.4</source>
                </ReceiverHostPolicy-list>
              </seq-items>
            </receiver-items>
          </HostPolicyDom-list>
        </dom-items>
      </hostpolicytable-items>
    </conf-items>
  </nbm-items>
</System>


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 host-policy
 receiver
  123 host 1.2.3.4 source 1.2.3.4 group 237.1.1.0/24 permit

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmHostPolicyTable sys/nbm/conf/hostpolicytable
nbmHostPolicyDom sys/nbm/conf/hostpolicytable/dom-{name}
nbmReceiverHostPolicyTable sys/nbm/conf/hostpolicytable/dom-{name}/receiver
nbmReceiverHostPolicy sys/nbm/conf/hostpolicytable/dom-{name}/receiver/seq-{seqNum}


nbmHostPolicyDom Properties

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


nbmReceiverHostPolicy Properties

The following table contains information about the nbmReceiverHostPolicy 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 NameData TypeDescriptionValues
groupnbm:nbmMcastIpAddr
(address:Ip)
Multicast Group
Multicast Group Range IP only
Value must match ipv4 or ipv6 known format
groupMasknbm:nbmIpMask
(scalar:Uint16)
Group Mask as integer
IP Addr mask between 0 and 32
RANGE: [0 , 32]
hostnbm:nbmIpAddr
(address:Ip)
Host IP Address
Non-Multicast Group Range IP only
Value must match ipv4 or ipv6 known format
permissionnbm:nbmPermit
(scalar:Enum8)
Is the given policy to Allow or Deny a host
ALLOWED or DENIED
SELECTION:
0 - UNDEFINED
1 - DENIED
2 - ALLOWED
DEFAULT: DENIED
seqNumnbm:nbmHostPolicySeq
(scalar:Uint32)
Unique Sequence Number for Policies
1-19999999
RANGE: [1 , 19999999]
sourcenbm:nbmIpAddr
(address:Ip)
Host IP AddressValue must match ipv4 or ipv6 known format


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

Configuring a Custom Host Admission Deny Policy for the Group Range of a Local Receiver

Configuring a Custom Host Admission Deny Policy for the Group Range of a Local Receiver
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmHostPolicyTable": {
    "children": [
      {
        "nbmHostPolicyDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmReceiverHostPolicyTable": {
                "children": [
                  {
                    "nbmReceiverHostPolicy": {
                      "attributes": {
                        "group": "237.1.1.0",
                        "groupMask": "24",
                        "host": "1.2.3.4",
                        "permission": "DENIED",
                        "seqNum": "123",
                        "source": "1.2.3.4"
}}}]}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <hostpolicytable-items>
        <dom-items>
          <HostPolicyDom-list>
            <name>default</name>
            <receiver-items>
              <seq-items>
                <ReceiverHostPolicy-list>
                  <seqNum>123</seqNum>
                  <group>237.1.1.0</group>
                  <groupMask>24</groupMask>
                  <host>1.2.3.4</host>
                  <permission>DENIED</permission>
                  <source>1.2.3.4</source>
                </ReceiverHostPolicy-list>
              </seq-items>
            </receiver-items>
          </HostPolicyDom-list>
        </dom-items>
      </hostpolicytable-items>
    </conf-items>
  </nbm-items>
</System>


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 host-policy
 receiver
  123 host 1.2.3.4 source 1.2.3.4 group 237.1.1.0/24 deny

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmHostPolicyTable sys/nbm/conf/hostpolicytable
nbmHostPolicyDom sys/nbm/conf/hostpolicytable/dom-{name}
nbmReceiverHostPolicyTable sys/nbm/conf/hostpolicytable/dom-{name}/receiver
nbmReceiverHostPolicy sys/nbm/conf/hostpolicytable/dom-{name}/receiver/seq-{seqNum}


nbmHostPolicyDom Properties

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


nbmReceiverHostPolicy Properties

The following table contains information about the nbmReceiverHostPolicy 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 NameData TypeDescriptionValues
groupnbm:nbmMcastIpAddr
(address:Ip)
Multicast Group
Multicast Group Range IP only
Value must match ipv4 or ipv6 known format
groupMasknbm:nbmIpMask
(scalar:Uint16)
Group Mask as integer
IP Addr mask between 0 and 32
RANGE: [0 , 32]
hostnbm:nbmIpAddr
(address:Ip)
Host IP Address
Non-Multicast Group Range IP only
Value must match ipv4 or ipv6 known format
permissionnbm:nbmPermit
(scalar:Enum8)
Is the given policy to Allow or Deny a host
ALLOWED or DENIED
SELECTION:
0 - UNDEFINED
1 - DENIED
2 - ALLOWED
DEFAULT: DENIED
seqNumnbm:nbmHostPolicySeq
(scalar:Uint32)
Unique Sequence Number for Policies
1-19999999
RANGE: [1 , 19999999]
sourcenbm:nbmIpAddr
(address:Ip)
Host IP AddressValue must match ipv4 or ipv6 known format


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 a Custom Host Admission Policy for a Local Receiver

Deleting a Custom Host Admission Policy for a Local Receiver
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmHostPolicyTable": {
    "children": [
      {
        "nbmHostPolicyDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmReceiverHostPolicyTable": {
                "attributes": {
                  "status": "deleted"
}}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <hostpolicytable-items>
        <dom-items>
          <HostPolicyDom-list>
            <name>default</name>
            <receiver-items xc:operation="delete">
            </receiver-items>
          </HostPolicyDom-list>
        </dom-items>
      </hostpolicytable-items>
    </conf-items>
  </nbm-items>
</System>


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 host-policy
 no receiver

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmHostPolicyTable sys/nbm/conf/hostpolicytable
nbmHostPolicyDom sys/nbm/conf/hostpolicytable/dom-{name}
nbmReceiverHostPolicyTable sys/nbm/conf/hostpolicytable/dom-{name}/receiver


nbmHostPolicyDom Properties

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


nbmReceiverHostPolicyTable Properties

The following table contains information about the nbmReceiverHostPolicyTable 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 NameData TypeDescriptionValues
statusmo:ModificationStatus
(scalar:Bitmask32)
The upgrade status. This property is for internal use only.SELECTION:
2 - created
4 - modified
8 - deleted
16 - replaced


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

Configuring a Custom Host Admission Permit Policy for an External Receiver Group Range

Configuring a Custom Host Admission Permit Policy for an External Receiver Group Range
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmHostPolicyTable": {
    "children": [
      {
        "nbmHostPolicyDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmPimHostPolicyTable": {
                "children": [
                  {
                    "nbmPimHostPolicy": {
                      "attributes": {
                        "group": "237.1.1.0",
                        "groupMask": "24",
                        "permission": "ALLOWED",
                        "seqNum": "123",
                        "source": "1.2.3.4"
}}}]}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <hostpolicytable-items>
        <dom-items>
          <HostPolicyDom-list>
            <name>default</name>
            <pim-items>
              <seq-items>
                <PimHostPolicy-list>
                  <seqNum>123</seqNum>
                  <group>237.1.1.0</group>
                  <groupMask>24</groupMask>
                  <permission>ALLOWED</permission>
                  <source>1.2.3.4</source>
                </PimHostPolicy-list>
              </seq-items>
            </pim-items>
          </HostPolicyDom-list>
        </dom-items>
      </hostpolicytable-items>
    </conf-items>
  </nbm-items>
</System>


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 host-policy
 pim
  123 source 1.2.3.4 group 237.1.1.0/24 permit

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmHostPolicyTable sys/nbm/conf/hostpolicytable
nbmHostPolicyDom sys/nbm/conf/hostpolicytable/dom-{name}
nbmPimHostPolicyTable sys/nbm/conf/hostpolicytable/dom-{name}/pim
nbmPimHostPolicy sys/nbm/conf/hostpolicytable/dom-{name}/pim/seq-{seqNum}


nbmHostPolicyDom Properties

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


nbmPimHostPolicy Properties

The following table contains information about the nbmPimHostPolicy 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 NameData TypeDescriptionValues
groupnbm:nbmMcastIpAddr
(address:Ip)
Multicast Group
Multicast Group Range IP only
Value must match ipv4 or ipv6 known format
groupMasknbm:nbmIpMask
(scalar:Uint16)
Group Mask as integer
IP Addr mask between 0 and 32
RANGE: [0 , 32]
permissionnbm:nbmPermit
(scalar:Enum8)
Is the given policy to Allow or Deny a host
ALLOWED or DENIED
SELECTION:
0 - UNDEFINED
1 - DENIED
2 - ALLOWED
DEFAULT: DENIED
seqNumnbm:nbmHostPolicySeq
(scalar:Uint32)
Unique Sequence Number for Policies
1-19999999
RANGE: [1 , 19999999]
sourcenbm:nbmIpAddr
(address:Ip)
Host IP AddressValue must match ipv4 or ipv6 known format


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

Configuring a Custom Host Admission Deny Policy for an External Receiver Group Range

Configuring a Custom Host Admission Deny Policy for an External Receiver Group Range
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmHostPolicyTable": {
    "children": [
      {
        "nbmHostPolicyDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmPimHostPolicyTable": {
                "children": [
                  {
                    "nbmPimHostPolicy": {
                      "attributes": {
                        "group": "237.1.1.0",
                        "groupMask": "24",
                        "permission": "DENIED",
                        "seqNum": "123",
                        "source": "1.2.3.4"
}}}]}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <hostpolicytable-items>
        <dom-items>
          <HostPolicyDom-list>
            <name>default</name>
            <pim-items>
              <seq-items>
                <PimHostPolicy-list>
                  <seqNum>123</seqNum>
                  <group>237.1.1.0</group>
                  <groupMask>24</groupMask>
                  <permission>DENIED</permission>
                  <source>1.2.3.4</source>
                </PimHostPolicy-list>
              </seq-items>
            </pim-items>
          </HostPolicyDom-list>
        </dom-items>
      </hostpolicytable-items>
    </conf-items>
  </nbm-items>
</System>


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 host-policy
 pim
  123 source 1.2.3.4 group 237.1.1.0/24 deny

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmHostPolicyTable sys/nbm/conf/hostpolicytable
nbmHostPolicyDom sys/nbm/conf/hostpolicytable/dom-{name}
nbmPimHostPolicyTable sys/nbm/conf/hostpolicytable/dom-{name}/pim
nbmPimHostPolicy sys/nbm/conf/hostpolicytable/dom-{name}/pim/seq-{seqNum}


nbmHostPolicyDom Properties

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


nbmPimHostPolicy Properties

The following table contains information about the nbmPimHostPolicy 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 NameData TypeDescriptionValues
groupnbm:nbmMcastIpAddr
(address:Ip)
Multicast Group
Multicast Group Range IP only
Value must match ipv4 or ipv6 known format
groupMasknbm:nbmIpMask
(scalar:Uint16)
Group Mask as integer
IP Addr mask between 0 and 32
RANGE: [0 , 32]
permissionnbm:nbmPermit
(scalar:Enum8)
Is the given policy to Allow or Deny a host
ALLOWED or DENIED
SELECTION:
0 - UNDEFINED
1 - DENIED
2 - ALLOWED
DEFAULT: DENIED
seqNumnbm:nbmHostPolicySeq
(scalar:Uint32)
Unique Sequence Number for Policies
1-19999999
RANGE: [1 , 19999999]
sourcenbm:nbmIpAddr
(address:Ip)
Host IP AddressValue must match ipv4 or ipv6 known format


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 a Custom Host Admission Policy for an External Receiver

Deleting a Custom Host Admission Policy for an External Receiver
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf.json
{
  "nbmHostPolicyTable": {
    "children": [
      {
        "nbmHostPolicyDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmPimHostPolicyTable": {
                "attributes": {
                  "status": "deleted"
}}}]}}]}}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <hostpolicytable-items>
        <dom-items>
          <HostPolicyDom-list>
            <name>default</name>
            <pim-items xc:operation="delete">
            </pim-items>
          </HostPolicyDom-list>
        </dom-items>
      </hostpolicytable-items>
    </conf-items>
  </nbm-items>
</System>


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 host-policy
 no pim

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmHostPolicyTable sys/nbm/conf/hostpolicytable
nbmHostPolicyDom sys/nbm/conf/hostpolicytable/dom-{name}
nbmPimHostPolicyTable sys/nbm/conf/hostpolicytable/dom-{name}/pim


nbmHostPolicyDom Properties

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


nbmPimHostPolicyTable Properties

The following table contains information about the nbmPimHostPolicyTable 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 NameData TypeDescriptionValues
statusmo:ModificationStatus
(scalar:Bitmask32)
The upgrade status. This property is for internal use only.SELECTION:
2 - created
4 - modified
8 - deleted
16 - replaced


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

Configuring the Flow Rate Limiter Installed in the Hardware

Configuring the Flow Rate Limiter Installed in the Hardware 
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf/global.json
{
  "nbmGlobalConf": {
    "children": [
      {
        "nbmGlobalConfDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmGlobalConfig": {
                "attributes": {
                  "defaultFlowPolicer": "ENABLED"
                }
              }
            }
          ]
        }
      }
    ]
  }
}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <global-items>
        <dom-items>
          <GlobalConfDom-list>
            <name>default</name>
            <global-items>
              <defaultFlowPolicer>ENABLED</defaultFlowPolicer>
            </global-items>
          </GlobalConfDom-list>
        </dom-items>
      </global-items>
    </conf-items>
  </nbm-items>
</System>

Note: This example was added in Release 9.2(3).


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 policer

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmGlobalConf sys/nbm/conf/global
nbmGlobalConfDom sys/nbm/conf/global/dom-{name}
nbmGlobalConfig sys/nbm/conf/global/dom-{name}/global


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 NameData TypeDescriptionValues
namenaming:Name256
(string:Basic)
The name of the object.
MAX SIZE: 63


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 NameData TypeDescriptionValues
defaultFlowPolicernbm:nbmFlowPolicerEn
(scalar:Enum8)
Enable or Disable Policer for default Flow PolicySELECTION:
0 - DISABLED
1 - ENABLED
DEFAULT: ENABLED


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 the Flow Rate Limiter Installed in the Hardware

Deleting the Flow Rate Limiter Installed in the Hardware 
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf/global.json
{
  "nbmGlobalConf": {
    "children": [
      {
        "nbmGlobalConfDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmGlobalConfig": {
                "attributes": {
                  "defaultFlowPolicer": "DISABLED"
                }
              }
            }
          ]
        }
      }
    ]
  }
}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <global-items>
        <dom-items>
          <GlobalConfDom-list>
            <name>default</name>
            <global-items>
              <defaultFlowPolicer>DISABLED</defaultFlowPolicer>
            </global-items>
          </GlobalConfDom-list>
        </dom-items>
      </global-items>
    </conf-items>
  </nbm-items>
</System>

Note: This example was added in Release 9.2(3).


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.

no nbm flow policer

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmGlobalConf sys/nbm/conf/global
nbmGlobalConfDom sys/nbm/conf/global/dom-{name}
nbmGlobalConfig sys/nbm/conf/global/dom-{name}/global


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 NameData TypeDescriptionValues
namenaming:Name256
(string:Basic)
The name of the object.
MAX SIZE: 63


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 NameData TypeDescriptionValues
defaultFlowPolicernbm:nbmFlowPolicerEn
(scalar:Enum8)
Enable or Disable Policer for default Flow PolicySELECTION:
0 - DISABLED
1 - ENABLED
DEFAULT: ENABLED


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

Configuring a Multicast Flow

Configuring a Multicast Flow 
POST http://<mgmt0_IP>/api/mo/sys/nbm/show/flows/dom-default.json
{
  "nbmFlows": {
    "children": [
      {
        "nbmConfFlowsDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmConfFlow": {
                "attributes": {
                  "group": "239.255.255.255",
                  "source": "0.0.0.0"
                }
              }
            }
          ]
        }
      }
    ]
  }
}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <flows-items>
        <dom-items>
          <ConfFlowsDom-list>
            <name>default</name>
            <s-items>
              <ConfFlow-list>
                <source>0.0.0.0</source>
                <group>239.255.255.255</group>
              </ConfFlow-list>
            </s-items>
          </ConfFlowsDom-list>
        </dom-items>
      </flows-items>
    </conf-items>
  </nbm-items>
</System>

Note: This example was added in Release 9.2(3).


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-definition 239.255.255.255

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmFlows sys/nbm/conf/flows
nbmConfFlowsDom sys/nbm/conf/flows/dom-{name}
nbmConfFlow sys/nbm/conf/flows/dom-{name}/s-{[source]}-g-{[group]}


nbmConfFlowsDom Properties

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


nbmConfFlow Properties

The following table contains information about the nbmConfFlow 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 NameData TypeDescriptionValues
groupnbm:nbmIpAddr
(address:Ip)
Group being sentValue must match ipv4 or ipv6 known format
sourcenbm:nbmIpAddr
(address:Ip)
source IP AddressValue must match ipv4 or ipv6 known format


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 a Multicast Flow

Deleting a Multicast Flow 
POST http://<mgmt0_IP>/api/mo/sys/nbm/show/flows/dom-default.json
{
  "nbmFlows": {
    "children": [
      {
        "nbmConfFlowsDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmConfFlow": {
                "attributes": {
                  "group": "239.255.255.255",
                  "source": "0.0.0.0",
                  "status": "deleted"
                }
              }
            }
          ]
        }
      }
    ]
  }
}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <flows-items>
        <dom-items>
          <ConfFlowsDom-list>
            <name>default</name>
            <s-items>
              <ConfFlow-list xc:operation="delete">
                <source>0.0.0.0</source>
                <group>239.255.255.255</group>
              </ConfFlow-list>
            </s-items>
          </ConfFlowsDom-list>
        </dom-items>
      </flows-items>
    </conf-items>
  </nbm-items>
</System>

Note: This example was added in Release 9.2(3).


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.

no nbm flow-definition 239.255.255.255

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmFlows sys/nbm/conf/flows
nbmConfFlowsDom sys/nbm/conf/flows/dom-{name}
nbmConfFlow sys/nbm/conf/flows/dom-{name}/s-{[source]}-g-{[group]}


nbmConfFlowsDom Properties

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


nbmConfFlow Properties

The following table contains information about the nbmConfFlow 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 NameData TypeDescriptionValues
groupnbm:nbmIpAddr
(address:Ip)
Group being sentValue must match ipv4 or ipv6 known format
sourcenbm:nbmIpAddr
(address:Ip)
source IP AddressValue must match ipv4 or ipv6 known format
statusmo:ModificationStatus
(scalar:Bitmask32)
The upgrade status. This property is for internal use only.SELECTION:
2 - created
4 - modified
8 - deleted
16 - replaced


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

Configuring a Multicast Flow with the Source IP

Configuring a Multicast Flow with the Source IP 
POST http://<mgmt0_IP>/api/mo/sys/nbm/show/flows/dom-default.json
{
  "nbmFlows": {
    "children": [
      {
        "nbmConfFlowsDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmConfFlow": {
                "attributes": {
                  "group": "239.255.255.255",
                  "source": "1.2.3.4"
                }
              }
            }
          ]
        }
      }
    ]
  }
}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <flows-items>
        <dom-items>
          <ConfFlowsDom-list>
            <name>default</name>
            <s-items>
              <ConfFlow-list>
                <source>1.2.3.4</source>
                <group>239.255.255.255</group>
              </ConfFlow-list>
            </s-items>
          </ConfFlowsDom-list>
        </dom-items>
      </flows-items>
    </conf-items>
  </nbm-items>
</System>

Note: This example was added in Release 9.2(3).


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-definition 239.255.255.255 1.2.3.4

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmFlows sys/nbm/conf/flows
nbmConfFlowsDom sys/nbm/conf/flows/dom-{name}
nbmConfFlow sys/nbm/conf/flows/dom-{name}/s-{[source]}-g-{[group]}


nbmConfFlowsDom Properties

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


nbmConfFlow Properties

The following table contains information about the nbmConfFlow 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 NameData TypeDescriptionValues
groupnbm:nbmIpAddr
(address:Ip)
Group being sentValue must match ipv4 or ipv6 known format
sourcenbm:nbmIpAddr
(address:Ip)
source IP AddressValue must match ipv4 or ipv6 known format


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 a Multicast Flow with the Source IP

Deleting a Multicast Flow with the Source IP 
POST http://<mgmt0_IP>/api/mo/sys/nbm/show/flows/dom-default.json
{
  "nbmFlows": {
    "children": [
      {
        "nbmConfFlowsDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmConfFlow": {
                "attributes": {
                  "group": "239.255.255.255",
                  "source": "1.2.3.4",
                  "status": "deleted"
                }
              }
            }
          ]
        }
      }
    ]
  }
}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <flows-items>
        <dom-items>
          <ConfFlowsDom-list>
            <name>default</name>
            <s-items>
              <ConfFlow-list xc:operation="delete">
                <source>1.2.3.4</source>
                <group>239.255.255.255</group>
              </ConfFlow-list>
            </s-items>
          </ConfFlowsDom-list>
        </dom-items>
      </flows-items>
    </conf-items>
  </nbm-items>
</System>

Note: This example was added in Release 9.2(3).


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.

no nbm flow-definition 239.255.255.255 1.2.3.4

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmFlows sys/nbm/conf/flows
nbmConfFlowsDom sys/nbm/conf/flows/dom-{name}
nbmConfFlow sys/nbm/conf/flows/dom-{name}/s-{[source]}-g-{[group]}


nbmConfFlowsDom Properties

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


nbmConfFlow Properties

The following table contains information about the nbmConfFlow 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 NameData TypeDescriptionValues
groupnbm:nbmIpAddr
(address:Ip)
Group being sentValue must match ipv4 or ipv6 known format
sourcenbm:nbmIpAddr
(address:Ip)
source IP AddressValue must match ipv4 or ipv6 known format
statusmo:ModificationStatus
(scalar:Bitmask32)
The upgrade status. This property is for internal use only.SELECTION:
2 - created
4 - modified
8 - deleted
16 - replaced


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

Configuring the Egress Host IP for the Flow

Configuring the Egress Host IP for the Flow 
POST http://<mgmt0_IP>/api/mo/sys/nbm/show/flows/dom-default.json
{
  "nbmFlows": {
    "children": [
      {
        "nbmConfFlowsDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmConfFlow": {
                "attributes": {
                  "group": "239.255.255.255",
                  "source": "0.0.0.0"
                },
                "children": [
                  {
                    "nbmConfFlowHost": {
                      "attributes": {
                        "host": "1.2.3.4"
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      }
    ]
  }
}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <flows-items>
        <dom-items>
          <ConfFlowsDom-list>
            <name>default</name>
            <s-items>
              <ConfFlow-list>
                <source>0.0.0.0</source>
                <group>239.255.255.255</group>
                <host-items>
                  <ConfFlowHost-list>
                    <host>1.2.3.4</host>
                  </ConfFlowHost-list>
                </host-items>
              </ConfFlow-list>
            </s-items>
          </ConfFlowsDom-list>
        </dom-items>
      </flows-items>
    </conf-items>
  </nbm-items>
</System>

Note: This example was added in Release 9.2(3).


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-definition 239.255.255.255
 egress-host 1.2.3.4

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmFlows sys/nbm/conf/flows
nbmConfFlowsDom sys/nbm/conf/flows/dom-{name}
nbmConfFlow sys/nbm/conf/flows/dom-{name}/s-{[source]}-g-{[group]}
nbmConfFlowHost sys/nbm/conf/flows/dom-{name}/s-{[source]}-g-{[group]}/host-{[host]}


nbmConfFlowsDom Properties

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


nbmConfFlow Properties

The following table contains information about the nbmConfFlow 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 NameData TypeDescriptionValues
groupnbm:nbmIpAddr
(address:Ip)
Group being sentValue must match ipv4 or ipv6 known format
sourcenbm:nbmIpAddr
(address:Ip)
source IP AddressValue must match ipv4 or ipv6 known format


nbmConfFlowHost Properties

The following table contains information about the nbmConfFlowHost 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 NameData TypeDescriptionValues
hostnbm:nbmIpAddr
(address:Ip)
reporter IP Address
Non-Multicast Group Range IP only.
Value must match ipv4 or ipv6 known format


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 the Egress Host IP for the Flow

Deleting the Egress Host IP for the Flow 
POST http://<mgmt0_IP>/api/mo/sys/nbm/show/flows/dom-default.json
{
  "nbmFlows": {
    "children": [
      {
        "nbmConfFlowsDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmConfFlow": {
                "attributes": {
                  "group": "239.255.255.255",
                  "source": "0.0.0.0"
                },
                "children": [
                  {
                    "nbmConfFlowHost": {
                      "attributes": {
                        "host": "1.2.3.4",
                        "status": "deleted"
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      }
    ]
  }
}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <flows-items>
        <dom-items>
          <ConfFlowsDom-list>
            <name>default</name>
            <s-items>
              <ConfFlow-list>
                <source>0.0.0.0</source>
                <group>239.255.255.255</group>
                <host-items>
                  <ConfFlowHost-list xc:operation="delete">
                    <host>1.2.3.4</host>
                  </ConfFlowHost-list>
                </host-items>
              </ConfFlow-list>
            </s-items>
          </ConfFlowsDom-list>
        </dom-items>
      </flows-items>
    </conf-items>
  </nbm-items>
</System>

Note: This example was added in Release 9.2(3).


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-definition 239.255.255.255
 no egress-host 1.2.3.4

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmFlows sys/nbm/conf/flows
nbmConfFlowsDom sys/nbm/conf/flows/dom-{name}
nbmConfFlow sys/nbm/conf/flows/dom-{name}/s-{[source]}-g-{[group]}
nbmConfFlowHost sys/nbm/conf/flows/dom-{name}/s-{[source]}-g-{[group]}/host-{[host]}


nbmConfFlowsDom Properties

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


nbmConfFlow Properties

The following table contains information about the nbmConfFlow 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 NameData TypeDescriptionValues
groupnbm:nbmIpAddr
(address:Ip)
Group being sentValue must match ipv4 or ipv6 known format
sourcenbm:nbmIpAddr
(address:Ip)
source IP AddressValue must match ipv4 or ipv6 known format


nbmConfFlowHost Properties

The following table contains information about the nbmConfFlowHost 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 NameData TypeDescriptionValues
hostnbm:nbmIpAddr
(address:Ip)
reporter IP Address
Non-Multicast Group Range IP only.
Value must match ipv4 or ipv6 known format
statusmo:ModificationStatus
(scalar:Bitmask32)
The upgrade status. This property is for internal use only.SELECTION:
2 - created
4 - modified
8 - deleted
16 - replaced


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

Configuring the Egress Interface for the Flow

Configuring the Egress Interface for the Flow 
POST http://<mgmt0_IP>/api/mo/sys/nbm/show/flows/dom-default.json
{
  "nbmFlows": {
    "children": [
      {
        "nbmConfFlowsDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmConfFlow": {
                "attributes": {
                  "group": "239.255.255.255",
                  "source": "0.0.0.0"
                },
                "children": [
                  {
                    "nbmConfFlowIf": {
                      "attributes": {
                        "id": "eth1/2"
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      }
    ]
  }
}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <flows-items>
        <dom-items>
          <ConfFlowsDom-list>
            <name>default</name>
            <s-items>
              <ConfFlow-list>
                <source>0.0.0.0</source>
                <group>239.255.255.255</group>
                <if-items>
                  <ConfFlowIf-list>
                    <id>eth1/2</id>
                  </ConfFlowIf-list>
                </if-items>
              </ConfFlow-list>
            </s-items>
          </ConfFlowsDom-list>
        </dom-items>
      </flows-items>
    </conf-items>
  </nbm-items>
</System>

Note: This example was added in Release 9.2(3).


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-definition 239.255.255.255
 egress-interface ethernet 1/2

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmFlows sys/nbm/conf/flows
nbmConfFlowsDom sys/nbm/conf/flows/dom-{name}
nbmConfFlow sys/nbm/conf/flows/dom-{name}/s-{[source]}-g-{[group]}
nbmConfFlowIf sys/nbm/conf/flows/dom-{name}/s-{[source]}-g-{[group]}/if-{[id]}


nbmConfFlowsDom Properties

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


nbmConfFlow Properties

The following table contains information about the nbmConfFlow 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 NameData TypeDescriptionValues
groupnbm:nbmIpAddr
(address:Ip)
Group being sentValue must match ipv4 or ipv6 known format
sourcenbm:nbmIpAddr
(address:Ip)
source IP AddressValue must match ipv4 or ipv6 known format


nbmConfFlowIf Properties

The following table contains information about the nbmConfFlowIf 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 NameData TypeDescriptionValues
idnw:IfId
(base:IfIndex)
OIF InterfaceMust match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100


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 the Egress Interface for the Flow

Deleting the Egress Interface for the Flow 
POST http://<mgmt0_IP>/api/mo/sys/nbm/show/flows/dom-default.json
{
  "nbmFlows": {
    "children": [
      {
        "nbmConfFlowsDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmConfFlow": {
                "attributes": {
                  "group": "239.255.255.255",
                  "source": "0.0.0.0"
                },
                "children": [
                  {
                    "nbmConfFlowIf": {
                      "attributes": {
                        "id": "eth1/2",
                        "status": "deleted"
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      }
    ]
  }
}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <flows-items>
        <dom-items>
          <ConfFlowsDom-list>
            <name>default</name>
            <s-items>
              <ConfFlow-list>
                <source>0.0.0.0</source>
                <group>239.255.255.255</group>
                <if-items>
                  <ConfFlowIf-list xc:operation="delete">
                    <id>eth1/2</id>
                  </ConfFlowIf-list>
                </if-items>
              </ConfFlow-list>
            </s-items>
          </ConfFlowsDom-list>
        </dom-items>
      </flows-items>
    </conf-items>
  </nbm-items>
</System>

Note: This example was added in Release 9.2(3).


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-definition 239.255.255.255
 no egress-interface ethernet 1/2

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmFlows sys/nbm/conf/flows
nbmConfFlowsDom sys/nbm/conf/flows/dom-{name}
nbmConfFlow sys/nbm/conf/flows/dom-{name}/s-{[source]}-g-{[group]}
nbmConfFlowIf sys/nbm/conf/flows/dom-{name}/s-{[source]}-g-{[group]}/if-{[id]}


nbmConfFlowsDom Properties

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


nbmConfFlow Properties

The following table contains information about the nbmConfFlow 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 NameData TypeDescriptionValues
groupnbm:nbmIpAddr
(address:Ip)
Group being sentValue must match ipv4 or ipv6 known format
sourcenbm:nbmIpAddr
(address:Ip)
source IP AddressValue must match ipv4 or ipv6 known format


nbmConfFlowIf Properties

The following table contains information about the nbmConfFlowIf 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 NameData TypeDescriptionValues
idnw:IfId
(base:IfIndex)
OIF InterfaceMust match first field in the output of `show intf brief`. Example: Eth1/1 or Vlan100
statusmo:ModificationStatus
(scalar:Bitmask32)
The upgrade status. This property is for internal use only.SELECTION:
2 - created
4 - modified
8 - deleted
16 - replaced


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

Configuring the Flow on the Switch Without a Valid Egress Interface

Configuring the Flow on the Switch Without a Valid Egress Interface 
POST http://<mgmt0_IP>/api/mo/sys/nbm/show/flows/dom-default.json
{
  "nbmFlows": {
    "children": [
      {
        "nbmConfFlowsDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmConfFlow": {
                "attributes": {
                  "group": "239.255.255.255",
                  "source": "0.0.0.0"
                },
                "children": [
                  {
                    "nbmConfFlowHost": {
                      "attributes": {
                        "host": "0.0.0.0"
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      }
    ]
  }
}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <flows-items>
        <dom-items>
          <ConfFlowsDom-list>
            <name>default</name>
            <s-items>
              <ConfFlow-list>
                <source>0.0.0.0</source>
                <group>239.255.255.255</group>
                <host-items>
                  <ConfFlowHost-list>
                    <host>0.0.0.0</host>
                  </ConfFlowHost-list>
                </host-items>
              </ConfFlow-list>
            </s-items>
          </ConfFlowsDom-list>
        </dom-items>
      </flows-items>
    </conf-items>
  </nbm-items>
</System>

Note: This example was added in Release 9.2(3).


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-definition 239.255.255.255
 stage-flow

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmFlows sys/nbm/conf/flows
nbmConfFlowsDom sys/nbm/conf/flows/dom-{name}
nbmConfFlow sys/nbm/conf/flows/dom-{name}/s-{[source]}-g-{[group]}
nbmConfFlowHost sys/nbm/conf/flows/dom-{name}/s-{[source]}-g-{[group]}/host-{[host]}


nbmConfFlowsDom Properties

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


nbmConfFlow Properties

The following table contains information about the nbmConfFlow 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 NameData TypeDescriptionValues
groupnbm:nbmIpAddr
(address:Ip)
Group being sentValue must match ipv4 or ipv6 known format
sourcenbm:nbmIpAddr
(address:Ip)
source IP AddressValue must match ipv4 or ipv6 known format


nbmConfFlowHost Properties

The following table contains information about the nbmConfFlowHost 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 NameData TypeDescriptionValues
hostnbm:nbmIpAddr
(address:Ip)
reporter IP Address
Non-Multicast Group Range IP only.
Value must match ipv4 or ipv6 known format


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 the Flow on the Switch Without a Valid Egress Interface

Deleting the Flow on the Switch Without a Valid Egress Interface
POST http://<mgmt0_IP>/api/mo/sys/nbm/show/flows/dom-default.json
{
  "nbmFlows": {
    "children": [
      {
        "nbmConfFlowsDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmConfFlow": {
                "attributes": {
                  "group": "239.255.255.255",
                  "source": "0.0.0.0"
                },
                "children": [
                  {
                    "nbmConfFlowHost": {
                      "attributes": {
                        "host": "0.0.0.0",
                        "status": "deleted"
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      }
    ]
  }
}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <flows-items>
        <dom-items>
          <ConfFlowsDom-list>
            <name>default</name>
            <s-items>
              <ConfFlow-list>
                <source>0.0.0.0</source>
                <group>239.255.255.255</group>
                <host-items>
                  <ConfFlowHost-list xc:operation="delete">
                    <host>0.0.0.0</host>
                  </ConfFlowHost-list>
                </host-items>
              </ConfFlow-list>
            </s-items>
          </ConfFlowsDom-list>
        </dom-items>
      </flows-items>
    </conf-items>
  </nbm-items>
</System>

Note: This example was added in Release 9.2(3).


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-definition 239.255.255.255
 no stage-flow

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmFlows sys/nbm/conf/flows
nbmConfFlowsDom sys/nbm/conf/flows/dom-{name}
nbmConfFlow sys/nbm/conf/flows/dom-{name}/s-{[source]}-g-{[group]}
nbmConfFlowHost sys/nbm/conf/flows/dom-{name}/s-{[source]}-g-{[group]}/host-{[host]}


nbmConfFlowsDom Properties

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


nbmConfFlow Properties

The following table contains information about the nbmConfFlow 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 NameData TypeDescriptionValues
groupnbm:nbmIpAddr
(address:Ip)
Group being sentValue must match ipv4 or ipv6 known format
sourcenbm:nbmIpAddr
(address:Ip)
source IP AddressValue must match ipv4 or ipv6 known format


nbmConfFlowHost Properties

The following table contains information about the nbmConfFlowHost 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 NameData TypeDescriptionValues
hostnbm:nbmIpAddr
(address:Ip)
reporter IP Address
Non-Multicast Group Range IP only.
Value must match ipv4 or ipv6 known format
statusmo:ModificationStatus
(scalar:Bitmask32)
The upgrade status. This property is for internal use only.SELECTION:
2 - created
4 - modified
8 - deleted
16 - replaced


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

Configuring the Flow Rate Limiter Installed in the Hardware

Configuring the Flow Rate Limiter Installed in the Hardware 
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf/flowpolicytable.json
{
  "nbmFlowPolicyTable": {
    "children": [
      {
        "nbmFlowPolicyDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmFlowPolicy": {
                "attributes": {
                  "name": "POL_1",
                  "policer": "ENABLED"
                }
              }
            }
          ]
        }
      }
    ]
  }
}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <flowpolicytable-items>
        <dom-items>
          <FlowPolicyDom-list>
            <name>default</name>
            <name-items>
              <FlowPolicy-list>
                <name>POL_1</name>
                <policer>ENABLED</policer>
              </FlowPolicy-list>
            </name-items>
          </FlowPolicyDom-list>
        </dom-items>
      </flowpolicytable-items>
    </conf-items>
  </nbm-items>
</System>

Note: This example was added in Release 9.2(3).


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-policy
 policy POL_1
  policer

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmFlowPolicyTable sys/nbm/conf/flowpolicytable
nbmFlowPolicyDom sys/nbm/conf/flowpolicytable/dom-{name}
nbmFlowPolicy sys/nbm/conf/flowpolicytable/dom-{name}/name-{name}


nbmFlowPolicyDom Properties

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


nbmFlowPolicy Properties

The following table contains information about the nbmFlowPolicy 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 NameData TypeDescriptionValues
namestring:Basic
Flow Policy Name String.
Must be an alphanumerical string of max size 63
A sequence of characters
policernbm:nbmFlowPolicerEn
(scalar:Enum8)
Enable or Disable Policer for this Flow PolicySELECTION:
0 - DISABLED
1 - ENABLED
DEFAULT: ENABLED


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 the Flow Rate Limiter Installed in the Hardware

Deleting the Flow Rate Limiter Installed in the Hardware 
POST http://<mgmt0_IP>/api/mo/sys/nbm/conf/flowpolicytable.json
{
  "nbmFlowPolicyTable": {
    "children": [
      {
        "nbmFlowPolicyDom": {
          "attributes": {
            "name": "default"
          },
          "children": [
            {
              "nbmFlowPolicy": {
                "attributes": {
                  "name": "POL_1",
                  "policer": "DISABLED"
                }
              }
            }
          ]
        }
      }
    ]
  }
}
{
    imdata:[]
}
<System>
  <nbm-items>
    <conf-items>
      <flowpolicytable-items>
        <dom-items>
          <FlowPolicyDom-list>
            <name>default</name>
            <name-items>
              <FlowPolicy-list>
                <name>POL_1</name>
                <policer>DISABLED</policer>
              </FlowPolicy-list>
            </name-items>
          </FlowPolicyDom-list>
        </dom-items>
      </flowpolicytable-items>
    </conf-items>
  </nbm-items>
</System>

Note: This example was added in Release 9.2(3).


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-policy
 policy POL_1
  no policer

Note: The property information for this example was added in Release 9.3(3).


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.

MODN
nbmFlowPolicyTable sys/nbm/conf/flowpolicytable
nbmFlowPolicyDom sys/nbm/conf/flowpolicytable/dom-{name}
nbmFlowPolicy sys/nbm/conf/flowpolicytable/dom-{name}/name-{name}


nbmFlowPolicyDom Properties

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


nbmFlowPolicy Properties

The following table contains information about the nbmFlowPolicy 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 NameData TypeDescriptionValues
namestring:Basic
Flow Policy Name String.
Must be an alphanumerical string of max size 63
A sequence of characters
policernbm:nbmFlowPolicerEn
(scalar:Enum8)
Enable or Disable Policer for this Flow PolicySELECTION:
0 - DISABLED
1 - ENABLED
DEFAULT: ENABLED


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