Use this command to configure a route map to match based on the match criteria configured in an IPv6 access-list.
If you specify a non-configured IPv6 ACL name/number to match, the CLI displays an error message. Make sure the IPv6 ACL is configured before it is linked to a route-map. Actions present in IPv6 ACL configuration are applied with other actions involved in the route-map. When an IPv6 ACL referenced by a route-map is removed or rules are added or deleted from that ACL, configuration is rejected. Adding ACLs to or removing ACLs from a route-map that is attached to an interface is allowed.
When a list of IPv6 access-lists is specified in this command, if packet matches at least one of these access-list match criteria, then the corresponding set actions in route-map are applied to packet.
If there are duplicate IPv6 access-list numbers/names in this command, the duplicate configuration is ignored.
Default | No match criteria are defined by default. |
Format | match ipv6 address {access-list-number | access-list-name} […access-list-number | access-list-name] |
Mode | Route Map Configuration |
Parameter | Description |
---|---|
access-list-number | The IPv6 access-list number that identifies an access-list configured through access-list CLI configuration commands. This number is 1 to 99 for standard access list number. This number is 100 to 199 for extended access list number. |
access-list-name | The IPv6 access-list name that identifies the named IPv6 ACL. The access-list-name can be up to 31 characters in length. A maximum of four ACLs can be specified in this match clause. |
Example: Following sequence shows how to create a route-map with a match clause on an ACL number and apply that route-map on an interface.
(Routing) (Config)#ipv6 access-list acl2 (Routing) (Config-ipv6-acl)#permit ipv6 1001::1 any (Routing) (Config-ipv6-acl)#exit (Routing) (Config)#route-map rm1 permit 40 (Routing) (route-map)#match ipv6 address acl2 (Routing) (config-route-map)#set ipv6 default next-hop 2001::2 (Routing) (config)#interface 0/1 (Routing) (Interface 0/1)#ip address 10.1.1.1 255.255.255.0 (Routing) (Interface 0/1)#ipv6 policy route-map rm1
The ipv6 policy route-map rm1 command is applied to interface 0/1. All packets ingressing on 0/1 are policy-routed if a match is made as per the IPv6 access-list.
Sequence number 40 in route map rm1 is used to match all packets sourced from host 1001::1 If there is a match, and if the router has no explicit route for the packet's destination, it is sent to next-hop address 2001::2
The rest of the packets are forwarded as per normal L3 destination-based routing.