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á.
# Marcar recursos do AWS Direct Connect
Uma tag é um rótulo que um proprietário de recursos atribui aos recursos do Direct Connect. Cada tag consiste de uma chave e um valor opcional, que podem ser definidos. As tags permitem que o proprietário de recursos categorize os recursos do Direct Connect de diferentes maneiras, como por finalidade ou por ambiente. Isso é útil quando há muitos recursos do mesmo tipo; você pode identificar rapidamente um recurso específico com base nas tags atribuídas a ele.
Por exemplo, você tem duas conexões do Direct Connect em uma Região, cada uma em locais diferentes. Conexão `dxcon-11aa22bb` é uma conexão que oferece tráfego de produção e está associada à interface virtual `dxvif-33cc44dd`. Conexão `dxcon-abcabcab` é uma conexão redundante (backup) e está associada à interface virtual `dxvif-12312312`. Convém optar por identificar as conexões e as interfaces virtuais da seguinte maneira para ajudar a diferenciá-las:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/directconnect/latest/UserGuide/using-tags.html)
Recomendamos que você desenvolva um conjunto de chave de tags que atenda suas necessidades para cada tipo de recurso. Usar um conjunto consistente de chaves de tags facilita para você gerenciar seus recursos. As tags não têm significado semântico atrelado a Direct Connect e são interpretadas estritamente como string de caracteres. Além disso, as tags não são automaticamente atribuídas aos seus recursos. É possível editar chaves de tags e valores, e é possível remover as tags de um recurso a qualquer momento. É possível definir o valor de uma tag a uma string vazia, mas não pode configurar o valor de um tag como nula. Se você adicionar uma tag que tenha a mesma chave de uma tag existente nesse recurso, o novo valor substituirá o antigo. Se você excluir um recurso, todas as tags do recurso também serão excluídas.
É possível marcar os recursos do Direct Connect a seguir usando o console do Direct Connect, a API do Direct Connect, a AWS CLI, o AWS Tools for Windows PowerShell ou um SDK da AWS. Ao usar essas ferramentas para gerenciar tags, é necessário especificar o nome de recurso da Amazon (ARN) para o recurso. Para obter mais informações sobre ARNs, consulte [Nomes de recurso da Amazon (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) no *Referência geral da Amazon Web Services*.
| Recurso | Compatível com tags | Oferece suporte a tags na criação | Oferece suporte a tags que controlam o acesso e a alocação de recursos | Oferece suporte à alocação de custos |
| --- | --- | --- | --- | --- |
| Conexões | Sim | Sim | Sim | Sim |
| Interfaces virtuais | Sim | Sim | Sim | Não |
| Link aggregation groups (LAG — Grupos de agregação de links) | Sim | Sim | Sim | Sim |
| Interconexões | Sim | Sim | Sim | Sim |
| Gateways Direct Connect | Sim | Sim | Sim | Não |
## Restrições de tag
As seguintes regras e restrições se aplicam a tags:
+ Número máximo de tags por recurso: 50
+ Comprimento máximo da chave: 128 caracteres Unicode
+ Comprimento máximo de valor: 265 caracteres Unicode
+ As chaves e os valores de tags diferenciam maiúsculas de minúsculas.
+ O prefixo `aws:` é reservado para uso da AWS. Não é possível editar nem excluir a chave ou o valor de uma tag quando ela tem uma chave de tag com o prefixo `aws:`. As tags com chave de tag com o prefixo `aws:` não são contabilizadas para o limite de tags por recurso.
+ Os caracteres permitidos são letras, espaços e números representáveis em UTF-8, além dos seguintes caracteres especiais: \$1 - = . \$1 : / @
+ Somente o proprietário do recurso pode adicionar ou remover tags. Por exemplo, se houver uma conexão hospedada, o parceiro não poderá adicionar, remover ou visualizar as tags.
+ As tags de alocação de custos são compatíveis somente com conexões, interconexões e LAGs. Para obter informações sobre como usar tags com o gerenciamento de custos, consulte [Usar tags de alocação de custos](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) no *Guia do usuário do Gerenciamento de Faturamento e Custos da AWS*.
## Trabalhar com tags usando CLI ou a API
Use o seguinte para adicionar, atualizar, listar e excluir as tags para seus recursos.
| Tarefa | API | CLI |
| --- | --- | --- |
| Adicione ou sobrescreva uma ou mais tags. | [TagResource](https://docs.aws.amazon.com/directconnect/latest/APIReference/API_TagResource.html) | [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/directconnect/tag-resource.html) |
| Exclua uma ou mais tags. | [UntagResource](https://docs.aws.amazon.com/directconnect/latest/APIReference/API_UntagResource.html) | [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/directconnect/untag-resource.html) |
| Descreva uma ou mais tags. | [DescribeTags](https://docs.aws.amazon.com/directconnect/latest/APIReference/API_DescribeTags.html) | [describe-tags](https://docs.aws.amazon.com/cli/latest/reference/directconnect/describe-tags.html) |
### Exemplos
Use o comando [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/directconnect/tag-resource.html) para marcar a conexão `dxcon-11aa22bb`.
```
aws directconnect tag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-11aa22bb --tags "key=Purpose,value=Production"
```
Use o comando [describe-tags](https://docs.aws.amazon.com/cli/latest/reference/directconnect/describe-tags.html) para descrever as tags da conexão `dxcon-11aa22bb`.
```
aws directconnect describe-tags --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-11aa22bb
```
Use o comando [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/directconnect/untag-resource.html) para remover uma tag da conexão `dxcon-11aa22bb`.
```
aws directconnect untag-resource --resource-arn arn:aws:directconnect:us-east-1:123456789012:dxcon/dxcon-11aa22bb --tag-keys Purpose
```