View a markdown version of this page

ストリームを更新する - Amazon Kinesis Data Streams
コンソールを使用するAPI を使用するを使用する AWS CLI

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ストリームを更新する

Kinesis Data Streams コンソール、Kinesis Data Streams API、または AWS CLIを使用して、ストリームの詳細を更新できます。

注記

既存のストリーム、または最近作成したストリームに対して、サーバー側の暗号化を有効にすることができます。

コンソールを使用する

コンソールを使用してデータストリームを更新するには

  1. Amazon Kinesis コンソール (https://console.aws.amazon.com/kinesis/) を開きます。

  2. ナビゲーションバーで、リージョンセレクターを展開し、リージョンを選択します。

  3. リストのストリームの名前を選択します。[ストリームの詳細] ページには、ストリーム設定の概要とモニタリング情報が表示されます。

  4. データストリームのオンデマンド容量モードとプロビジョンド容量モードを切り替えるには、[Configuratio] (設定) タブの [Edit capacity mode] (容量モードの編集) を選択します。詳細については、「適切なストリームモードを選ぶ」を参照してください。

    重要

    AWS アカウントのデータストリームごとに、オンデマンドモードとプロビジョニングモードを 24 時間以内に 2 回切り替えることができます。

  5. オンデマンドアドバンテージモードが有効になっているオンデマンドモードのデータストリームの場合、ストリームの取り込み容量を増減するようにウォームスループットを設定できます。

    取り込み容量を増やすには

    設定タブで、ウォームスループットの編集を選択し、ストリームの現在の容量よりも高いターゲットスループット値 (MB/秒) を入力します。ストリームは、少なくとも指定されたウォームスループットに容量を直ちにプロビジョニングし、スロットリングなしで予想されるトラフィックを処理できるようにします。たとえば、今後のイベントが約 200 MB/秒でピークに達すると予測される場合は、追加料金なしでウォームスループットを事前に 200 MB/秒に設定します。

    取り込み容量を減らすには

    ストリームがウォームスループット値を大幅に超えてスケールした場合は、ウォームスループットをその値以下に再設定してスケールダウンをトリガーします。ストリームは、リクエストされた数、または過去 1 時間以内に観測されたピークデータの取り込み使用量をサポートするために必要な容量のいずれか高い方までスケールされます。これにより、ストリームは常に最新のトラフィックパターンを処理するのに十分な容量を保持します。

    ウォームスループットを使用しても、追加料金は発生しません。詳細については、「オンデマンドアドバンテージモードの機能とユースケース」を参照してください。

  6. プロビジョンドモードのデータストリームの場合、シャードの数を編集するには、[Configuration] (設定) タブの [Edit provisioned shards] (プロビジョニングされたシャードの編集) を選択し、新しいシャードカウントを入力します。

  7. データレコードのサーバー側の暗号化を有効にするには、[サーバー側の暗号化] セクションの [編集] を選択します。暗号化のマスターキーとして使用する KMS キーを選択するか、 Kinesis によって管理されるデフォルトのマスターキー aws/kinesis を使用します。ストリームの暗号化を有効にし、独自の AWS KMS マスターキーを使用する場合は、プロデューサーアプリケーションとコンシューマーアプリケーションが、使用した AWS KMS マスターキーにアクセスできることを確認してください。ユーザーが生成した AWS KMS キーにアクセスするためのアクセス許可をアプリケーションに割り当てるには、ユーザー生成の KMS キーを使用するための許可を参照してください。

  8. データ保持期間を編集するには、[Data retention period] セクションの [Edit] を選択し、新しいデータ保持期間を入力します。

  9. アカウントでカスタムメトリクスを有効にした場合は、[シャードレベルメトリクスの編集] セクションの [編集] を選択し、ストリームのメトリクスを指定します。詳細については、「Amazon CloudWatch による Amazon Kinesis Data Streams サービスを監視する」を参照してください。

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

ストリームは、リクエストされたウォームスループット、または最近のピークデータの取り込み使用量をサポートするために必要な容量のいずれか高い方までスケールされます。