Tags - AWS Cloud9

Tags

A tag is a label or attribute that you or AWS attaches to an AWS resource. Each tag consists of a key and a paired value. You can use tags to control access to your AWS Cloud9 resources, as described in Control Access Using AWS Resource Tags in the IAM User Guide. Tags can also help you manage billing information, as described in User-Defined Cost Allocation Tags.

When you create an AWS Cloud9 EC2 development environment, AWS Cloud9 includes certain system tags that it needs to manage the environment. System tags start with "aws:". During that creation process, you can also add your own resource tags.

After the environment is created, you can view the tags that are attached to the environment, add new resource tags to the environment, or modify or remove the tags that you added earlier. You can attach up to 50 user-defined tags to an AWS Cloud9 environment.

View or update tags using one or more of the following methods.

Warning

Tags that you create or update for AWS Cloud9 by using the preceding methods are NOT automatically propagated to underlying resources. For information about how to do this, see the next section, Propagating Tag Updates to Underlying Resources.

Propagating Tag Updates to Underlying Resources

When you use AWS Cloud9 CLI commands or API actions to add, modify, or remove the tags that are attached to an AWS Cloud9 environment, those changes aren't automatically propagated to underlying resources such as the AWS CloudFormation stack, the Amazon EC2 instance, and Amazon EC2 security groups. You must manually propagate those changes.

To make it easier to use the following procedures, you can obtain the environment ID for the environment you're interested in. If you wish to do this, do so as follows:

  1. In the AWS Cloud9 console, select the environment you're interested in, and then choose View Details.

  2. Look for the Environment ARN property and record the environment ID, which is the part of the environment ARN after "environment:".

You will need to propagate tag updates to one or more of the following locations, depending on what you'll use the tags for.

Propagating Tag Updates to the AWS CloudFormation Stack

Note

When you update tags to the AWS CloudFormation stack, those updates are automatically propagated to the Amazon EC2 instance and Amazon EC2 security groups that are associated with the stack.

  1. Navigate to the AWS CloudFormation console.

  2. Find and choose the stack that corresponds to the AWS Cloud9 environment you're interested in. If you recorded the environment ID, you can use it to filter for the environment.

  3. On the Stack info tab, in the Tags section, review the list of tags.

  4. If you need to update the tags, choose Update near the top of the page, and follow the instructions. For more information, see Updating Stacks Directly in the AWS CloudFormation User Guide.

You can also update tags using the describe-stacks and update-stack CLI commands.

Propagating Tag Updates to the Amazon EC2 Instance

  1. Navigate to the Amazon EC2 Instances console.

  2. Find and select the Amazon EC2 instance that corresponds to the AWS Cloud9 environment you're interested in. If you recorded the environment ID earlier, you can use it to filter for the environment.

  3. On the Tags tab, view and update tags as necessary.

You can also update tags using the describe-tags, create-tags, and delete-tags CLI commands.

Propagating Tag Updates to Amazon EC2 Security Groups

  1. Navigate to the Amazon EC2 Security Groups console.

  2. Find and select the security group that corresponds to the AWS Cloud9 environment you're interested in. If you recorded the environment ID earlier, you can use it to filter for the environment.

  3. Open the Tags tab to view and update tags as necessary.

You can also update tags using the describe-tags, create-tags, and delete-tags CLI commands.