Marcar fluxos no Amazon Kinesis Data Streams

Você pode atribuir os próprios metadados aos fluxos que cria no Amazon Kinesis Data Streams na forma de tags. Tag é um par de chave-valor que você define para um stream. O uso de tags é uma forma simples, mas eficiente, de gerenciar os recursos da AWS e organizar os dados, incluindo dados de faturamento.

Conceitos básicos de tags

Use o console do Kinesis Data Streams, a AWS CLI ou a API do Kinesis Data Streams para concluir as seguintes tarefas:

• Adicionar tags a um stream

• Listar as tags para os streams

• Remover tags de um stream

Você pode usar tags para categorizar seus streams. Por exemplo, você pode categorizar streams 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 streams por proprietário e aplicativo associado. Aqui estão alguns exemplos de marcas:

• Projeto: nome do projeto

• Proprietário: nome

• Objetivo: testes de carga

• Aplicação: nome da aplicação

• Ambiente: produção

Monitoramento de custos com marcação

Você pode usar tags para categorizar e monitorar seus custos da AWS. Quando você aplica tags aos recursos da AWS, incluindo fluxos, o relatório de alocação de custos da AWS inclui o uso e os custos agrupados 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 de vários serviços. 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 tag

As restrições a seguir se aplicam a marcas.

Restrições básicas

• O número máximo de tags por recurso (stream) é 50.

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

• Você não pode alterar nem editar as tags de um stream 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: _ . / = + - @.

Marcar fluxos usando o console do Kinesis Data Streams

Você pode adicionar, listar e remover tags usando o console do Kinesis Data Streams.

Para visualizar as tags de um stream

1. Abra o console do Kinesis Data Streams. Na barra de navegação, expanda o seletor de região e selecione uma região.

2. Na página Stream List (Lista de streamings), selecione um streaming.

3. Na página Stream Details (Detalhes do streaming), clique na guia Tags.

Para adicionar uma tag a um stream

1. Abra o console do Kinesis Data Streams. Na barra de navegação, expanda o seletor de região e selecione uma região.

2. Na página Stream List (Lista de streamings), selecione um streaming.

3. Na página Stream Details (Detalhes do streaming), clique na guia Tags.

4. Especifique a chave da tag no campo Key (Chave). Opcionalmente, especifique um valor de tag no campo Value (Valor) e, em seguida, clique em Add Tag (Adicionar tag).

   Se o botão Add Tag (Adicionar tag) não estiver habilitado, a chave ou o valor da tag que você especificou não atenderá as restrições de tag. Para obter mais informações, consulte Restrições de tag.

5. Para visualizar a nova tag na lista da guia Tags, clique no ícone de atualização.

Para remover uma tag de um stream

1. Abra o console do Kinesis Data Streams. Na barra de navegação, expanda o seletor de região e selecione uma região.

2. Na página Stream List, selecione um stream.

3. Na página Stream Details (Detalhes do streaming), clique na guia Tags e, em seguida, clique no ícone Remove (Remover) da tag.

4. Na caixa de diálogo Delete Tag (Excluir tag), clique em Yes, Delete (Sim, excluir).

Atribuir tags a streams usando o AWS CLI

Você pode adicionar, listar e remover tags usando a AWS CLI. Para obter exemplos, consulte a seguinte documentação.

add-tags-to-stream

Adiciona ou atualiza as tags para o stream especificado.

list-tags-for-stream

Lista as tags para o stream especificado.

remove-tags-from-stream

Remove as tags do stream especificado.

Marcar fluxos usando a API console do Kinesis Data Streams

Você pode adicionar, listar e remover tags usando a API do Kinesis Data Streams. Para obter exemplos, consulte a seguinte documentação:

AddTagsToStream

Adiciona ou atualiza as tags para o stream especificado.

ListTagsForStream

Lista as tags para o stream especificado.

RemoveTagsFromStream

Remove as tags do stream especificado.