View a markdown version of this page

Atualizar um fluxo - Amazon Kinesis Data Streams
Usar o consoleUsar a APIUse o comando AWS CLI

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

Atualizar um fluxo

É possível atualizar os detalhes de um fluxo usando o console do Kinesis Data Streams, a API do Kinesis Data Streams ou a AWS CLI.

nota

Pode-se ativar a criptografia no lado do servidor para streams existentes ou para os recém-criados.

Usar o console

Para atualizar um fluxo de dados usando o console

  1. Abra o console do Amazon Kinesis em https://console.aws.amazon.com/kinesis/.

  2. Na barra de navegação, expanda o seletor de região e escolha uma região.

  3. Escolha o nome do fluxo na lista. A página Detalhes do fluxo exibe um resumo das informações de configuração e monitoramento do fluxo.

  4. Para alternar entre os modos de capacidade sob demanda e provisionada para um fluxo de dados, escolha Editar modo de capacidade na guia Configuração. Para obter mais informações, consulte Escolha o modo certo para transmitir.

    Importante

    Para cada fluxo de dados em sua AWS conta, você pode alternar entre os modos sob demanda e provisionado duas vezes em 24 horas.

  5. Para um fluxo de dados no modo sob demanda com o modo On-demand Advantage ativado, você pode configurar a taxa de transferência quente para aumentar ou diminuir a capacidade de ingestão do stream.

    Para aumentar a capacidade de ingestão

    Na guia Configuração, escolha Editar taxa de transferência quente e insira um valor de taxa de transferência alvo (in MB/s) maior que a capacidade atual do fluxo. O fluxo provisiona imediatamente a capacidade para pelo menos a taxa de transferência quente especificada, garantindo que ele possa lidar com o tráfego esperado sem limitação. Por exemplo, se você prevê que um evento futuro atinja o pico em torno de 200 MB/s, defina a taxa de transferência de aquecimento para 200 MB/s com antecedência, sem nenhum custo adicional.

    Para diminuir a capacidade de ingestão

    Se o fluxo tiver sido escalado significativamente além de seu valor de taxa de transferência quente, reconfigure a taxa de transferência quente para esse valor ou menor para acionar uma redução de escala. O fluxo é dimensionado de acordo com o número solicitado ou a capacidade necessária para suportar o pico de uso da ingestão de dados observado na última hora, o que for maior. Isso garante que o stream sempre retenha capacidade suficiente para lidar com padrões de tráfego recentes.

    O uso de uma taxa de transferência quente não acarreta nenhum custo adicional. Para obter mais informações, consulte On-demand Recursos e casos de uso do modo Advantage.

  6. Para editar o número de fragmentos de um fluxo de dados no modo provisionado, escolha Editar fragmentos provisionados na guia Configuração e, em seguida, insira uma nova contagem de fragmentos.

  7. Para ativar a criptografia de registros de dados no lado do servidor, escolha Editar na seção de criptografia. Server-side Escolha uma chave KMS para usar como chave mestra para criptografia ou use a chave mestra padrão aws/kinesis, gerenciada pelo Kinesis. Se você habilitar a criptografia para um stream e usar sua própria chave AWS KMS mestra, garanta que seus aplicativos de produtor e consumidor tenham acesso à chave AWS KMS mestra que você usou. Para atribuir permissões a uma aplicação para acessar uma chave do AWS KMS gerada pelo usuário, consulte Permissões para usar as chaves do KMS geradas pelo usuário.

  8. Para editar o período de retenção de dados, selecione Editar na seção Período de retenção de dados e insira um novo período de retenção de dados.

  9. Se métricas personalizadas estiverem habilitadas na conta, selecione Editar na seção Métricas em nível de fragmento e, em seguida, especifique as métricas de seu fluxo. Para obter mais informações, consulte Monitore o serviço Amazon Kinesis Data Streams com a Amazon CloudWatch.

Usar a API

Para atualizar os detalhes do fluxo usando a API, consulte os seguintes métodos:

Use o comando AWS CLI

Para obter informações sobre como atualizar um stream usando o AWS CLI, consulte a referência da Kinesis CLI.

Para configurar a taxa de transferência quente usando o AWS CLI, use o update-stream-warm-throughput comando. Por exemplo:

aws kinesis update-stream-warm-throughput \
    --stream-arn arn:aws:kinesis:us-east-1:123456789012:stream/my-stream \
    --warm-throughput-mi-bps=200

Para reduzir a capacidade, reconfigure warm-throughput-mi-bps para o mesmo valor ou para um valor menor:

aws kinesis update-stream-warm-throughput \
    --stream-arn arn:aws:kinesis:us-east-1:123456789012:stream/my-stream \
    --warm-throughput-mi-bps=50

O fluxo é dimensionado de acordo com a taxa de transferência quente solicitada ou a capacidade necessária para suportar o pico recente de uso de ingestão de dados, o que for maior.