Amazon Comprehend
Developer Guide

Tagging Custom Classifiers

A tag is a key-value pair which can be added to a Amazon Comprehend resource as metadata.

Tags can be used for organizing your resources as well as helping you to search and filter by tag. Using tag-based access control can allow for finer control than API-level control as well as more dynamic control than resource-based access control. IAM policies can be created that allow or disallow an operation based on tags provided in the request (request-tags) or tags on the resource that is being operated on (resource-tags). For more information on using IAM roles for this, Controlling Access Using Tags in the IAM User Guide

For instance, you could add tags such as ‘Sales’ or ‘Legal' to different custom classifiers to break down documents into dynamic categories for your company.

Multiple tags can be added to an Amazon Comprehend resource, either when you create it, or later. Up to 50 tags can be associated with each resource.

Each tag key must be unique for a specific resource. However, the same key can be used for different resources. The tag value can be used to make the tag more specific, but is optional.

The following options are available when using tags with Amazon Comprehend custom classifiers:

Tagging a resource when you originally create it

When you want to add one or more tags to a custom classifier when you originally create it, you can do this when training the classifier.

To tag a resource when creating it

  1. In the optional Tags section, enter the key-value pair for your tag.

    Note

    Remember the key must be unique for the given resource. The value is optional.

    
            The optional Tags section.
  2. Choose Add tag to associate the tag with your resource. You can do this multiple times to add more than one tag.

    Once you’ve added a tag, you can remove it before creating the resource by choosing Remove tag.

When using the APIs, you can do this using the CreateDocumentClassifier operation.

Tagging a resource after it’s been created

You can also easily add a tag to an existing custom classifier using the resource list or the detail page for a specific custom classifier.

To add a tag to an existing custom classifier

  1. On the Custom Classifier resource list, select the classifier to which you want to add the tag, and then choose Manage tags.

    
            The Custom Classifier resource list.

    Alternatively, choose Manage tags in the Tags section of a specific classifier’s details page.

    
            The detail page.
  2. Under Tags, enter the key-value pair for your tag.

    Note

    Remember the key must be unique for the given resource. The value is optional.

    
          The Tag section.
  3. Choose Add tag to associate your tag with the resource. You can do this multiple times to add more than one tag.

    Once you’ve added a tag, you can remove it before creating the resource by choosing Remove tag.

  4. Choose Save.

Modifying an existing tag

You can remove an existing using the resource list or the detail page for a specific resource.

To modify an existing tag

  1. Under Tags, choose the tag you want to change and choose the X for the key or value box. Enter the new key or value.

    
          Existing tags for a resource.
  2. Make any additional changes desired to the tags.

  3. Choose Save.

Removing tags from a resource

You can remove a tag from an existing custom classifier using the resource list or the detail page for a specific classifier.

To remove a tag from an existing custom classifier

  1. On the Custom Classifier resource list, select the classifier from which you want to remove the tag, and then choose Manage tags.

    
            The Custom Classifier resource list.

    Alternatively, choose Manage tags in the Tags section of a specific classifier’s details page.

    
            The detail page.
  2. Next to the tag that you want to remove, choose Remove tag.

    
            Existing tags for a resource.
  3. Choose Save.

Viewing all tags associated with a resource

To view all tags associated with a specific resource

  • On the Custom Classifier resource list, select the classifier for which you want to view the tags, and then choose Manage tags.

Tagging restrictions

The following basic restrictions apply to Custom Classification tags:

  • The maximum number of tags per classifier is 50.

  • The maximum length of a tag key is 127 characters.

  • The maximum length of a tag value is 255 characters.

  • Tag keys and values are case sensitive.

  • The aws: prefix is reserved for AWS use; you cannot add, edit, or delete tags whose key begins with aws:. Tags that begin with aws: do not count against your tags-per-resource limit.

  • If you plan to use your tagging schema across multiple services and resources, remember that other services may have different restrictions for allowed characters. Refer to the documentation for that service.