Atribuir tags no Amazon Kinesis Data Streams - Amazon Kinesis Data Streams

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 no Amazon Kinesis Data Streams

Você pode atribuir seus próprios metadados aos streams que cria no Amazon Kinesis Data Streams na forma detags. 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

Você usa o console do Kinesis Data StreamsAWS CLIou a API do Kinesis Data Streams para executar 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:

  • : Nome do projeto

  • Proprietário: Name (Nome)

  • Finalidade: Testes de carga

  • Aplicação: Application name

  • : Produção

Monitoramento de custos com marcação

Você pode usar tags para categorizar e monitorar seus custos da AWS. Quando você aplica tags aoAWSrecursos, incluindo fluxos, seuAWSO relatório de alocação de custos da 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 tag devem consistir nos 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, eles devem consistir nos seguintes caracteres: Letras Unicode, dígitos, espaço em branco e qualquer um dos seguintes caracteres especiais:_ . / = + - @.

Atribuir tags 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 do

Adiciona ou atualiza as tags para o stream especificado.

list-tags-for-stream do

Lista as tags para o stream especificado.

remove-tags-from-stream do

Remove as tags do stream especificado.

Atribuir tags usando a API 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.