Amazon Kinesis Data Streams リソースにタグを付ける - Amazon Kinesis Data Streams
タグの基本を確認するタグ付けを使用したコストを追跡するタグの制限を理解するKinesis Data Streams コンソールを使用してストリームにタグ付けするAWS CLI を使用してストリームにタグを付けるKinesis Data Streams API を使用したストリームにタグを付けるAWS CLI を使用してコンシューマーにタグを付けるKinesis Data Streams API を使用してコンシューマーにタグ付けする

Amazon Kinesis Data Streams リソースにタグを付ける

Amazon Kinesis Data Streams で作成したストリームおよび拡張ファンアウトコンシューマーに、独自のメタデータをタグ形式で割り当てることができます。タグは、ストリームに対して定義するキーと値のペアです。タグの使用は、AWS リソースの管理やデータ (請求データなど) の整理を行うシンプルかつ強力な方法です。

タグの基本を確認する

タグ付けできる Kinesis Data Streams リソースには、データストリームと拡張ファンアウトコンシューマーが含まれます。Kinesis Data Streams コンソール、AWS CLI、または Kinesis Data Streams API を使用して、以下のタスクを実行します。

  • タグの付いたリソースを作成する

  • リソースにタグを追加する

  • リソースのタグを一覧表示する

  • リソースからタグを削除する

注記

Kinesis Data Streams コンソールでは、拡張ファンアウトコンシューマーにタグを適用することはできません。コンシューマーにタグを適用するには、AWS CLI または Kinesis Data Streams API を使用してください。

タグを使用して リソースを分類できます。例えば、目的、所有者、環境などに基づいてリソースを分類できます。タグごとにキーと値を定義するため、特定のニーズを満たすためのカテゴリのカスタムセットを作成できます。たとえば、所有者と、関連するアプリケーションに基づいてリソースを追跡するのに役立つタグのセットを定義できます。次にいくつかのタグの例を示します。

  • プロジェクト: プロジェクト名

  • 所有者: 名前

  • 目的: 負荷テスト

  • アプリケーション: アプリケーション名

  • 環境: 本稼働

重要

  • ストリームの作成中にタグを追加するには、そのストリームに対して kinesis:CreateStream と kinesis:AddTagsToStream の権限を付与する必要があります。ストリーム作成時に kinesis:TagResource 権限を使用してタグ付けすることはできません。

  • コンシューマー登録中にタグを追加するには、kinesis:TagResource とkinesis:RegisterStreamConsumer の権限を付与する必要があります。

タグ付けを使用したコストを追跡する

タグを使用して、AWS コストを分類して追跡できます。Kinesis Data Streams のリソースにタグを適用すると、AWS のコスト配分レポートにタグごとに集計された使用状況とコストが含まれます。コストセンター、アプリケーション名、所有者などの自社のカテゴリを表すタグを適用すると、複数のサービスにわたってコストを分類することができます。詳細については、AWS Billing ユーザーガイドのコスト配分タグを使用したカスタム請求レポートを参照してください。

タグの制限を理解する

タグには以下の制限があります。

基本制限

  • 1 つのリソースに付けることができるタグの最大数は 50 です。

  • タグのキーと値は大文字と小文字が区別されます。

  • 削除されたリソースのタグを変更または編集することはできません。

タグキーの制限

  • 各タグキーは一意である必要があります。既に使用されているキーを含むタグを追加すると、新しいタグで、既存のキーと値のペアが上書きされます。

  • aws: は AWS が使用するように予約されているため、このプレフィックスを含むタグキーで開始することはできません。AWSではユーザーの代わりにこのプレフィックスで始まるタグを作成しますが、ユーザーはこれらのタグを編集または削除することはできません。

  • タグキーの長さは 1～128 文字 (Unicode) にする必要があります。

  • タグキーは、次の文字で構成する必要があります。Unicode 文字、数字、空白、特殊文字 (_ . / = + - @)。

タグ値の制限

  • タグ値の長さは 0～255 文字 (Unicode) にする必要があります。

  • タグ値は空白にすることができます。空白にしない場合は、次の文字で構成する必要があります。Unicode 文字、数字、空白、特殊文字 (_ . / = + - @)。

Kinesis Data Streams コンソールを使用してストリームにタグ付けする

Kinesis Data Streams コンソールを使用して、ストリームにタグを追加、更新、一覧表示、および削除できます。

