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 com tag seus recursos do Amazon Kinesis Data Streams
É possível atribuir seus próprios metadados aos fluxos e aos consumidores de distribuição avançada criados no Amazon Kinesis Data Streams na forma de *tags*. Tag é um par de chave-valor definida para um fluxo. Usar tags é uma maneira simples, porém poderosa, de gerenciar AWS recursos e organizar dados, incluindo dados de faturamento.
**Topics**
+ [Revisar conceitos básicos de tags](#tagging-basics)
+ [Monitorar custos usando tags](#tagging-billing)
+ [Compreender as restrições de tags](#tagging-restrictions)
+ [Atribuir tags a fluxos usando o console do Kinesis Data Streams](#tagging-console)
+ [Marque fluxos usando o AWS CLI](#tagging-cli)
+ [Marque streams usando o Kinesis Data Streams APIs](#tagging-api)
+ [Marque os consumidores usando o AWS CLI](#tagging-consumers-cli)
+ [Marque consumidores usando o Kinesis Data Streams APIs](#tagging-consumers-api)
## Revisar conceitos básicos de tags
Os recursos do Kinesis Data Streams que você pode marcar com tags incluem fluxos de dados e consumidores de distribuição avançada. Você usa o AWS CLI console do Kinesis Data Streams ou a API do Kinesis Data Streams para concluir as seguintes tarefas:
+ Criar um recurso com tags
+ Adicionar tags a um recurso
+ Listar as tags para seus recursos
+ Remover as tags de um recurso
**nota**
Você não pode aplicar tags a consumidores de distribuição avançada usando o console do Kinesis Data Streams. Para aplicar tags aos consumidores, use AWS CLI nossa API Kinesis Data Streams.
É possível usar tags para categorizar os recursos do . Por exemplo, você pode categorizar recursos 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, é possível definir um conjunto de tags que ajude a monitorar os recursos por proprietário e por aplicação associada. Aqui estão alguns exemplos de tags:
+ Projeto: nome do projeto
+ Proprietário: nome
+ Objetivo: testes de carga
+ Aplicação: nome da aplicação
+ Ambiente: produção
**Importante**
Para adicionar tags ao criar um fluxo, inclua as permissões `kinesis:CreateStream` e `kinesis:AddTagsToStream` para esse fluxo. Você **não pode usar** a permissão `kinesis:TagResource` para marcar fluxos ao criá-los.
Para adicionar tags durante o registro do consumidor, inclua as permissões `kinesis:TagResource` e `kinesis:RegisterStreamConsumer`.
## Monitorar custos usando tags
Você pode usar tags para categorizar e monitorar seus AWS custos. Quando você aplica tags aos seus recursos do Kinesis Data Streams AWS , seu relatório de alocação de custos inclui o uso e os custos agregados por tags. É possível aplicar tags que representem categorias de negócios, como centros de custos, nomes de aplicações ou proprietários, para organizar seus custos em vários serviços. 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 *.
## Compreender as restrições de tags
As restrições a seguir se aplicam às tags:
**Restrições básicas**
+ O número máximo de tags para cada 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.
+ Você não pode iniciar uma chave de tag com `aws:` porque esse prefixo é reservado para uso por AWS. AWS cria tags que começam com esse prefixo em seu nome, mas você não pode editá-las nem 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: `_ . / = + - @`.
## Atribuir tags a fluxos usando o console do Kinesis Data Streams
É possível adicionar, atualizar, listar e remover tags em seus fluxos usando o console do Kinesis Data Streams.
**Para visualizar as tags de um fluxo**
1. [Faça login no Console de gerenciamento da AWS e abra o console do Kinesis em https://console.aws.amazon.com /kinesis.](https://console.aws.amazon.com/kinesis)
1. No painel de navegação à esquerda, selecione **Fluxos de dados**.
1. Na página **Fluxos de dados**, selecione o fluxo que deseja marcar com tag.
1. Na página Detalhes do fluxo, selecione **Configuração**.
1. Na seção **Tags**, visualize as tags aplicadas ao fluxo.
**Como criar um fluxo de dados com uma tag**
1. Abra o console do Kinesis Data Streams.
1. No painel de navegação à esquerda, selecione **Fluxos de dados**.
1. Selecione **Criar fluxo de dados**.
1. Na página **Criar fluxo de dados**, insira um nome para seu fluxo de dados.
1. Para **Capacidade de fluxo de dados**, selecione o modo de capacidade **Sob demanda** ou **Provisionada**.
Para obter mais informações sobre modos de capacidade, consulte [Escolha o modo certo para transmitir](how-do-i-size-a-stream.md).
1. Na seção **Tags**, faça o seguinte:
1. Selecione **Adicionar nova tag**.
1. Para **Chave**, insira a tag e, opcionalmente, especifique um valor no campo **Valor**.
Se aparecer um erro, a chave ou o valor da tag especificado não atende às restrições da tag. Para obter mais informações, consulte [Compreender as restrições de tags](#tagging-restrictions).
1. Selecione **Criar fluxo de dados**.
**Para adicionar ou atualizar uma tag em um fluxo**
1. Abra o console do Kinesis Data Streams.
1. No painel de navegação à esquerda, selecione **Fluxos de dados**.
1. Na página **Fluxos de dados**, selecione o fluxo ao qual você deseja adicionar ou atualizar as tags.
1. Na página Detalhes do fluxo, selecione **Configuração**.
1. Na seção **Tags**, escolha **Gerenciar tags**.
1. Em **Tags**, faça uma das seguintes opções:
+ Para adicionar uma tag, selecione **Adicionar nova tag** e insira os dados da tag **Chave** e **Valor**. Repita esta etapa quantas vezes for necessário.
O número máximo de tags que podem ser adicionadas a cada fluxo é 50.
+ Para atualizar uma tag atual, insira um novo valor de tag no campo **Valor** da **Chave** dessa tag.
Se aparecer um erro, a chave ou o valor da tag especificado não atende às restrições da tag. Para obter mais informações, consulte [Compreender as restrições de tags](#tagging-restrictions).
1. Escolha **Salvar alterações**.
**Para remover uma tag de um fluxo**
1. Abra o console do Kinesis Data Streams.
1. No painel de navegação à esquerda, selecione **Fluxos de dados**.
1. Na página **Fluxos de dados**, selecione o fluxo do qual você deseja remover as tags.
1. Na página Detalhes do fluxo, selecione **Configuração**.
1. Na seção **Tags**, escolha **Gerenciar tags**.
1. Localize o par de tags **Chave** e **Valor** que você deseja remover. Em seguida, escolha **Remover**.
1. Escolha **Salvar alterações**.
## Marque fluxos usando o AWS CLI
É possível adicionar, listar e remover tags em seus fluxos usando a AWS CLI. Para obter exemplos, consulte a seguinte documentação.
[create-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/create-stream.html)
Cria um fluxo com tags.
[add-tags-to-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/add-tags-to-stream.html)
Adiciona ou atualiza as tags para o fluxo especificado.
[list-tags-for-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/list-tags-for-stream.html)
Lista as tags para o fluxo especificado.
[remove-tags-from-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/remove-tags-from-stream.html)
Remove as tags do fluxo especificado.
## Marque streams usando o Kinesis Data Streams APIs
Você pode adicionar, listar e remover tags em seus streams usando o Kinesis Data Streams. APIs Para obter exemplos, consulte a seguinte documentação:
[CreateStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_CreateStream.html)
Cria um fluxo com tags.
[AddTagsToStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_AddTagsToStream.html)
Adiciona ou atualiza as tags para o fluxo especificado.
[ListTagsForStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_ListTagsForStream.html)
Lista as tags para o fluxo especificado.
[RemoveTagsFromStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_RemoveTagsFromStream.html)
Remove as tags do fluxo especificado.
## Marque os consumidores usando o AWS CLI
É possível adicionar, listar e remover tags em seus consumidores usando a AWS CLI. Para obter exemplos, consulte a seguinte documentação:
[register-stream-consumer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/register-stream-consumer.html)
Registra um consumidor para um fluxo de dados do Kinesis com tags.
[tag-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/tag-resource.html)
Adiciona ou atualiza tags para o recurso do Kinesis especificado.
[list-tags-for-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/list-tags-for-resource.html)
Lista as tags do recurso do Kinesis especificado.
[untag-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/untag-resource.html)
Remove as tags do recurso do Kinesis especificado.
## Marque consumidores usando o Kinesis Data Streams APIs
Você pode adicionar, listar e remover tags em seus consumidores usando o Kinesis APIs Data Streams. Para obter exemplos, consulte a seguinte documentação:
[RegisterStreamConsumer](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_RegisterStreamConsumer.html)
Registra um consumidor para um fluxo de dados do Kinesis com tags.
[TagResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_TagResource.html)
Adiciona ou atualiza tags para o recurso do Kinesis especificado.
[ListTagsForResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_ListTagsForResource.html)
Lista as tags do recurso do Kinesis especificado.
[UntagResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_UntagResource.html)
Remove as tags do recurso do Kinesis especificado.