

 AWS Cloud9 não está mais disponível para novos clientes. Os clientes atuais do AWS Cloud9 podem continuar usando o serviço normalmente. [Saiba mais](https://aws.amazon.com/blogs/devops/how-to-migrate-from-aws-cloud9-to-aws-ide-toolkits-or-aws-cloudshell/)

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Tags
<a name="tags"></a>

Uma tag é um rótulo ou atributo que você AWS anexa a um AWS recurso. Cada tag consiste em um par de *chave* e *valor*. Você pode usar tags para controlar o acesso aos seus AWS Cloud9 recursos, conforme descrito em [Controlar o acesso usando tags de AWS recursos](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) no *[Guia do usuário do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/)*. As tags também podem ajudá-lo a gerenciar informações de faturamento, conforme descrito em [Tags de alocação de custos definidas pelo usuário](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/custom-tags.html).

Quando você [cria um ambiente de AWS Cloud9 EC2 desenvolvimento](create-environment-main.md), AWS Cloud9 inclui determinadas tags de sistema necessárias para gerenciar o ambiente. As tags do sistema começam com "**aws:**“. Durante esse processo de criação, você também pode adicionar suas próprias tags de recursos.

Depois que o ambiente for criado, você poderá exibir as tags anexadas ao ambiente, adicionar novas tags de recursos ao ambiente ou modificar/ remover as tags adicionadas anteriormente. Você pode anexar até 50 tags definidas pelo usuário a um AWS Cloud9 ambiente.

Visualize ou atualize as tags usando um ou mais dos métodos a seguir.
+ No [console do AWS Cloud9](https://console.aws.amazon.com/cloud9/), selecione o ambiente no qual você está interessado e escolha **View Details (Exibir detalhes)**.  
![\[Exibir os detalhes de um ambiente.\]](http://docs.aws.amazon.com/pt_br/cloud9/latest/user-guide/images/view-details.png)
+ Use os seguintes comandos da AWS Cloud9 CLI: [https://docs.aws.amazon.com/cli/latest/reference/cloud9/list-tags-for-resource.html](https://docs.aws.amazon.com/cli/latest/reference/cloud9/list-tags-for-resource.html), e. [https://docs.aws.amazon.com/cli/latest/reference/cloud9/untag-resource.html](https://docs.aws.amazon.com/cli/latest/reference/cloud9/untag-resource.html)
+ Use as seguintes ações de AWS Cloud9 API: [ListTagsForResource[TagResource](https://docs.aws.amazon.com/cloud9/latest/APIReference/API_TagResource.html)](https://docs.aws.amazon.com/cloud9/latest/APIReference/API_ListTagsForResource.html), [UntagResource](https://docs.aws.amazon.com/cloud9/latest/APIReference/API_UntagResource.html)e.

**Atenção**  
As tags que você cria ou atualiza AWS Cloud9 usando os métodos anteriores não são propagadas automaticamente para os recursos subjacentes. Para obter informações sobre como fazer isso, consulte a próxima seção, [Propagar atualizações de tags nos recursos subjacentes](#tags-propagate).

## Propagar atualizações de tags nos recursos subjacentes
<a name="tags-propagate"></a>

Quando você usa comandos da AWS Cloud9 CLI ou ações de API para adicionar, modificar ou remover as tags anexadas a um AWS Cloud9 ambiente, essas alterações não são propagadas automaticamente para os recursos subjacentes, como a CloudFormation pilha, a instância da Amazon e os grupos de segurança EC2 da Amazon. EC2 Você deve propagar manualmente essas alterações.

Para facilitar o uso dos procedimentos a seguir, você pode obter o ID do ambiente do seu interesse. Para isso siga estas etapas:

1. No [console do AWS Cloud9](https://console.aws.amazon.com/cloud9/), selecione o ambiente no qual você está interessado e escolha **View Details (Exibir detalhes)**.

1. Procure a propriedade **Environment ARN (ARN do ambiente)** e registre o ID do ambiente, que é a parte do ARN do ambiente após "**environment:**“.

Você precisará propagar as atualizações de tags para um ou mais dos locais a seguir, dependendo de como você pretende usar as tags.

### Propagando atualizações de tags para a pilha CloudFormation
<a name="propagating-tag-updates"></a>

**nota**  
Quando você atualiza as tags na AWS CloudFormation pilha, essas atualizações são propagadas automaticamente para a EC2 instância da Amazon e para os grupos de EC2 segurança da Amazon associados à pilha.

1. Navegue até o [console do CloudFormation](https://console.aws.amazon.com/cloudformation).

1. Encontre e escolha a pilha que corresponde ao AWS Cloud9 ambiente em que você está interessado. Se você registrou o ID do ambiente, poderá usá-lo para filtrar o ambiente.

1. Na guia **Stack info (Informações da pilha)**, na seção **Tags (Marcas)**, revise a lista de tags.

1. Se precisar atualizar as tags, escolha **Update (Atualizar)** na parte superior da página e siga as instruções. Para obter mais informações, consulte [Atualizar pilhas diretamente](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-direct.html) no *[Manual do usuário do AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/)*.

Você também pode atualizar tags usando os comandos da CLI [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-stacks.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-stacks.html) e [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/update-stack.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/update-stack.html).

### Propagação de atualizações de tags para a instância da Amazon EC2
<a name="w2aac33c30c15c13"></a>

1. Navegue até o console [Amazon EC2 Instances](https://console.aws.amazon.com/ec2/home#Instances).

1. Encontre e selecione a EC2 instância da Amazon que corresponde ao AWS Cloud9 ambiente em que você está interessado. Se você registrou o ID do ambiente anteriormente, poderá usá-lo para filtrar o ambiente.

1. Na guia **Tags**, visualize e atualize as tags conforme necessário.

Você também pode atualizar tags usando os comandos da CLI [describe-tags](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-tags.html), [create-tags](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-tags.html) e [delete-tags](https://docs.aws.amazon.com/cli/latest/reference/ec2/delete-tags.html).

### Propagando atualizações de tags para grupos de EC2 segurança da Amazon
<a name="w2aac33c30c15c15"></a>

1. Navegue até o console do [Amazon EC2 Security Groups](https://console.aws.amazon.com/ec2/home#SecurityGroups).

1. Encontre e selecione o grupo de segurança que corresponde ao AWS Cloud9 ambiente em que você está interessado. Se você registrou o ID do ambiente anteriormente, poderá usá-lo para filtrar o ambiente.

1. Abra a guia **Tags** para exibir e atualizar tags conforme necessário.

Você também pode atualizar tags usando os comandos da CLI [describe-tags](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-tags.html), [create-tags](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-tags.html) e [delete-tags](https://docs.aws.amazon.com/cli/latest/reference/ec2/delete-tags.html).