Tagging VMs
Tags are user-defined labels that you can assign to ccloud³ VMs and other centron resources. They enable you to filter by ccloud³ VMs, automatically include ccloud³ VMs in centron firewall or load balancer configurations, create monitoring alert policies for groups, and use the centron API to initiate actions across multiple ccloud³ VMs.
Choosing terms that describe the function of a ccloud³ VM can help you identify and manage ccloud³ VMs with common roles. For example, you could tag ccloud³ VMs according to:
-
Environment, such as production, staging or development.
-
Applications such as web servers (Apache) or database servers (MariaDB).
-
Purpose, such as a project name or another key term that describes the use of the ccloud³ VM.
-
The person, such as an individual or a team, responsible for managing the ccloud³ VM.
You can add tags to ccloud³ VMs either during or after creation.
Limits
Tags must be a single word consisting only of letters, numbers, colons, hyphens and underscores.
Known issues
-
You cannot edit existing tags. Instead, create a new tag, apply it to the relevant resources, and delete the old one.
-
Tag names are case-insensitive, which means that the spelling you use when first creating a tag is the canonical form.
When working with tags in the API, you must use the canonical form of the tag. For example, the URL to add this tag to a resource would be:
GET /ccloud/servers/{hostname}/tags
Automating the tagging of ccloud³ VMs
When tagging a ccloud³ VM via the API, you must have created a tag beforehand.
Tagging ccloud³ VMs during creation
To add tags when creating a new ccloud³ VM, look for the ‘Tags’ field in the ‘Final Details’ section of the ccloud³ VM creation page. Here, you can enter tags and add them using the SPACE BAR or ENTER key after each term.
Tagging existing ccloud³ VMs
To add or edit tags for existing ccloud³ VMs, use the ‘More’ menu on the ccloud³ VM and select ‘Edit tags’, or use the ‘Tags’ link on the ccloud³ VM details page.
Filter by tag
If you click on a tag in the Control Panel, you will be taken to a list of all resources with that tag. Filtered lists are limited to a single tag, which is displayed at the top of the list.