Adding tags and labels to resources in DynamoDB
You can label Amazon DynamoDB resources using tags. Tags let you categorize your resources in different ways, for example, by purpose, owner, environment, or other criteria. Tags can help you do the following:
-
Quickly identify a resource based on the tags that you assigned to it.
-
See Amazon bills broken down by tags.
Note
Any local secondary indexes (LSI) and global secondary indexes (GSI) related to tagged tables are labeled with the same tags automatically. Currently, DynamoDB Streams usage cannot be tagged.
Tagging is supported by Amazon services like Amazon EC2, Amazon S3, DynamoDB, and more. Efficient tagging can provide cost insights by enabling you to create reports across services that carry a specific tag.
To get started with tagging, do the following:
-
Understand Tagging restrictions in DynamoDB.
-
Create tags by using Tagging resources in DynamoDB.
-
Use Using DynamoDB tags to create cost allocation reports to track your Amazon costs per active tag.
Finally, it is good practice to follow optimal tagging strategies. For information, see
Amazon tagging
strategies
Tagging restrictions in DynamoDB
Each tag consists of a key and a value, both of which you define. The following restrictions apply:
-
Each DynamoDB table can have only one tag with the same key. If you try to add an existing tag (same key), the existing tag value is updated to the new value.
-
Tag keys and values are case sensitive.
-
The maximum key length is 128 Unicode characters.
-
The maximum value length is 256 Unicode characters.
-
The allowed characters are letters, white space, and numbers, plus the following special characters:
+ - = . _ : /
-
The maximum number of tags per resource is 50.
-
The maximum size supported for all the tags in a table is 10 KB.
-
Amazon-assigned tag names and values are automatically assigned the
aws:
prefix, which you can't assign. Amazon-assigned tag names don't count toward the tag limit of 50 or the 10 KB maximum size limit. User-assigned tag names have the prefixuser:
in the cost allocation report. -
You can't backdate the application of a tag.
Using DynamoDB tags to create cost allocation reports
Amazon uses tags to organize resource costs on your cost allocation report. Amazon provides two types of cost allocation tags:
-
An Amazon-generated tag. Amazon defines, creates, and applies this tag for you.
-
User-defined tags. You define, create, and apply these tags.
You must activate both types of tags separately before they can appear in Cost Explorer or on a cost allocation report.
To activate Amazon-generated tags:
-
Sign in to the Amazon Web Services Management Console and open the Billing and Cost Management console at https://console.aws.amazon.com/billing/home#/.
-
In the navigation pane, choose Cost Allocation Tags.
-
Under Amazon-Generated Cost Allocation Tags, choose Activate.
To activate user-defined tags:
-
Sign in to the Amazon Web Services Management Console and open the Billing and Cost Management console at https://console.aws.amazon.com/billing/home#/.
-
In the navigation pane, choose Cost Allocation Tags.
-
Under User-Defined Cost Allocation Tags, choose Activate.
After you create and activate tags, Amazon generates a cost allocation report with your usage and costs grouped by your active tags. The cost allocation report includes all of your Amazon costs for each billing period. The report includes both tagged and untagged resources, so that you can clearly organize the charges for resources.
Note
Currently, any data transferred out from DynamoDB won't be broken down by tags on cost allocation reports.
For more information, see Using cost allocation tags.