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 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.
**Topics**
+ [Noções básicas sobre tags para clusters do Amazon MSK](msk-tagging-basics.md)
+ [Acompanhe os custos do cluster do Amazon MSK usando a marcação](msk-tagging-billing.md)
+ [Restrições de tag](msk-tagging-restrictions.md)
+ [Marcar recursos usando a API do Amazon MSK](msk-tagging-howto.md)
# Noções básicas sobre tags para clusters do Amazon MSK
É 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, é possível 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`
# Acompanhe os custos do cluster do Amazon MSK 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. É possível organizar seus custos de vários serviços aplicando tags que representem categorias de negócios (como centros de custos, nomes de aplicações ou proprietários). Para obter mais informações, consulte [Usar tags de alocação de custos para relatórios de faturamento personalizados](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) no *Manual do usuário do AWS Billing *.
# Restrições de tag
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 marcas 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 tag deve ser exclusiva. Se uma tag for adicionada com uma chave que já estiver em uso, a nova tag substituirá o par de chave-valor existente.
+ 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 não é possível editá-las ou excluí-las.
+ As chaves de tag devem ter entre 1 e 128 caracteres Unicode.
+ As chaves de tag devem conter os seguintes caracteres: letras Unicode, dígitos, espaço em branco e os seguintes caracteres especiais: `_ . / = + - @`.
**Restrições de valor das tags**
+ Os valores das tags devem ter entre 0 e 255 caracteres Unicode.
+ Os valores das tags podem estar em branco. Caso contrário, eles devem conter os seguintes caracteres: letras Unicode, dígitos, espaço em branco e qualquer um dos seguintes caracteres especiais: `_ . / = + - @`.
# Marcar 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:
+ [ListTagsForResource](https://docs.aws.amazon.com//msk/1.0/apireference/tags-resourcearn.html#ListTagsForResource)
+ [TagResource](https://docs.aws.amazon.com//msk/1.0/apireference/tags-resourcearn.html#TagResource)
+ [UntagResource](https://docs.aws.amazon.com//msk/1.0/apireference/tags-resourcearn.html#UntagResource)