メニュー
Amazon Kinesis Data Streams
開発者ガイド

Amazon Kinesis Data Streams でのストリームのタグ付け

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

タグの基本

Kinesis Data Streams コンソール、AWS CLI、または Kinesis Data Streams API を使用して、次のタスクを実行します。

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

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

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

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

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

  • 所有者: 名前

  • 目的: 負荷テスト

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

  • 環境: 本稼働

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

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

タグの制限

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

基本制限

  • リソース(ストリーム)あたりのタグの最大数は 50 です。

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

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

タグキーの制限

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

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

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

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

タグ値の制限

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

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

Kinesis Data Streams コンソールを使用したストリームのタグ付け

Kinesis Data Streams コンソールを使用してタグの追加、一覧表示、および削除を行うことができます。

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

  1. Kinesis Data Streams コンソールを開きます。ナビゲーションバーで、リージョンセレクターを展開し、リージョンを選択します。

  2. [Stream List] ページで、ストリームを選択します。

  3. [Stream Details] ページで、[Tags] タブをクリックします。

ストリームにタグを追加するには

  1. Kinesis Data Streams コンソールを開きます。ナビゲーションバーで、リージョンセレクターを展開し、リージョンを選択します。

  2. [Stream List] ページで、ストリームを選択します。

  3. [Stream Details] ページで、[Tags] タブをクリックします。

  4. [Key] フィールドにタグキーを指定し、オプションとして [Value] フィールドにタグ値を指定した後で、[Add Tag] をクリックします。

    [Add Tag] ボタンが有効でない場合は、指定したタグキーまたはタグ値のいずれかがタグの制限を満たしていません。詳細については、「タグの制限」を参照してください。

  5. [Tags] タブのリストに新しいタグを表示するには、更新アイコンをクリックします。

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

  1. Kinesis Data Streams コンソールを開きます。ナビゲーションバーで、リージョンセレクターを展開し、リージョンを選択します。

  2. [Stream List] ページで、ストリームを選択します。

  3. [Stream Details] ページで、[Tags] タブをクリックし、タグの [Remove] アイコンをクリックします。

  4. [Delete Tag] ダイアログボックスで、[Yes, Delete] をクリックします。

AWS CLI を使用したストリームのタグ付け

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

add-tags-to-stream

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

list-tags-for-stream

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

remove-tags-from-stream

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

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

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

AddTagsToStream

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

ListTagsForStream

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

RemoveTagsFromStream

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