ストリームのタグを表示するには

  1. AWS マネジメントコンソールにサインインして、Kinesis コンソール (https://console.aws.amazon.com/kinesis) を開きます。

  2. 左のナビゲーションペインの [データストリーム] を選択します。

  3. [データストリーム] ページで、タグ付けするストリームを選択します。

  4. [ストリームの詳細] ページで、[設定] タブを選択します。

  5. [タグ] セクションで、ストリームに適用されているタグを表示します。

タグを使用してデータストリームを作成するには

  1. Kinesis Data Streams コンソールを開きます。

  2. 左のナビゲーションペインの [データストリーム] を選択します。

  3. [データストリームの作成] を選択します。

  4. [データストリームの作成] ページで、データストリームの名前を入力します。

  5. [データストリームの容量] には、[オンデマンド] または [プロビジョンド] のキャパシティモードを選択します。

    キャパシティモードの詳細については、適切なストリームモードを選ぶ を参照してください。

  6. [タグ] セクションで、次の操作を行います。

    1. [新しいタグを追加] をクリックします。

    2. [キー] フィールドでタグを入力し、オプションとして [値] フィールドで値を指定します。

      エラーが表示された場合は、指定したタグキーまたは値がタグ制限を満たしていません。詳細については、タグの制限を理解するを参照してください。

  7. [データストリームの作成] を選択します。

ストリームにタグを追加または更新するには

  1. Kinesis Data Streams コンソールを開きます。

  2. 左のナビゲーションペインの [データストリーム] を選択します。

  3. [データストリーム] ページで、タグを追加または更新するストリームを選択します。

  4. [ストリームの詳細] ページで、[設定] タブを選択します。

  5. [タグ] セクションで、[タグを管理] を選択します。

  6. [タグ] で、次のいずれかを実行します。

    • 新しいタグを追加するには、[新しいタグを追加] を選択し、タグの [キー] と [値] を入力します。このステップを必要な回数繰り返します。

      ストリームあたり追加できるタグの最大数は 50 です。

    • 既存のタグを更新するには、そのタグの [キー] の [値] フィールドに新しいタグ値を入力します。

    エラーが表示された場合は、指定したタグキーまたは値がタグ制限を満たしていません。詳細については、タグの制限を理解するを参照してください。

  7. [Save changes] (変更の保存) をクリックします。

ストリームからタグを削除するには

  1. Kinesis Data Streams コンソールを開きます。

  2. 左のナビゲーションペインの [データストリーム] を選択します。

  3. [データストリーム] ページで、タグを削除するストリームを選択します。

  4. [ストリームの詳細] ページで、[設定] タブを選択します。

  5. [タグ] セクションで、[タグを管理] を選択します。

  6. 削除するタグの [キー] と [値] のペアを検出します。次に、[削除] を選択します。

  7. [Save changes] (変更の保存) をクリックします。

AWS CLI を使用してストリームにタグを付ける

AWS CLI を使用して、ストリームにタグの追加、一覧表示、および削除できます 例については、次のドキュメントを参照してください。

create-stream

タグ付きのストリームを作成します。

add-tags-to-stream

指定したストリームのタグを追加または更新します。

list-tags-for-stream

指定したストリームのタグを一覧表示します。

remove-tags-from-stream

指定したストリームからタグを削除します。

Kinesis Data Streams API を使用したストリームにタグを付ける

Kinesis Data Streams API を使用して、ストリームにタグを追加、一覧表示、および削除できます。例については、次のドキュメントを参照してください。

CreateStream

タグ付きのストリームを作成します。

AddTagsToStream

指定したストリームのタグを追加または更新します。

ListTagsForStream

指定したストリームのタグを一覧表示します。

RemoveTagsFromStream

指定したストリームからタグを削除します。

AWS CLI を使用してコンシューマーにタグを付ける

AWS CLI を使用して、コンシューマーにタグを追加、一覧表示、および削除できます。例については、次のドキュメントを参照してください。

register-stream-consumer

タグを使用して Kinesis データストリームにコンシューマーを登録します。

tag-resource

指定された Kinesis リソースのタグを追加または更新します。

list-tags-for-resource

指定された Kinesis リソースのタグを一覧表示します。

untag-resource

指定された Kinesis リソースからタグを削除します。

Kinesis Data Streams API を使用してコンシューマーにタグ付けする

Kinesis Data Streams API を使用してコンシューマーにタグを追加、一覧表示、および削除できます。例については、次のドキュメントを参照してください。

RegisterStreamConsumer

タグを使用して Kinesis データストリームにコンシューマーを登録します。

TagResource

指定された Kinesis リソースのタグを追加または更新します。

ListTagsForResource

指定された Kinesis リソースのタグを一覧表示します。

UntagResource

指定された Kinesis リソースからタグを削除します。