Home > User Guide

Adding and removing labels for VMs and other resources

Your account administrator defines label categories and guidelines for label values.

A VM can have a maximum of 30 category/value pairs.
Each category can have a maximum of 1,000 values.
Values have a 255-character limit.
Values are not case-sensitive (for example, ABCD, abcd, and aBcD are treated as the same value and stored only once for a category).
When a label is removed from a resource, the label category and value remain active in your account. Their history with the resource is retained.

For best practices about using labels, see Using labels for in-depth usage reporting.

Contents

Adding labels to VMs

To add a label to a VM

From the environment details page, click VMs: Settings. The VM Settings page displays.
On the VM Settings page, click the Labels tab.
From the Add a label drop-down menu, choose a label category.
Type a value for the label. For example, if you wanted to label a VM with its OS license number, you could select License and then type the license key.
Click Add.

Notes

Although you can add labels to individual VMs, they aren’t used in reports.

Only multi value label categories can be used on VMs.

Removing labels from VMs

To remove a label from a VM

From the environment details page, click VMs: Settings. The VM Settings page displays.
On the VM Settings page, click the Labels tab.
Click next to the label you want to remove. A confirmation dialog displays.
In the confirmation dialog, click OK.

Adding and removing labels for assets

Use the REST API to add and remove labels for assets. For more information, see Asset labels v2 resource.

Adding and removing labels for schedules

Use the REST API to add and remove labels for schedules. For more information, see Schedule labels v2 resource.