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

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

タグの基本

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

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

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

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

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

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

• 所有者: 名前

• 目的: 負荷テスト

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

• 環境: 本稼働

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

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

タグの制限

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

基本制限

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

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

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

タグキーの制限

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

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

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

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

タグ値の制限

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

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

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

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

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

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

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

3. [ストリームの詳細] ページで、[タグ] タブをクリックします。

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

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

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

3. [ストリームの詳細] ページで、[タグ] タブをクリックします。

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

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

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

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

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

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

3. [ストリームの詳細] ページで、[タグ] タブをクリックし、タグの [削除] アイコンをクリックします。

4. [タグの削除] ダイアログボックスで、[はい、削除する] をクリックします。

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

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