Marcar recursos do AWS Direct Connect

Uma tag é um rótulo que um proprietário de recursos atribui aos recursos do AWS Direct Connect. Cada tag consiste em uma chave e um valor opcional, ambos definidos por você. As tags permitem que o proprietário de recursos categorize os recursos do AWS 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 AWS 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:

ID do recurso	Chave de tag	Valor da tag
dxcon-11aa22bb	Finalidade	Produção
	Local	Amsterdã
dxvif-33cc44dd	Finalidade	Produção
dxcon-abcabcab	Finalidade	Backup
	Local	Frankfurt
dxvif-12312312	Finalidade	Backup

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 no AWS Direct Connect e são interpretadas estritamente como uma sequência dos 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 AWS Direct Connect a seguir usando o console do AWS Direct Connect, a API do AWS 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) 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	Não	Não	Não	Não

Restrições de tags

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: + - = . _ : / @

• 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 no Guia do usuário do AWS Billing and Cost Management.

Trabalhar com tags usando a 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	tag-resource
Exclua uma ou mais tags.	UntagResource	untag-resource
Descreva uma ou mais tags.	DescribeTags	describe-tags

Exemplos

Use o comando tag-resource 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 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 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