View a markdown version of this page

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

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

更新串流

您可以使用 Kinesis Data Streams 主控台、Kinesis Data Streams API 或 AWS CLI更新串流詳細資料。

注意

您可為現有的串流或最近剛建立的串流啟用伺服器端加密。

使用主控台

使用主控台更新資料串流

  1. 在 https://console.aws.amazon.com/kinesis 上開啟 Amazon Kinesis 主控台。

  2. 在導覽列中，展開區域選擇工具，然後選擇一個區域。

  3. 從清單中選擇串流的名稱。Stream Details (串流詳細資訊) 頁面會顯示串流組態的摘要和監控資訊。

  4. 若要在資料串流的隨需和佈建容量模式之間進行切換，請在組態索引標籤中選擇編輯容量模式。如需詳細資訊，請參閱選擇要在 中串流的正確模式。

    重要

    對於您 AWS 帳戶中的每個資料串流，您可以在 24 小時內在隨需和佈建模式之間切換兩次。

  5. 對於啟用隨需優勢模式的隨需模式下的資料串流，您可以設定暖輸送量來增加或減少串流的擷取容量。

    增加擷取容量

    在組態索引標籤中，選擇編輯暖輸送量，然後輸入高於串流目前容量的目標輸送量值 （以 MB/s 為單位）。串流會立即將容量佈建至至少指定的暖輸送量，確保其可以處理預期的流量，而不會調節。例如，如果您預測即將發生的事件達到大約 200 MB/s 的峰值，請事先將暖輸送量設定為 200 MB/s，無需額外費用。

    減少擷取容量

    如果串流大幅超出其暖輸送量值，請將暖輸送量重新設定為該值或更低，以觸發縮減。串流會擴展至請求的數量，或支援過去一小時內觀察到的尖峰資料擷取用量所需的容量，以較高者為準。這可確保串流一律保留足夠的容量來處理最近的流量模式。

    使用暖輸送量不會產生任何額外費用。如需詳細資訊，請參閱隨需優勢模式功能和使用案例。

  6. 對於具有佈建模式的資料串流，若要編輯碎片數目，請在組態索引標籤中選擇編輯已佈建的碎片，然後輸入新的碎片計數。

  7. 若要對資料記錄啟用伺服器端加密，從 Server-side encryption (伺服器端加密) 區段選擇 Edit (編輯)。選擇要使用做為加密主金鑰的 KMS 金鑰，或者使用由 Kinesis 管理的預設主金鑰 aws/kinesis。如果您啟用串流的加密並使用自己的 AWS KMS 主金鑰，請確定您的生產者和取用者應用程式可存取您使用 AWS KMS 的主金鑰。若要為應用程式指派許可使其能夠存取使用者產生的 AWS KMS 金鑰，請參閱 使用使用者產生之 KMS 金鑰的許可。

  8. 若要編輯資料保留期間，從 Data retention period (資料保留期間) 區段選擇 Edit (編輯)，然後輸入新的資料保留期間。

  9. 若您已對自己的帳戶啟用自訂指標，請從 Shard level metrics (碎片級指標) 區段選擇 Edit (編輯)，然後為您的串流指定指標。如需詳細資訊，請參閱使用 Amazon CloudWatch 監控 Amazon Kinesis Data Streams 服務 Amazon 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

串流會擴展到請求的暖輸送量或支援最近尖峰資料擷取用量所需的容量，以較高者為準。