The ip extcommunity-list encapsulation basic command configures a basic encapsulation extended community filter.
The undo ip extcommunity-list encapsulation basic command deletes a basic encapsulation extended community filter.
By default, no basic encapsulation extended community filter is configured.
| Parameter | Description | Value |
|---|---|---|
| encapsulation-name |
Specifies the name of a basic encapsulation extended community filter. |
The value is a string of 1 to 51 case-sensitive characters. It cannot be comprised of only digits. If spaces are used, the string must start and end with double quotation marks ("). |
| index index-value |
Specifies the index of a basic encapsulation extended community filter. |
The value is an integer ranging from 1 to 4294967295. |
| matchMode |
Sets the matching mode of the basic encapsulation extended community filter. |
The value is an enumerated type:
|
| encapsulation-value |
Specifies the value of the basic encapsulation extended community attribute. |
The value is in the format of a 2-byte AS number:2-byte user-defined value, such as 0:100. The AS number must be 0. The user-defined value is an integer ranging from 0 to 65535. |
| basic |
Indicates the basic encapsulation extended community attribute. |
- |
Usage Scenario
To configure an encapsulation extended community filter, run the ip extcommunity-list encapsulation command. The filter can then be used to filter BGP EVPN routes that carry the encapsulation extended community attribute.
The filter can be configured as a matching condition for a route-policy using a command, such as the if-match extcommunity-list encapsulation aaa command. An encapsulation extended community filter in different formats may lead to different matching results. For example: Format 1: ip extcommunity-list encapsulation basic aaa permit 0:1 0:2 0:3 Format 2: ip extcommunity-list encapsulation basic aaa permit 0:1 ip extcommunity-list encapsulation basic aaa permit 0:2 0:3 In format 2, the encapsulation extended community attribute defined in each rule must be a sub-set of the route encapsulation extended community attribute set. Otherwise, no routes can match the rule. The undo ip extcommunity-list encapsulation command deletes the encapsulation extended community filter of a specified node.Configuration Impact
After the command is run, routes that do not match any rules of the filter are filtered out.