DHCP Commands - Cisco Nexus 9000 Series NX-API CLI Reference, Release 7(x)

show ipv6 dhcp relay

Python

Copy
import json

"""
Modify these please
"""
url='http://<IP_Address>/ins'
switchuser='<User_ID>'
switchpassword='<Password>'

myheaders={'content-type':'application/json'}
payload={
  "ins_api":{
  "version": "1.0",
  "type": "cli_show",
  "chunk": "0",
  "sid": "1",
  "input": "show ipv6 dhcp relay",
  "output_format": "json"
}

response = requests.post(url,data=json.dumps(payload), headers=myheaders,auth=(switchuser,switchpassword)).json()
output = json.dumps(response, indent=4, sort_keys=True)


{

    "ins_api": {
        "outputs": {
            "output": {
                "body": {
                    "TABLE_intf": {
                        "ROW_intf": [
                            {
                                "TABLE_addr": {
                                    "ROW_addr": {
                                        "dst_intf": "", 
                                        "relay_address": "2007:55:3:1::5", 
                                        "vrf_name": {}
                                    }
                                }, 
                                "interface-name": "Vlan552", 
                                "intf_header": "0"
                            }, 
                            {
                                "TABLE_addr": {
                                    "ROW_addr": {
                                        "dst_intf": "", 
                                        "relay_address": "2007:60:3:1::5", 
                                        "vrf_name": {}
                                    }
                                }, 
                                "interface-name": "Vlan710", 
                                "intf_header": "0"
                            }, 
                            {
                                "TABLE_addr": {
                                    "ROW_addr": {
                                        "dst_intf": "", 
                                        "relay_address": "2007:7:23::5", 
                                        "vrf_name": {}
                                    }
                                }, 
                                "interface-name": "Vlan722", 
                                "intf_header": "0"
                            }, 
                            {
                                "TABLE_addr": {
                                    "ROW_addr": {
                                        "dst_intf": "", 
                                        "relay_address": "2007:75:3:1::5", 
                                        "vrf_name": {}
                                    }
                                }, 
                                "interface-name": "Vlan752", 
                                "intf_header": "0"
                            }, 
                            {
                                "TABLE_addr": {
                                    "ROW_addr": {
                                        "dst_intf": "", 
                                        "relay_address": "2007:7:71:1::5", 
                                        "vrf_name": {}
                                    }
                                }, 
                                "interface-name": "Vlan770", 
                                "intf_header": "0"
                            }, 
                            {
                                "TABLE_addr": {
                                    "ROW_addr": {
                                        "dst_intf": "", 
                                        "relay_address": "2007:60:1:1::5", 
                                        "vrf_name": {}
                                    }
                                }, 
                                "interface-name": "port-channel60", 
                                "intf_header": "0"
                            }, 
                            {
                                "TABLE_addr": {
                                    "ROW_addr": {
                                        "dst_intf": "", 
                                        "relay_address": "2007:60:2:1::5", 
                                        "vrf_name": {}
                                    }
                                }, 
                                "interface-name": "port-channel61.1", 
                                "intf_header": "0"
                            }, 
                            {
                                "TABLE_addr": {
                                    "ROW_addr": {
                                        "dst_intf": "", 
                                        "relay_address": "2007:60:5:1::5", 
                                        "vrf_name": {}
                                    }
                                }, 
                                "interface-name": "Ethernet1/47.1", 
                                "intf_header": "0"
                            }, 
                            {
                                "TABLE_addr": {
                                    "ROW_addr": {
                                        "dst_intf": "", 
                                        "relay_address": "2007:60:0:1::5", 
                                        "vrf_name": {}
                                    }
                                }, 
                                "interface-name": "Ethernet1/48", 
                                "intf_header": "0"
                            }
                        ]
                    }, 
                    "relay_cisco_option_enable": "disabled", 
                    "relay_service_enable": "enabled", 
                    "relay_vpn_enable": "disabled"
                }, 
                "code": "200", 
                "input": "show ipv6 dhcp relay", 
                "msg": "Success"
            }
        }, 
        "sid": "eoc", 
        "type": "cli_show", 
        "version": "1.0"
    }
}

show ipv6 dhcp relay

The CLI output example below corresponds to the payload example in the code pane on the right. For more information about the show ipv6 dhcp relay command, see the CLI command reference:

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

Note: This example was added in Cisco NX-OS Release 7.0(3)I7(4).

CLI Output

CLI Output
Switch# show ipv6 dhcp relay DHCPv6 relay service : Enabled Insertion of VPN options : Disabled Insertion of CISCO options : Disabled DHCPv6 Relay is configured on the following interfaces: ------------------------------------------------------- Interface Vlan552 : Relay Address Dest. Interface VRF name ------------- --------------- -------- 2007:55:3:1::5 --- Interface Vlan710 : Relay Address Dest. Interface VRF name ------------- --------------- -------- 2007:60:3:1::5 --- Interface Vlan722 : Relay Address Dest. Interface VRF name ------------- --------------- -------- 2007:7:23::5 --- Interface Vlan752 : Relay Address Dest. Interface VRF name ------------- --------------- -------- 2007:75:3:1::5 --- Interface Vlan770 : Relay Address Dest. Interface VRF name ------------- --------------- -------- 2007:7:71:1::5 --- Interface port-channel60 : Relay Address Dest. Interface VRF name ------------- --------------- -------- 2007:60:1:1::5 --- Interface port-channel61.1 : Relay Address Dest. Interface VRF name ------------- --------------- -------- 2007:60:2:1::5 --- Interface Ethernet1/47.1 : Relay Address Dest. Interface VRF name ------------- --------------- -------- 2007:60:5:1::5 --- Interface Ethernet1/48 : Relay Address Dest. Interface VRF name ------------- --------------- -------- 2007:60:0:1::5 ---

Switch# show ipv6 dhcp relay
DHCPv6 relay service : Enabled
Insertion of VPN options : Disabled
Insertion of CISCO options : Disabled

DHCPv6 Relay is configured on the following interfaces:
-------------------------------------------------------
Interface Vlan552 :
Relay Address                            Dest. Interface   VRF name
-------------                            ---------------   --------
2007:55:3:1::5                                 ---

Interface Vlan710 :
Relay Address                            Dest. Interface   VRF name
-------------                            ---------------   --------
2007:60:3:1::5                                 ---

Interface Vlan722 :
Relay Address                            Dest. Interface   VRF name
-------------                            ---------------   --------
2007:7:23::5                                   ---

Interface Vlan752 :
Relay Address                            Dest. Interface   VRF name
-------------                            ---------------   --------
2007:75:3:1::5                                 ---

Interface Vlan770 :
Relay Address                            Dest. Interface   VRF name
-------------                            ---------------   --------
2007:7:71:1::5                                 ---

Interface port-channel60 :
Relay Address                            Dest. Interface   VRF name
-------------                            ---------------   --------
2007:60:1:1::5                                 ---

Interface port-channel61.1 :
Relay Address                            Dest. Interface   VRF name
-------------                            ---------------   --------
2007:60:2:1::5                                 ---

Interface Ethernet1/47.1 :
Relay Address                            Dest. Interface   VRF name
-------------                            ---------------   --------
2007:60:5:1::5                                 ---

Interface Ethernet1/48 :
Relay Address                            Dest. Interface   VRF name
-------------                            ---------------   --------
2007:60:0:1::5                                 ---

show ip dhcp relay address

The CLI output example below corresponds to the payload example in the code pane on the right. For more information about the show ip dhcp relay address command, see the CLI command reference:

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

Note: This example was added in Cisco NX-OS Release 7.0(3)I7(4).

CLI Output

CLI Output
`Switch# show ip dhcp relay address Interface Relay Address VRF Name ------------- ------------- -------- Vlan710 60.3.0.5 port-channel60 60.1.0.5 port-channel61.1 60.2.0.5 Ethernet1/47.1 60.5.0.5 Ethernet1/48 60.0.0.5`

Switch# show ip dhcp relay address
 Interface        Relay Address     VRF Name
 -------------    -------------     --------
 Vlan710           60.3.0.5
 port-channel60    60.1.0.5
 port-channel61.1  60.2.0.5
 Ethernet1/47.1    60.5.0.5
 Ethernet1/48      60.0.0.5

show ip dhcp relay information trusted-sources

The CLI output example below corresponds to the payload example in the code pane on the right. For more information about the show ip dhcp relay information trusted-sources command, see the CLI command reference:

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

Note: This example was added in Cisco NX-OS Release 7.0(3)I7(4).

CLI Output
`Switch# show ip dhcp relay information trusted-sources Trusted-Interface ------------------ Ethernet1/2`

show ip dhcp relay statistics

The CLI output example below corresponds to the payload example in the code pane on the right. For more information about the show ip dhcp relay statistics command, see the CLI command reference:

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

Note: This example was added in Cisco NX-OS Release 7.0(3)I7(4).

CLI Output

CLI Output
Switch# show ip dhcp relay statistics ---------------------------------------------------------------------- Message Type Rx Tx Drops ---------------------------------------------------------------------- Discover 36 36 0 Offer 31 31 0 Request() 15 15 0 Ack 15 15 0 Release() 0 0 0 Decline 0 0 0 Inform() 0 0 0 Nack 0 0 0 ---------------------------------------------------------------------- Total 97 97 0 ---------------------------------------------------------------------- DHCP L3 FWD: Total Packets Received : 0 Total Packets Forwarded : 0 Total Packets Dropped : 0 Non DHCP: Total Packets Received : 0 Total Packets Forwarded : 0 Total Packets Dropped : 0 DROP: DHCP Relay not enabled : 0 Invalid DHCP message type : 0 Interface error : 0 Tx failure towards server : 0 Tx failure towards client : 0 Unknown output interface : 0 Unknown vrf or interface for server : 0 Max hops exceeded : 0 Option 82 validation failed : 0 Packet Malformed : 0 Relay Trusted port not configured : 0 DHCP Request dropped on MCT : 0 - These counters will show correct value when switch receives DHCP request packet with destination ip as broadcast address. If request is unicast it will be HW switched

Switch# show ip dhcp relay statistics 
----------------------------------------------------------------------
Message Type             Rx              Tx           Drops
----------------------------------------------------------------------
Discover                 36              36               0
Offer                    31              31               0
Request()               15              15               0
Ack                      15              15               0
Release()                0               0               0
Decline                   0               0               0
Inform()                 0               0               0
Nack                      0               0               0
----------------------------------------------------------------------
Total                    97              97               0
----------------------------------------------------------------------

DHCP L3 FWD:
Total Packets Received                           :         0
Total Packets Forwarded                          :         0
Total Packets Dropped                            :         0
Non DHCP:
Total Packets Received                           :         0
Total Packets Forwarded                          :         0
Total Packets Dropped                            :         0
DROP:
DHCP Relay not enabled                           :         0
Invalid DHCP message type                        :         0
Interface error                                  :         0
Tx failure towards server                        :         0
Tx failure towards client                        :         0
Unknown output interface                         :         0
Unknown vrf or interface for server              :         0
Max hops exceeded                                :         0
Option 82 validation failed                      :         0
Packet Malformed                                 :         0
Relay Trusted port not configured                :         0
DHCP Request dropped on MCT                      :         0
  -  These counters will show correct value when switch 
receives DHCP request packet with destination ip as broadcast
address. If request is unicast it will be HW switched

show ip dhcp snooping

The CLI output example below corresponds to the payload example in the code pane on the right. For more information about the show ip dhcp snooping command, see the CLI command reference:

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

Note: This example was added in Cisco NX-OS Release 7.0(3)I7(4).

CLI Output

CLI Output
`Switch# show ip dhcp snooping Switch DHCP snooping is enabled DHCP snooping is configured on the following VLANs: 22,700-705 DHCP snooping is operational on the following VLANs: 700-705 Insertion of Option 82 is enabled Verification of MAC address is enabled DHCP snooping trust is configured on the following interfaces: Interface Trusted ------------ ------- Ethernet1/61 Yes`

Switch# show ip dhcp snooping
Switch DHCP snooping is enabled
DHCP snooping is configured on the following VLANs:
22,700-705
DHCP snooping is operational on the following VLANs:
700-705
Insertion of Option 82 is enabled
Verification of MAC address is enabled
DHCP snooping trust is configured on the following interfaces:
Interface             Trusted
------------          -------
Ethernet1/61          Yes

show ip dhcp snooping statistics

The CLI output example below corresponds to the payload example in the code pane on the right. For more information about the show ip dhcp snooping statistics command, see the CLI command reference:

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

Note: This example was added in Cisco NX-OS Release 7.0(3)I7(4).

CLI Output

CLI Output
Switch# show ip dhcp snooping statistics ---------------------------------------------------------------------- Message Type Rx Tx Drops ---------------------------------------------------------------------- Discover 0 0 0 Offer 0 0 0 Request 0 0 0 Ack 0 0 0 Release 0 0 0 Decline 0 0 0 Inform 0 0 0 Nack 0 0 0 ---------------------------------------------------------------------- DHCP L2 Forwarding: Total Packets Received : 0 Total Packets Forwarded : 0 Total Packets Dropped : 0 Non DHCP: Total Packets Received : 0 Total Packets Forwarded : 0 Total Packets Dropped : 0 DROP: Received on untrusted port : 0 Unknown Failure : 0 Source mac validation failed : 0 Binding entry validation Failed : 0 Invalid DHCP message type : 0 Interface error : 0 Tx over trusted port failed : 0 Trust port not configured : 0 Vlan validation failure : 0 Insertion of option 82 failed : 0 Packet Malformed : 0

Switch# show ip dhcp snooping statistics 
---------------------------------------------------------------------- 
Message Type             Rx              Tx           Drops
---------------------------------------------------------------------- 
Discover                  0               0               0
Offer                     0               0               0
Request                   0               0               0
Ack                       0               0               0
Release                   0               0               0
Decline                   0               0               0
Inform                    0               0               0
Nack                      0               0               0
---------------------------------------------------------------------- 
DHCP L2 Forwarding:
Total Packets Received                           :         0
Total Packets Forwarded                          :         0
Total Packets Dropped                            :         0
Non DHCP:
Total Packets Received                           :         0
Total Packets Forwarded                          :         0
Total Packets Dropped                            :         0
DROP:
Received on untrusted port                       :         0
Unknown Failure                                  :         0
Source mac validation failed                     :         0
Binding entry validation Failed                  :         0
Invalid DHCP message type                        :         0
Interface error                                  :         0
Tx over trusted port failed                      :         0
Trust port not configured                        :         0
Vlan validation failure                          :         0
Insertion of option 82 failed                    :         0
Packet Malformed                                 :         0

show ip dhcp status

The CLI output example below corresponds to the payload example in the code pane on the right. For more information about the show ip dhcp status command, see the CLI command reference:

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

Note: This example was added in Cisco NX-OS Release 7.0(3)I7(4).

CLI Output
`Switch# show ip dhcp status Current CLI Operation: show ip dhcp status Last CLI Operation: ipv6 nd raguard Last CLI Operation Status: SUCCESS`

show ipv6 dhcp relay

The CLI output example below corresponds to the payload example in the code pane on the right. For more information about the show ipv6 dhcp relay command, see the CLI command reference:

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

Note: This example was added in Cisco NX-OS Release 7.0(3)I7(4).

CLI Output

CLI Output
Switch# show ipv6 dhcp relay DHCPv6 relay service : Enabled Insertion of VPN options : Disabled Insertion of CISCO options : Disabled DHCPv6 Relay is configured on the following interfaces: ------------------------------------------------------- Interface Vlan552 : Relay Address Dest. Interface VRF name ------------- --------------- -------- 2007:55:3:1::5 --- Interface Vlan710 : Relay Address Dest. Interface VRF name ------------- --------------- -------- 2007:60:3:1::5 --- Interface Vlan722 : Relay Address Dest. Interface VRF name ------------- --------------- -------- 2007:7:23::5 --- Interface Vlan752 : Relay Address Dest. Interface VRF name ------------- --------------- -------- 2007:75:3:1::5 --- Interface Vlan770 : Relay Address Dest. Interface VRF name ------------- --------------- -------- 2007:7:71:1::5 --- Interface port-channel60 : Relay Address Dest. Interface VRF name ------------- --------------- -------- 2007:60:1:1::5 --- Interface port-channel61.1 : Relay Address Dest. Interface VRF name ------------- --------------- -------- 2007:60:2:1::5 --- Interface Ethernet1/47.1 : Relay Address Dest. Interface VRF name ------------- --------------- -------- 2007:60:5:1::5 --- Interface Ethernet1/48 : Relay Address Dest. Interface VRF name ------------- --------------- -------- 2007:60:0:1::5 ---

Switch# show ipv6 dhcp relay
DHCPv6 relay service : Enabled
Insertion of VPN options : Disabled
Insertion of CISCO options : Disabled

DHCPv6 Relay is configured on the following interfaces:
-------------------------------------------------------
Interface Vlan552 :
Relay Address                            Dest. Interface   VRF name
-------------                            ---------------   --------
2007:55:3:1::5                                 ---

Interface Vlan710 :
Relay Address                            Dest. Interface   VRF name
-------------                            ---------------   --------
2007:60:3:1::5                                 ---

Interface Vlan722 :
Relay Address                            Dest. Interface   VRF name
-------------                            ---------------   --------
2007:7:23::5                                   ---

Interface Vlan752 :
Relay Address                            Dest. Interface   VRF name
-------------                            ---------------   --------
2007:75:3:1::5                                 ---

Interface Vlan770 :
Relay Address                            Dest. Interface   VRF name
-------------                            ---------------   --------
2007:7:71:1::5                                 ---

Interface port-channel60 :
Relay Address                            Dest. Interface   VRF name
-------------                            ---------------   --------
2007:60:1:1::5                                 ---

Interface port-channel61.1 :
Relay Address                            Dest. Interface   VRF name
-------------                            ---------------   --------
2007:60:2:1::5                                 ---

Interface Ethernet1/47.1 :
Relay Address                            Dest. Interface   VRF name
-------------                            ---------------   --------
2007:60:5:1::5                                 ---

Interface Ethernet1/48 :
Relay Address                            Dest. Interface   VRF name
-------------                            ---------------   --------
2007:60:0:1::5                                 ---

show ipv6 dhcp relay statistics

The CLI output example below corresponds to the payload example in the code pane on the right. For more information about the show ipv6 dhcp relay statistics command, see the CLI command reference:

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

Note: This example was added in Cisco NX-OS Release 7.0(3)I7(4).

CLI Output

CLI Output
Switch# show ipv6 dhcp relay statistics ------------------------------------------------------------------------- Message Type Rx Tx Drops ------------------------------------------------------------------------- SOLICIT 48 0 0 ADVERTISE 0 35 0 REQUEST 0 0 0 CONFIRM 0 0 0 RENEW 0 0 0 REBIND 0 0 0 REPLY 0 0 0 RELEASE 0 0 0 DECLINE 0 0 0 RECONFIGURE 0 0 0 INFORMATION_REQUEST 0 0 0 RELAY_FWD 0 48 0 RELAY_REPLY 35 0 0 UNKNOWN 0 3853 0 ------------------------------------------------------------------------- Total 83 3936 0 ------------------------------------------------------------------------- DROPS: ------ DHCPv6 Relay is disabled : 0 Max hops exceeded : 0 Packet validation fails : 0 Unknown output interface : 0 Invalid VRF : 0 Option insertion failed : 0 Direct Replies (Recnfg/Adv/Reply) from server: 0 IPv6 addr not configured : 0 Interface error : 0 VPN Option Disabled : 0 IPv6 extn headers present : 0 DHCP Request dropped on MCT : 0

Switch# show ipv6 dhcp relay statistics
-------------------------------------------------------------------------
Message Type                           Rx              Tx           Drops
-------------------------------------------------------------------------
SOLICIT                                48               0               0
ADVERTISE                               0              35               0
REQUEST                                 0               0               0
CONFIRM                                 0               0               0
RENEW                                   0               0               0
REBIND                                  0               0               0
REPLY                                   0               0               0
RELEASE                                 0               0               0
DECLINE                                 0               0               0
RECONFIGURE                             0               0               0
INFORMATION_REQUEST                     0               0               0
RELAY_FWD                               0              48               0
RELAY_REPLY                            35               0               0
UNKNOWN                                 0            3853               0
-------------------------------------------------------------------------
Total                                  83            3936               0
-------------------------------------------------------------------------
DROPS:
------
DHCPv6 Relay is disabled                     :   0
Max hops exceeded                            :   0
Packet validation fails                      :   0
Unknown output interface                     :   0
Invalid VRF                                  :   0
Option insertion failed                      :   0
Direct Replies (Recnfg/Adv/Reply) from server:   0
IPv6 addr not configured                     :   0
Interface error                              :   0
VPN Option Disabled                          :   0
IPv6 extn headers present                    :   0
DHCP Request dropped on MCT                    :   0

show ipv6 raguard statistics

The CLI output example below corresponds to the payload example in the code pane on the right. For more information about the show ipv6 raguard statistics command, see the CLI command reference:

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

Note: This example was added in Cisco NX-OS Release 7.0(3)I7(4).

CLI Output
`Switch# show ipv6 raguard statistics ----------------------------------------------------- Interface Rx Drops ----------------------------------------------------- Ethernet1/1 0 0`

show ip verify source

The CLI output example below corresponds to the payload example in the code pane on the right. For more information about the show ip verify source command, see the CLI command reference:

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

Note: This example was added in Cisco NX-OS Release 7.0(3)I7(4).

CLI Output

CLI Output
Switch# show ip verify source IP source guard excluded vlans: ------------------------------------------------------ 511-515 ----------------------------------- IP source guard is enabled on the following interfaces: ------------------------------------------------------ port-channel100 port-channel130 Ethernet1/52 Ethernet1/53 IP source guard operational entries: ----------------------------------- Interface Filter-mode IP-address Mac-address Vlan ------------ ----------- ---------- -------------- ---- port-channel100 inactive-no-snoop-vlan Ethernet1/53 inactive-no-snoop-vlan

Switch# show ip verify source 
IP source guard excluded vlans:
------------------------------------------------------ 
511-515

-----------------------------------
IP source guard is enabled on the following interfaces:
------------------------------------------------------ 
        port-channel100
        port-channel130
        Ethernet1/52
        Ethernet1/53


IP source guard operational entries: 
-----------------------------------
Interface         Filter-mode             IP-address     Mac-address       Vlan
------------      -----------             ----------     --------------    ----
port-channel100   inactive-no-snoop-vlan
Ethernet1/53      inactive-no-snoop-vlan