AWS Direct Connect Recursos de tags

Uma tag é um rótulo que o proprietário do recurso atribui aos seus AWS Direct Connect recursos. Cada tag consiste em uma chave e um valor opcional, ambos definidos por você. As tags permitem que o proprietário do recurso categorize seus AWS Direct Connect recursos de maneiras diferentes, por exemplo, por finalidade ou 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 AWS Direct Connect conexões 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 da . As tags não têm nenhum significado semântico AWS Direct Connect e são interpretadas estritamente como uma sequência 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.

Você pode marcar os seguintes AWS Direct Connect recursos usando o AWS Direct Connect console, o AWS Direct Connect API, o AWS CLI AWS Tools for Windows PowerShell, o ou um AWS SDK. Ao usar essas ferramentas para gerenciar tags, você deve especificar o Amazon Resource Name (ARN) para o recurso. Para obter mais informações sobreARNs, consulte Amazon Resource Names (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
Grupos de agregação de links () LAG	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 aws: prefixo está reservado para AWS uso. 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 suportadas somente para conexões, interconexões e. LAGs Para obter informações sobre como usar tags com o gerenciamento de custos, consulte Usando tags de alocação de custos no Guia do AWS Billing and Cost Management usuário.

Trabalhando com tags usando o CLI ou 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