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 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).

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 the select (Select) button, and then select the environments you want to edit.
  4. Click add Labels. The Add Labels 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 (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 category and any label values associated with it, click delete.

    To remove label values:

    1. Click edit next to the label you want to edit.
    2. Click remove next to the values you want to remove.

      remove

    3. Click check to finish removing the label value.

    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.