Use Amazon CloudSearch tags to attach metadata to your search domains. AWS does not apply any semantic meaning to your tags; tags are interpreted strictly as character strings. All tags contain the following elements.
| Tag Element | Description |
|---|---|
| Tag key | The tag key is the required name of the tag. Tag keys must be unique for the domain to which they are attached. For a list of basic restrictions on tag keys and values, see Tag Restrictions. |
| Tag value | The tag value is an optional string value of the tag. Tag values can be null and do not have to be unique in a tag set. For example, you can have a key-value pair in a tag set of project/Trinity and cost-center/Trinity. For a list of basic restrictions on tag keys and values, see Tag Restrictions. |
Each Amazon CloudSearch domain has a tag set, which contains all the tags that are assigned to that domain. AWS does not automatically set any tags on Amazon CloudSearch domains. A tag set can contain as many as ten tags, or it can be empty. If you add a tag to an Amazon CloudSearch domain that has the same key as an existing tag for a resource, the new value overwrites the old value.
You can use a tag key to define a category, and the tag value can be a item in that
category. For example, you could define a tag key of project and a tag value of
Salix indicating that the domain is assigned to the Salix project. You
could also use tags to designate domains for test or production environments by using keys
such as environment=test and environment=production. We recommend
that you use a consistent set of tag keys to make it easier to track metadata associated
with your search domains.
You also can use tags to organize your AWS bill to reflect your own cost structure and to track costs by grouping expenses for similarly tagged resources. To do this, sign up to get your AWS account bill with tag key values included. Then, organize your billing information according to resources with the same tag key values to see the cost of combined resources. For example, you can tag several Amazon CloudSearch domains with key-value pairs, and then organize your billing information to see the total cost for each domain across several services. For more information, see Cost Allocation and Tagging in the AWS Billing and Cost Management documentation.
Note
Tags are cached for authorization purposes. Because of this, additions and updates to tags on Amazon CloudSearch domains might take several minutes before they are available.
Working with Tags (Console)
Use the following procedure to create a resource tag with the Amazon CloudSearch console.
To create a tag
-
Go to the Amazon CloudSearch console and choose the name of your domain to open its configuration panel.
-
Go to the Tags tab and choose Manage.
-
Enter a tag key and optional value, then choose Submit.
For more information about using the console to work with tags, see Working with the Tag Editor in the AWS Management Console Getting Started Guide.
