The instances created on a cloud provider can be assigned special metadata to help manage, bill, or audit the resources.

On Amazon Web Services (AWS), they are referred to as instance tags. In the context of YugabyteDB Anywhere, these tags are known as user tags.

You can define instance tags when you create a new universe, as well as modify or delete tags of an existing universe. These tags are represented by key-value pairs under Instance Configuration > User Tags on the Create Universe or Edit Universe page, as per the following illustration:

Create instance tags

You can define the tags in any order.

Name is the only key that can have templated tags, so it can be made of different parts filled in at runtime to determine node and instance names, based on the following guidelines:

  • The parts of the template should be enclosed between ${ and }.
  • The reserved keywords that can be specified: universe, instance-id, zone, and region.
  • Templated tag value must have instance-id at the minimum.
  • Order of the parts of template does not matter.

Now open the cloud provider's instances page. The following example uses AWS as the cloud provider, so you need to navigate to EC2 > Running Instances in the correct availability zone and search for instances that have test-tags in their name. You should see the following under Tags of those instances:

Instances with tags

yb-server-type and launched-by are reserved names.

Now suppose you modified the existing user tags, as per the following illustration:

Instances with tags

The following changes have been made:

  • Billing was modified.
  • MyInfo was deleted.
  • NewInfo was added.
  • Department was not changed.

Note that you cannot change the Name key field.

Once again, you can confirm via the cloud provider list of instances that the tags have been updated correctly, as per the following illustration:

Edited instances with tags