User guide

Tagging Resources in Amazon
Redshift
Topics
• Tagging Overview (p. 240)
• Managing Resource Tags Using the Console (p. 241)
• Managing Tags Using the Amazon Redshift API (p. 243)
Tagging Overview
In AWS, tags are user-defined labels that consist of key-value pairs. Amazon Redshift supports tagging
to provide metadata about resources at a glance, and to categorize your billing reports based on cost
allocation. To use tags for cost allocation, you must first activate those tags in the AWS Billing and Cost
Management service. For more information about setting up and using tags for billing purposes, see Use
Cost Allocation Tags for Custom Billing Reports and Setting Up Your Monthly Cost Allocation Report.
Tags are not required for resources in Amazon Redshift, but they help provide context.You might want
to tag resources with metadata about cost centers, project names, and other pertinent information related
to the resource. For example, suppose you want to track which resources belong to a test environment
and a production environment.You could create a key named environment and provide the value test
or production to identify the resources used in each environment. If you use tagging in other AWS
services or have standard categories for your business, we recommend that you create the same key-value
pairs for resources in Amazon Redshift for consistency.
Tags are retained for resources after you resize a cluster, and after you restore a snapshot of a cluster
within the same region. However, tags are not retained if you copy a snapshot to another region, so you
must recreate the tags in the new region. If you delete a resource, any associated tags are deleted.
Each resource has one tag set, which is a collection of one or more tags assigned to the resource. Each
resource can have up to 10 tags per tag set.You can add tags when you create a resource and after a
resource has been created.You can add tags to the following resource types in Amazon Redshift:
• CIDR/IP
• Cluster
• Cluster security group
• Cluster security group ingress rule
API Version 2012-12-01
240
Amazon Redshift Management Guide
Tagging Overview