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 fluxos no Amazon Kinesis Data Streams
É possível atribuir os próprios metadados aos fluxos criados no Amazon Kinesis Data Streams na forma de tags. Tag é um par de chave-valor definida para um fluxo. O uso de tags é uma forma simples, mas eficiente, de gerenciar os recursos da AWS e organizar os dados, incluindo dados de faturamento.
Sumário
Revisar 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:
-
Criar um fluxo com tags
-
Adicionar tags a um fluxo
-
Listar as tags para os fluxos
-
Remover tags de um fluxo
É possível usar tags para categorizar os fluxos. Por exemplo, é possível categorizar fluxos por finalidade, proprietário ou ambiente. Como a chave e o valor podem ser definidos para cada tag, é possível criar um conjunto de categorias personalizado para atender a necessidades específicas. Por exemplo, pode-se definir um conjunto de tags que ajude a monitorar os fluxos por proprietário e aplicativo associado. 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
Monitorar custos usando tags
É possível usar tags para categorizar e monitorar seus custos da AWS. Ao aplicar 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.
Compreender as restrições de tags
As restrições a seguir se aplicam a tags.
Restrições básicas
-
O número máximo de tags por recurso (fluxo) é 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 fluxo excluído.
Restrições de chaves de marcas
-
Cada chave de marca 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:
_ . / = + - @.
Atribuir tags a fluxos usando o console do Kinesis Data Streams
É possível adicionar, listar e remover tags usando o console do Kinesis Data Streams.
Para visualizar as tags de um fluxo
-
Abra o console do Kinesis Data Streams. Na barra de navegação, expanda o seletor de região e selecione uma região.
-
Na página Lista de fluxos, selecione um fluxo.
-
Na página Detalhes do fluxo, selecione a guia Tags.
Como criar um fluxo de dados com uma tag
-
Abra o console do Kinesis Data Streams. Na barra de navegação, expanda o seletor de região e selecione uma região.
-
Escolha Criar fluxo.
-
Na página Criar fluxo de dados, insira um nome para o fluxo de dados e escolha o modo de capacidade Sob demanda ou Provisionado. O modo Sob demanda é selecionado por padrão. Para obter mais informações, consulte Escolher o modo de capacidade do fluxo de dados.
-
Na seção Tags, escolha Adicionar nova tag. Especifique a tag no campo Chave e, opcionalmente, especifique um valor de tag no campo Valor.
Se aparecer um erro, a chave ou o valor da tag especificados não atendem às restrições da tag. Para obter mais informações, consulte Compreender as restrições de tags.
-
Selecione Criar fluxo de dados.
-
Na página Fluxos de dados, o Status do fluxo aparece como Criando enquanto o fluxo está sendo criado. Quando o fluxo estiver pronto para ser usado, o status mudará para Ativo.
-
Escolha o nome do fluxo. A página Detalhes do fluxo exibe um resumo da configuração do fluxo com informações de monitoramento.
Para adicionar uma tag a um fluxo
-
Abra o console do Kinesis Data Streams. Na barra de navegação, expanda o seletor de região e selecione uma região.
-
Na página Lista de fluxos, selecione um fluxo.
-
Na página Detalhes do fluxo, selecione a guia Tags.
-
Especifique a chave de tag no campo Chave. Se preferir, especifique um valor de tag no campo Valor e selecione Adicionar tag.
Se o botão Adicionar tag não estiver habilitado, a chave ou o valor da tag especificados não atendem as restrições de tag. Para obter mais informações, consulte Compreender as restrições de tags.
-
Para visualizar a nova tag na lista da guia Tags, selecione o ícone de atualização.
Para remover uma tag de um fluxo
-
Abra o console do Kinesis Data Streams. Na barra de navegação, expanda o seletor de região e selecione uma região.
-
Na página Stream List, selecione um fluxo.
-
Na página Detalhes do fluxo, selecione a guia Tags e, em seguida, selecione o ícone Remover da tag.
-
Na caixa de diálogo Excluir tag, selecione Sim, excluir.
Atribuir tags a fluxos usando a AWS CLI
É possível adicionar, listar e remover tags usando a AWS CLI. Para obter exemplos, consulte a seguinte documentação.
- create-stream
-
Cria um fluxo com tags.
- add-tags-to-stream
-
Adiciona ou atualiza as tags para o fluxo especificado.
- list-tags-for-stream
-
Lista as tags para o fluxo especificado.
- remove-tags-from-stream
-
Remove as tags do fluxo especificado.
Atribuir tags a fluxos usando a API do Kinesis Data Streams
É possível adicionar, listar e remover tags usando a API do Kinesis Data Streams. Para obter exemplos, consulte a seguinte documentação:
- CreateStream
-
Cria um fluxo com tags.
- AddTagsToStream
-
Adiciona ou atualiza as tags para o fluxo especificado.
- ListTagsForStream
-
Lista as tags para o fluxo especificado.
- RemoveTagsFromStream
-
Remove as tags do fluxo especificado.
