Tagging resources in Amazon Connect - Amazon Connect

Tagging 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 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 tags Supports tagging on creation

Agent

Yes

Yes

Agent group

Yes

Yes

Agent group level

No

No

Agent state

Yes

Yes

Task template Yes No

Contact

No

No

Flow

Yes

Yes

Flow module

Yes

Yes

Instance

No No

Integration association

Yes

Yes

Operating hours

Yes

Yes
Phone number Yes Yes

Prompt

No

No

Queue

Yes

Yes

Queue agent

No

No

Routing Profile

Yes

Yes

Security profile

Yes

Yes

Transfer destination

Yes

Yes

Use case

Yes

Yes

Vocabulary

Yes

Yes
Note

Tagging of Amazon Connect resources is currently only available using the AWS CLI or an AWS SDK.

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, see Controlling access to AWS resources using tags in the IAM User Guide