Amazon WorkSpaces
Administration Guide

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

Tag WorkSpaces Resources

You can organize and manage the resources for your WorkSpaces by assigning your own metadata to each resource in the form of tags. You specify a key and a value for each tag. A key can be a general category, such as "project," "owner," or "environment," with specific associated values. Using tags is a simple yet powerful way to manage AWS resources and organize data, including billing data.

Tags added to an existing resource appear in your cost allocation report on the first of the following month for WorkSpaces renewed in that month. For more information, see Using Cost Allocation Tags in the AWS Billing and Cost Management User Guide.

Resources You Can Tag

  • You can add tags to the following resources when you create them—WorkSpaces, imported images, and IP access control groups.

  • You can add tags to existing resources of the following types—WorkSpaces, registered directories, custom bundles, images, and IP access control groups.

Tag Restrictions

  • Maximum number of tags per resource—50

  • Maximum key length—127 Unicode characters

  • Maximum value length—255 Unicode characters

  • Tag keys and values are case-sensitive. Allowed characters are letters, spaces, and numbers representable in UTF-8, plus the following special characters: + - = . _ : / @. Do not use leading or trailing spaces.

  • Do not use the "aws:" or "aws:workspaces:" prefixes in your tag names or value because they are reserved for AWS use. You can't edit or delete tag names or values with these prefixes.

To update the tags for an existing resource using the console

  1. Open the Amazon WorkSpaces console at https://console.aws.amazon.com/workspaces/.

  2. In the navigation pane, choose one of the following resource types: Directories, WorkSpaces, Bundles, Images, or IP Access Controls.

  3. Select the resource and choose Actions, Manage Tags.

  4. Do one or more of the following:

    1. To update a tag, edit the values of Key and Value.

    2. To add a tag, choose Add Tag and then edit the values of Key and Value.

    3. To delete a tag, choose the delete icon (X) next to the tag.

  5. When you are finished updating tags, choose Save.

To update the tags for an existing resource using the AWS CLI

Use the create-tags and delete-tags commands.