IPv6 Route

IPv6 routes provide manually configured routing entries for IPv6 destination prefixes, supporting VRF-aware deployments on NX-OS for both default and non-default routing instances. Each route can specify one or more next-hop addresses with configurable preferences, tags, route names, and object tracking for conditional route installation based on reachability. IPv6 routes are commonly used for default gateway configuration, stub network reachability, and management traffic steering in dual-stack or IPv6-only network environments.

Diagram

Classes

routing (nxos.devices.configuration)

Name	Type	Constraint	Mandatory	Default Value
ipv6_routes	List	`[ipv6_routes]`	No

ipv6_routes (nxos.devices.configuration.routing)

Name	Type	Constraint	Mandatory
vrf	String		No
prefix	String		Yes
preference	Integer	min: `1`, max: `255`	No
tag	Integer	min: `0`, max: `4294967295`	No
next_hops	List	`[next_hops]`	No

next_hops (nxos.devices.configuration.routing.ipv6_routes)

Name	Type	Constraint	Mandatory
interface_type	Choice	`ethernet`, `loopback`, `mgmt`, `port-channel`, `vlan`, `vni`	No
interface_id	String		No
address	String		No
vrf	String		No
track	Integer	min: `0`, max: `4294967295`	No
preference	Integer	min: `0`, max: `255`	No
tag	Integer	min: `0`, max: `4294967295`	No
name	String		No

Examples

Example 1: IPv6 default route for management VRF

nxos:
  devices:
    - name: LEAF1
      configuration:
        routing:
          ipv6_routes:
            - vrf: management
              prefix: "::/0"
              next_hops:
                - address: "2001:db8:ffff::1"
                  name: MGMT-GW-V6

Example 2: Multiple IPv6 routes — default VRF and tenant VRF with tagged routes

nxos:
  devices:
    - name: SPINE1
      configuration:
        routing:
          ipv6_routes:
            # Default VRF — IPv6 default route
            - prefix: "::/0"
              tag: 500
              next_hops:
                - address: "2001:db8:ffff::1"
                  name: UPSTREAM-V6-GW
            # Route to IPv6 monitoring infrastructure
            - vrf: management
              prefix: "2001:db8:100::/48"
              next_hops:
                - address: "2001:db8:ffff::1"
                  name: TO-INFRA-V6

Example 3: VRF-aware IPv6 routes on a border leaf with floating backup and object tracking

nxos:
  devices:
    - name: BORDER-LEAF1
      configuration:
        routing:
          ipv6_routes:
            # Tenant VRF BLUE — dual next-hop with failover
            - vrf: BLUE
              prefix: "::/0"
              tag: 1000
              next_hops:
                - address: "2001:db8:1::1"
                  name: FW-PRIMARY-V6
                  track: 10
                - address: "2001:db8:1::2"
                  name: FW-SECONDARY-V6
                  preference: 10
                  track: 11
            # Tenant VRF GREEN — route to shared services
            - vrf: GREEN
              prefix: "2001:db8:100::/48"
              next_hops:
                - address: "2001:db8:2::1"
                  name: TO-SHARED-SVC-V6
            # Management VRF default
            - vrf: management
              prefix: "::/0"
              next_hops:
                - address: "2001:db8:ffff::1"