Tag resources in Amazon Connect
A tag is a custom metadata label that you can add to a resource in order to make it easier to identify, organize, and find in a search. Tags are comprised of two individual parts: A tag key and a tag value. This is referred to as a key:value pair.
A tag key typically represents a larger category, while a tag value
represents a subset of that category. For example you could have tag key=Color
and tag value=Blue, which would produce the key:value pair
Color:Blue. Note that you can set the value of a tag to an empty string,
but you can't set the value of a tag to null. Omitting the tag value is the same as using an
empty string.
Tag keys can be up to 128 characters in length and tag values can be up to 256 characters in length; both are case sensitive. For more information, see:
-
Amazon Connect Voice ID TagResource: You can add tags to the Voice ID domain.
Amazon Connect services support up to 50 tags per resource. For a given resource, each tag key must be unique with only one value.
Note
Your tags cannot begin with aws: because AWS reserves this prefix for
system-generated tags. You cannot add, modify, or delete aws:* tags, and
they don't count against your tags-per-resource limit.
The following table describes the Amazon Connect resources that can be tagged using the AWS CLI or an AWS SDK.
Tagging support for Amazon Connect resources | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Resource | Supports tagging using the Amazon Connect console | Supports tagging using the CLI/SDK | Supports tagging on creation | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Agent |
Yes |
Yes |
Yes |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Agent group |
No |
Yes |
Yes |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Agent group level |
No |
No |
Yes |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Agent state |
No |
Yes |
Yes |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contact |
No |
No |
No |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Contact evaluations |
No |
Yes |
No |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Evaluation forms |
No |
Yes |
No |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Flow |
No |
Yes |
Yes |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Flow module |
No |
Yes |
Yes |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Hours of operation |
Yes |
Yes |
Yes |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Instance |
Yes | Yes |
Yes |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Integration association |
No |
Yes |
Yes |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Outbound campaign |
No |
Yes |
Yes |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Phone number | No | Yes |
Yes |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Prompts |
Yes |
Yes |
Yes |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Queue agent |
No |
No |
Yes |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Queues |
Yes |
Yes |
Yes |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Quick connects |
No |
Yes |
Yes |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Routing Profile |
Yes |
Yes |
Yes |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Security profile |
Yes |
Yes |
Yes |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Task template | No | No |
Yes |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Traffic distribution group | No | Yes |
Yes |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Transfer destination |
No |
Yes |
Yes |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Use case |
No |
Yes |
Yes |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Vocabulary |
No |
Yes |
Yes |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
To learn more about tagging, including best practices, see Tagging AWS resources in the AWS General Reference.
Tag-based access control
To use tags to control access to resources within your AWS accounts, you need to
provide tag information in the condition element of an IAM policy. For example, to
control access to your Voice ID domain based on the tags you've assigned to it, use the
aws:ResourceTag/key-name condition key to specify which tag key:value
pair must be attached to the domain, in order to allow given actions for it.
For more detailed information on tag-based access control in the Amazon Connect console, see Tag-based access control.
For more detailed information on tag-based access control in IAM, see Controlling access to AWS resources using tags in the IAM User Guide
