翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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 コンソールを使用して、ストリームのタグを追加、更新、一覧表示、削除できます。
ストリームのタグを表示するには
-
にサインイン AWS Management Console し、https://console.aws.amazon.com/kinesis
で Kinesis コンソールを開きます。 -
左側のナビゲーションペインで、データストリームを選択します。
-
データストリームページで、タグ付けするストリームを選択します。
-
ストリームの詳細ページで、設定を選択します。
-
タグセクションで、ストリームに適用されているタグを表示します。
タグを使用してデータストリームを作成するには
-
Kinesis Data Streams コンソールを開きます。
-
左側のナビゲーションペインで、データストリームを選択します。
-
[データストリームの作成] を選択します。
-
データストリームの作成ページで、データストリームの名前を入力します。
-
データストリーム容量には、オンデマンドまたはプロビジョンドキャパシティモードを選択します。
キャパシティモードの詳細については、「」を参照してくださいデータストリーム容量モードを選択する。
-
[タグ] セクションで、次の操作を行います。
-
[新しいタグを追加] をクリックします。
-
Key には、 タグを入力し、オプションで Value フィールドに値を指定します。
エラーが表示された場合は、指定したタグキーまたは値がタグ制限を満たしていません。詳細については、「タグの制限を理解する」を参照してください。
-
-
[データストリームの作成] を選択します。
ストリームにタグを追加または更新するには
-
Kinesis Data Streams コンソールを開きます。
-
左側のナビゲーションペインで、データストリームを選択します。
-
データストリームページで、タグを追加または更新するストリームを選択します。
-
ストリームの詳細ページで、設定 を選択します。
-
[タグ] セクションで、[タグを管理] を選択します。
-
タグで、次のいずれかを実行します。
-
新しいタグを追加するには、新しいタグを追加を選択し、タグのキーと値データを入力します。このステップを必要な回数繰り返します。
各ストリームに追加できるタグの最大数は 50 です。
-
既存のタグを更新するには、そのタグのキーの値フィールドに新しいタグ値を入力します。
エラーが表示された場合は、指定したタグキーまたは値がタグ制限を満たしていません。詳細については、「タグの制限を理解する」を参照してください。
-
-
[Save changes] (変更の保存) をクリックします。
ストリームからタグを削除するには
-
Kinesis Data Streams コンソールを開きます。
-
左側のナビゲーションペインで、データストリームを選択します。
-
データストリームページで、タグを削除するストリームを選択します。
-
ストリームの詳細ページで、設定 を選択します。
-
[タグ] セクションで、[タグを管理] を選択します。
-
削除するタグのキーと値のペアを見つけます。次に、[削除] を選択します。
-
[Save changes] (変更の保存) をクリックします。
を使用してストリームにタグを付ける AWS CLI
を使用して、ストリームのタグを追加、一覧表示、削除できます AWS CLI。例については、次のドキュメントを参照してください。
- create-stream
-
タグ付きのストリームを作成します。
- add-tags-to-stream
-
指定したストリームのタグを追加または更新します。
- list-tags-for-stream
-
指定したストリームのタグを一覧表示します。
- remove-tags-from-stream
-
指定したストリームからタグを削除します。
Kinesis Data Streams APIs
Kinesis Data Streams APIs を使用して、ストリームのタグを追加、一覧表示、削除できます。例については、次のドキュメントを参照してください。
- CreateStream
-
タグ付きのストリームを作成します。
- AddTagsToStream
-
指定したストリームのタグを追加または更新します。
- ListTagsForStream
-
指定したストリームのタグを一覧表示します。
- RemoveTagsFromStream
-
指定したストリームからタグを削除します。
を使用してコンシューマーにタグを付ける AWS CLI
を使用して、コンシューマーのタグを追加、一覧表示、削除できます AWS CLI。例については、次のドキュメントを参照してください。
- register-stream-consumer
-
Kinesis データストリームのコンシューマーをタグで登録します。
- タグリソース
-
指定された Kinesis リソースのタグを追加または更新します。
- list-tags-for-resource
-
指定された Kinesis リソースのタグを一覧表示します。
- タグなしリソース
-
指定された Kinesis リソースからタグを削除します。
Kinesis Data Streams APIs
Kinesis Data Streams APIs を使用して、コンシューマーのタグを追加、一覧表示、削除できます。例については、次のドキュメントを参照してください。
- RegisterStreamConsumer
-
Kinesis データストリームのコンシューマーをタグで登録します。
- TagResource
-
指定された Kinesis リソースのタグを追加または更新します。
- ListTagsForResource
-
指定された Kinesis リソースのタグを一覧表示します。
- UntagResource
-
指定された Kinesis リソースからタグを削除します。