Adding and removing labels for environments

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

An environment can have a maximum of 30 category/value pairs.
Each category can have a maximum of 2,000 values.
Values have a 255-character limit.
Values aren’t case-sensitive (for example, ABCD, abcd, and aBcD are treated as the same value and stored only once for a category).
Values can’t include semicolon (;) or comma (,) characters.

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

Adding labels to multiple environments

To add a label to multiple environments

In the navigation bar, click Environments.
In the Manage Environments and VMs page, click the Environments tab.
Click and select the environments you want to edit.
Click . The Add Label dialog displays.
From the Category drop-down, choose one of the predefined categories.

Only account administrators can create categories.
Type an appropriate value for the category. When you start typing, Skytap autocomplete suggests existing values that contain the characters that you typed.
The Value column displays the category type:
- Single – You can add only one value for this category.
- Multi – You can add multiple values, separated by commas, for this category.
Click .

To add a label to an environment

In the navigation bar, click Environments.
In the Manage Environments and VMs page, click the Environments tab.
Click the environment you want to edit.
In the environment page, click the Labels tab.
From the Category drop-down, choose one of the predefined categories.

Only account administrators can create categories.
Type an appropriate value for the category. When you start typing, Skytap autocomplete suggests existing values that contain the characters that you typed.
The Value column displays the category type:
- Single – You can add only one value for this category.
- Multi – You can add multiple values, separated by commas, for this category.
Click (Add).

To remove a label from an environment

Navigate to the environment you want to edit.
1. In the navigation bar, click Environments
2. In the Manage Environments and VMs page, click the Environments tab.
3. Click the environment you want to edit. The Environment Details page displays.
In the environment page, click the Labels tab. The list of labels attached to the environment displays.
To remove a label value, click next to the value you want to remove.

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.