Marcar com tag seus recursos do Amazon Kinesis Data Streams - Amazon Kinesis Data Streams
Revisar conceitos básicos de tagsMonitorar custos usando tagsCompreender as restrições de tagsAtribuir tags a fluxos usando o console do Kinesis Data StreamsAtribuir tags a fluxos usando a AWS CLIAtribuir tags a fluxos usando as APIs do Kinesis Data StreamsMarcar consumidores com tags usando a AWS CLIMarcar consumidores com tags usando as APIs do Kinesis Data Streams

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. O uso de tags é uma forma simples, mas eficiente, de gerenciar os recursos da AWS e organizar os dados, incluindo dados de faturamento.

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. Use o console do Kinesis Data Streams, a AWS CLI 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 ou a API do 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, você deve incluir 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, você deve incluir as permissões kinesis:TagResource e kinesis:RegisterStreamConsumer.

Monitorar custos usando tags

É possível usar tags para categorizar e monitorar seus custos da AWS. Ao aplicar tags aos recursos da Kinesis Data Streams, 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 em vários serviços. Para obter mais informações, consulte Usar tags 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 às tags:

Restrições básicas

  • O número máximo de tags para cada recurso é 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 recurso 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, 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.

  2. No painel de navegação à esquerda, selecione Fluxos de dados.

  3. Na página Fluxos de dados, selecione o fluxo que deseja marcar com tag.

  4. Na página Detalhes do fluxo, selecione Configuração.

  5. 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.

  2. No painel de navegação à esquerda, selecione Fluxos de dados.

  3. Selecione Criar fluxo de dados.

  4. Na página Criar fluxo de dados, insira um nome para seu fluxo de dados.

  5. 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.

  6. Na seção Tags, faça o seguinte:

    1. Selecione Adicionar nova tag.

    2. 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.

  7. Selecione Criar fluxo de dados.

Para adicionar ou atualizar uma tag em um fluxo

  1. Abra o console do Kinesis Data Streams.

  2. No painel de navegação à esquerda, selecione Fluxos de dados.

  3. Na página Fluxos de dados, selecione o fluxo ao qual você deseja adicionar ou atualizar as tags.

  4. Na página Detalhes do fluxo, selecione Configuração.

  5. Na seção Tags, escolha Gerenciar tags.

  6. 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.

  7. Escolha Salvar alterações.

Para remover uma tag de um fluxo

  1. Abra o console do Kinesis Data Streams.

  2. No painel de navegação à esquerda, selecione Fluxos de dados.

  3. Na página Fluxos de dados, selecione o fluxo do qual você deseja remover as tags.

  4. Na página Detalhes do fluxo, selecione Configuração.

  5. Na seção Tags, escolha Gerenciar tags.

  6. Localize o par de tags Chave e Valor que você deseja remover. Em seguida, escolha Remover.

  7. Escolha Salvar alterações.

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

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 as APIs do Kinesis Data Streams

É possível adicionar, listar e remover tags em seus fluxos usando as APIs 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.

Marcar consumidores com tags usando a 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

Registra um consumidor para um fluxo de dados do Kinesis com tags.

tag-resource

Adiciona ou atualiza tags para o recurso do Kinesis especificado.

list-tags-for-resource

Lista as tags do recurso do Kinesis especificado.

untag-resource

Remove as tags do recurso do Kinesis especificado.

Marcar consumidores com tags usando as APIs do Kinesis Data Streams

É possível adicionar, listar e remover tags em seus consumidores usando as APIs do Kinesis Data Streams. Para obter exemplos, consulte a seguinte documentação:

RegisterStreamConsumer

Registra um consumidor para um fluxo de dados do Kinesis com tags.

TagResource

Adiciona ou atualiza tags para o recurso do Kinesis especificado.

ListTagsForResource

Lista as tags do recurso do Kinesis especificado.

UntagResource

Remove as tags do recurso do Kinesis especificado.