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á.
Você pode atribuir seus próprios metadados aos streams e consumidores de fan-out aprimorados que você cria 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.
Revisar conceitos básicos de tags
Os recursos do Kinesis Data Streams que você pode marcar incluem fluxos de dados e consumidores distribuídos aprimorados. Você usa o AWS CLI console do Kinesis Data Streams ou a API do Kinesis Data Streams para concluir as seguintes tarefas:
-
Crie um recurso com tags
-
Adicionar tags a um recurso
-
Liste as tags para seus recursos
-
Remover tags de um recurso
nota
Você não pode aplicar tags a consumidores de fan-out aprimorados 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, você pode definir um conjunto de tags que ajuda a rastrear recursos 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
Importante
-
Para adicionar tags ao criar um stream, você deve incluir as
kinesis:AddTagsToStreampermissõeskinesis:CreateStreame para esse stream. Você não pode usar akinesis:TagResourcepermissão para marcar streams ao criá-los. -
Para adicionar tags durante o registro do consumidor, você deve incluir as
kinesis:RegisterStreamConsumerpermissõeskinesis:TagResourcee.
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. Você pode aplicar tags que representam categorias de negócios, como centros de custos, nomes de aplicativos 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.
-
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
Você pode adicionar, atualizar, listar e remover tags em seus streams usando o console do Kinesis Data Streams.
Para visualizar as tags de um fluxo
-
No painel de navegação esquerdo, escolha Fluxos de dados.
-
Na página Fluxos de dados, escolha o fluxo que você deseja marcar.
-
Na página de detalhes do stream, escolha Configuração.
-
Na seção Tags, veja as tags aplicadas ao stream.
Como criar um fluxo de dados com uma tag
-
Abra o console do Kinesis Data Streams.
-
No painel de navegação esquerdo, escolha Fluxos de dados.
-
Selecione Criar fluxo de dados.
-
Na página Criar fluxo de dados, insira um nome para seu fluxo de dados.
-
Para capacidade de fluxo de dados, escolha o modo de capacidade sob demanda ou provisionada.
Para obter mais informações sobre os modos de capacidade, consulteEscolher o modo de capacidade do fluxo de dados.
-
Na seção Tags, faça o seguinte:
-
Selecione Adicionar nova tag.
-
Em Chave, insira a tag e, opcionalmente, especifique um valor no campo Valor.
Se você ver um erro, a chave ou o valor da tag que você especificou não atende às restrições da tag. Para obter mais informações, consulte Compreender as restrições de tags.
-
-
Selecione Criar fluxo de dados.
Para adicionar ou atualizar uma tag em um stream
-
Abra o console do Kinesis Data Streams.
-
No painel de navegação esquerdo, escolha Fluxos de dados.
-
Na página Fluxos de dados, escolha o fluxo ao qual você deseja adicionar ou atualizar as tags.
-
Na página de detalhes do stream, escolha Configuração.
-
Na seção Tags, escolha Gerenciar tags.
-
Em Tags, faça o seguinte:
-
Para adicionar uma nova tag, escolha Adicionar nova tag e, em seguida, insira os dados de chave e valor da tag. Repita esta etapa quantas vezes for necessário.
O número máximo de tags que você pode adicionar para cada stream é 50.
-
Para atualizar uma tag existente, insira um novo valor de tag no campo Valor da chave dessa tag.
Se você ver um erro, a chave ou o valor da tag que você especificou não atende às restrições da tag. Para obter mais informações, consulte Compreender as restrições de tags.
-
-
Escolha Salvar alterações.
Para remover uma tag de um fluxo
-
Abra o console do Kinesis Data Streams.
-
No painel de navegação esquerdo, escolha Fluxos de dados.
-
Na página Fluxos de dados, escolha o fluxo do qual você deseja remover as tags.
-
Na página de detalhes do stream, escolha Configuração.
-
Na seção Tags, escolha Gerenciar tags.
-
Encontre o par de tags Chave e Valor que você deseja remover. Em seguida, escolha Remover.
-
Escolha Salvar alterações.
Marque fluxos usando o AWS CLI
Você pode adicionar, listar e remover tags em seus streams usando o. 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.
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
-
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.
Marque os consumidores usando o AWS CLI
Você pode adicionar, listar e remover tags em seus consumidores usando AWS CLI o. Para obter exemplos, consulte a seguinte documentação:
- register-stream-consumer
-
Registra um consumidor em um stream de dados do Kinesis com tags.
- tag-resource
-
Adiciona ou atualiza tags para o recurso Kinesis especificado.
- list-tags-for-resource
-
Lista as tags do recurso Kinesis especificado.
- untag-resource
-
Remove as tags do recurso 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
-
Registra um consumidor em um stream de dados do Kinesis com tags.
- TagResource
-
Adiciona ou atualiza tags para o recurso Kinesis especificado.
- ListTagsForResource
-
Lista as tags do recurso Kinesis especificado.
- UntagResource
-
Remove as tags do recurso Kinesis especificado.
