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.

Contents

Adding labels to multiple environments

To add a label to multiple environments

  1. In the navigation bar, click Environments.
  2. In the Manage Environments and VMs page, click the Environments tab.
  3. Click select and select the environments you want to edit.
  4. Click add. The Add Label dialog displays.

    add label

  5. From the Category drop-down, choose one of the predefined categories.

    Only account administrators can create categories.

  6. Type an appropriate value for the category. When you start typing, Skytap autocomplete suggests existing values that contain the characters that you typed.

    add value

    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.
  7. Click add.

Adding labels to an environment

To add a label to an environment

  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.
  4. In the environment page, click the Labels tab.

    labels tab

  5. From the Category drop-down, choose one of the predefined categories.

    Only account administrators can create categories.

  6. Type an appropriate value for the category. When you start typing, Skytap autocomplete suggests existing values that contain the characters that you typed.

    add value

    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.
  7. Click add (Add).

Removing labels from an environment

To remove a label from an environment

  1. 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.
  2. In the environment page, click the Labels tab. The list of labels attached to the environment displays.

    remove

  3. To remove a label value, click delete 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.