View a markdown version of this page

更新流 - Amazon Kinesis Data Streams
使用控制台使用 API使用 AWS CLI

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

更新流

可以使用 Kinesis Data Streams 控制台、Kinesis Data Streams API 或 AWS CLI更新流详细信息。

注意

您可以为现有流或最近刚创建的流启用服务器端加密。

使用控制台

使用控制台更新数据流

  1. 在以下位置打开亚马逊 Kinesis 控制台。 https://console.aws.amazon.com/kinesis/

  2. 在导航栏中，展开区域选择器并选择一个区域。

  3. 在列表中选择流的名称。Stream Details (流详细信息) 页面显示流配置摘要和监控信息。

  4. 要在数据流的按需容量模式和预置容量模式之间切换，请在配置选项卡中选择编辑容量模式。有关更多信息，请参阅 选择正确的流式传入的模式。

    重要

    对于 AWS 账户中的每个数据流，您可以在 24 小时内两次在按需模式和预置模式之间切换。

  5. 对于启用了 On-demand Advantage 模式的按需模式的数据流，您可以配置热吞吐量以增加或减少流的摄取容量。

    增加摄取容量

    在 “配置” 选项卡中，选择 “编辑热吞吐量”，然后输入高于流当前容量的目标吞吐量值（英寸 MB/s）。该流会立即为至少指定的热吞吐量配置容量，从而确保它能够在不限制的情况下处理预期的流量。例如，如果您预测即将发生的事件将在 200 左右达到峰值 MB/s，请 MB/s 提前将预热吞吐量设置为 200，无需额外付费。

    减少摄取容量

    如果流的规模已明显超过其热吞吐量值，请将热吞吐量重新配置为该值或更低的值，以触发缩小规模。数据流可扩展到请求的数量或支持过去一小时内观察到的峰值数据采集使用量所需的容量，以较高者为准。这样可以确保直播始终保留足够的容量来处理最近的流量模式。

    使用热吞吐量不会产生任何额外费用。有关更多信息，请参阅 On-demand 优势模式的功能和用例。

  6. 对于处于预置模式下的数据流，要编辑分片数量，请在配置选项卡中选择编辑预置分片，然后输入新的分片数。

  7. 要启用数据记录的服务器端加密，请在Server-side加密部分选择编辑。选择 KMS 密钥用作加密的主密钥，或使用由 Kinesis 管理的默认主密钥。 aws/kinesis 如果您为流启用加密并使用自己的 AWS KMS 主密钥，请确保您的生产者和消费者应用程序有权访问您使用的 AWS KMS 主密钥。要将权限分配给应用程序以访问用户生成的 AWS KMS 密钥，请参阅使用用户生成的 KMS 密钥的权限。

  8. 要编辑数据保留期，请选择 Data retention period 部分中的 Edit，然后输入新的数据保留期。

  9. 如果您已在自己账户上启用自定义指标，请在分片级别指标部分中选择编辑，然后指定流的指标。有关更多信息，请参阅 使用亚马逊监控亚马逊 Kinesis Data Streams 服务 CloudWatch。

使用 API

要使用 API 更新流详细信息，请参阅以下方法：

使用 AWS CLI

有关使用更新直播的信息 AWS CLI，请参阅 Kinesis CLI 参考文档。

要使用配置热吞吐量 AWS CLI，请使用update-stream-warm-throughput命令。例如：

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

要降低容量，请重新配置warm-throughput-mi-bps为相同或更低的值：

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

数据流可扩展到请求的热吞吐量或支持近期峰值数据采集使用量所需的容量，以较高者为准。