Device Tagging

Table 1. Feature History
Feature Name	Release Information	Description
User-Defined Device Tagging	Cisco IOS XE Catalyst SD-WAN Release 17.8.1a Cisco vManage Release 20.8.1	This feature helps you add tags to devices. You can use the tags for grouping, describing, finding, or managing devices.
Enhancements to User-Defined Device Tagging	Cisco IOS XE Catalyst SD-WAN Release 17.12.1a Cisco Catalyst SD-WAN Manager Release 20.12.1	Device tagging has the following new functionality: When you add devices to a configuration group using rules, you can choose Match All or Match Any. You can use Starts With and Ends With operator conditions when you add devices to a configuration group using rules. In addition, the button formerly called Add New Tag is now Create New Tag.

Information About Device Tagging

The Device Tagging feature helps you do the following:

Add tags to devices: Tagging helps you manage devices more effectively. You can use the tags for grouping, describing, or finding devices. You can add more than one tag to a device.
Add devices to configuration groups based on tagging: Using tags, you can create rules to define which devices need to be automatically added to a configuration group. For complete information about creating rules, see Add Devices to a Configuration Group Using Rules.

Note

You can use this feature in both the single-tenant and multitenant deployments.

This feature is supported only on Cisco IOS XE Catalyst SD-WAN devices.

Minimum software version for Cisco IOS XE Catalyst SD-WAN devices: Cisco IOS XE Catalyst SD-WAN Release 17.8.1a

Minimum software version for Cisco SD-WAN Manager: Cisco vManage Release 20.8.1

(Cisco vManage Release 20.11.1 and earlier) You can create a maximum of 25 tags in a Cisco SD-WAN Manager instance.
(Cisco vManage Release 20.11.1 and earlier) You can add a maximum of 25 tags per device.
(Cisco vManage Release 20.11.1 and earlier) The tag name can be up to 25 characters and can contain only alphanumeric characters, hyphens (–), and underscores (_).
The tag name cannot contain space or any other special characters.
The tag name is case-sensitive.
(Cisco vManage Release 20.11.1 and earlier) You can add only one tag rule to a configuration group.

You can add tags to devices in one of the following ways:

From the Cisco SD-WAN Manager menu, choose Configuration > Devices.
Click WAN Edge List and choose a device.
Click Add Tags
Choose a tag from the list of existing tags or click Create New Tag to create a new tag.

In Cisco vManage Release 20.11.1 and earlier, this was called Add New Tag.
Click Apply.

The specified tag is added to the device.

Note

You can edit the tags that are currently associated with a device by either adding new tags or removing unwanted tags.

You can delete only those tags that are not added to a device or are not a part of a tag rule.