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

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

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. [データストリームの作成] ページで、データストリームの名前を入力し、[オンデマンド] または[プロビジョンド] のどちらかの容量モードを選択します。デフォルトでは、[On-demand] (オンデマンド) モードが選択されます。詳細については、データストリーム容量モードを選択するを参照してください。

  4. In the Tags section, choose Add new tag. [キー] フィールドでタグを指定し、オプションとして [値] フィールドで値を指定します。

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

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

  6. ストリームの作成中、[データストリーム] ページのストリームの「ステータス」は、「作成」になります。ストリームを使用する準備が完了すると、ステータスは「アクティブ」に変わります。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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