Atribuir tags a um cluster do Amazon MSK - Amazon Managed Streaming for Apache Kafka

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á.

Atribuir tags a um cluster do Amazon MSK

É possível atribuir seus próprios metadados na forma de tags a um recurso do Amazon MSK, como um cluster do MSK. Uma tag é um par de chave-valor que você define para o recurso. Usar tags é uma maneira simples, porém poderosa, de gerenciar AWS recursos e organizar dados, incluindo dados de faturamento.

Conceitos Básicos de Tags

É possível usar a API do Amazon MSK para concluir as seguintes tarefas:

  • Adicionar tags a um recurso do Amazon MSK.

  • Listar as tags de um recurso do Amazon MSK.

  • Remover as tags de um recurso do Amazon MSK.

É possível usar tags para categorizar os recursos do Amazon MSK. Por exemplo, é possível categorizar os clusters do Amazon MSK por finalidade, proprietário ou ambiente. Como você define a chave e o valor para cada marca, você pode criar um conjunto de categorias personalizado para atender às suas necessidades específicas. Por exemplo, você pode definir um conjunto de tags que ajude a monitorar os clusters por proprietário e aplicativo associado.

Estes são diversos exemplos de tags:

  • Project: Project name

  • Owner: Name

  • Purpose: Load testing

  • Environment: Production

Monitorar custos usando a marcação

Você pode usar tags para categorizar e monitorar seus AWS custos. Quando você aplica tags aos seus AWS recursos, incluindo clusters do Amazon MSK, seu relatório de alocação de AWS custos inclui o uso e os custos agregados por tags. Você pode organizar seus custos de vários serviços aplicando tags que representam categorias de negócios (como centros de custos, nomes de aplicativos ou proprietários). Para obter mais informações, consulte Usar etiquetas de alocação de custos para relatórios de faturamento personalizados no Manual do usuário do AWS Billing .

Restrições de tags

As restrições a seguir se aplicam a tags no Amazon MSK.

Restrições básicas
  • O número máximo de tags por recurso é 50.

  • As chaves e os valores de tags diferenciam maiúsculas de minúsculas.

  • Não é possível alterar nem editar as tags de um recurso excluído.

Restrições de chaves de marcas
  • Cada chave de marca deve ser exclusiva. Se você adicionar uma marca com uma chave que já estiver em uso, sua nova marca existente substituirá o par de chave-valor.

  • Não é possível iniciar uma chave de tag com aws:, pois esse prefixo é reservado para uso pela AWS. A AWS cria tags que começam com esse prefixo em seu nome, mas você não pode editá-las ou excluí-las.

  • As chaves de marca devem ter entre 1 e 128 caracteres Unicode.

  • As chaves de marca devem conter os seguintes caracteres: letras Unicode, dígitos, espaço em branco e os seguintes caracteres especiais: _ . / = + - @.

Restrições de valor de marcas
  • Os valores de marca devem ter entre 0 e 255 caracteres Unicode.

  • Os valores de marca podem estar em branco. Caso contrário, elas devem conter os seguintes caracteres: letras Unicode, dígitos, espaço em branco e qualquer um dos seguintes caracteres especiais: _ . / = + - @.

Atribuição de tags a recursos usando a API do Amazon MSK

É possível usar as seguintes operações para atribuir ou excluir tags de um recurso do Amazon MSK ou para listar o conjunto atual de tags de um recurso: