Marcar recursos do AWS Direct Connect - AWS Direct Connect

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 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. Você pode editar chaves de tags e valores, e você pode remover as tags de um recurso a qualquer momento. Você pode 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 oAWS Direct Connectrecursos usando oAWS Direct ConnectConsole do, oAWS Direct ConnectAPI, oAWS CLI, oAWS Tools for Windows PowerShell, ou umAWSSDK. 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, consulteNomes de recurso da Amazon (ARN)noReferência geral do 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 do 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