Tagging an organization - Amazon WorkMail

Tagging an organization

Tagging an Amazon WorkMail organization resource lets you do the following:

  • Differentiate between organizations in the AWS Billing and Cost Management console.

  • Control access to Amazon WorkMail organization resources by adding them to the Resource element of IAM permission policy statements.

For more information about Amazon WorkMail resource-level permissions, see Resources. For more information about controlling access based on tags, see Authorization based on Amazon WorkMail tags.

Amazon WorkMail administrators can tag organizations using the Amazon WorkMail console.

To add tags to an Amazon WorkMail organization

  1. Open the Amazon WorkMail console at https://console.aws.amazon.com/workmail/.

  2. On the Organizations screen, choose the alias of the organization to add tags to.

  3. Choose Tags.

  4. For Organization tags, choose Add new tag.

  5. For Key, enter a string to identify the tag.

  6. (Optional) For Value, enter a value for the tag.

  7. (Optional) Repeat steps 4-6 to add more tags to your organization. You can add up to 50 tags.

  8. Choose Submit to save your changes.

You can view your organization tags in the Amazon WorkMail console.

Developers can also tag organizations using the AWS SDK or AWS Command Line Interface (AWS CLI). For more information, see the TagResource, ListTagsForResource, and UntagResource commands in the Amazon WorkMail API Reference or the AWS CLI Command Reference.

You can remove tags from an organization at any time, using the Amazon WorkMail console.

To remove tags from an Amazon WorkMail organization

  1. Open the Amazon WorkMail console at https://console.aws.amazon.com/workmail/.

  2. On the Organizations screen, choose the alias of the organization to remove tags from.

  3. Choose Tags.

  4. For Organization tags, choose Remove next to the tag to remove.

  5. Choose Submit to save your changes.