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

# Amazon Kinesis Data Streams リソースにタグを付ける
<a name="tagging"></a>

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

**Topics**
+ [タグの基本を確認する](#tagging-basics)
+ [タグ付けを使用したコストを追跡する](#tagging-billing)
+ [タグの制限を理解する](#tagging-restrictions)
+ [Kinesis Data Streams コンソールを使用してストリームにタグ付けする](#tagging-console)
+ [を使用してストリームにタグを付ける AWS CLI](#tagging-cli)
+ [Kinesis Data Streams API を使用したストリームにタグを付ける](#tagging-api)
+ [を使用してコンシューマーにタグを付ける AWS CLI](#tagging-consumers-cli)
+ [Kinesis Data Streams API を使用してコンシューマーにタグ付けする](#tagging-consumers-api)

## タグの基本を確認する
<a name="tagging-basics"></a>

タグ付けできる 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` の権限を付与する必要があります。

## タグ付けを使用したコストを追跡する
<a name="tagging-billing"></a>

タグを使用して、 AWS コストを分類および追跡できます。Kinesis Data Streams リソースにタグを適用すると、 AWS コスト配分レポートには、タグ別に集計された使用量とコストが含まれます。コストセンター、アプリケーション名、所有者などの自社のカテゴリを表すタグを適用すると、複数のサービスにわたってコストを分類することができます。詳細については、*AWS Billing ユーザーガイド*の[コスト配分タグを使用したカスタム請求レポート](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)を参照してください。

## タグの制限を理解する
<a name="tagging-restrictions"></a>

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

**基本制限**
+ 1 つのリソースに付けることができるタグの最大数は 50 です。
+ タグキーと値は大文字と小文字が区別されます。
+ 削除されたリソースのタグを変更または編集することはできません。

**タグキーの制限**
+ 各タグキーは一意である必要があります。既に使用されているキーを持つタグを追加すると、新しいタグによって既存のキーと値のペアが上書きされます。
+ このプレフィックスはユーザーに代わって`aws:`このプレフィックスで始まるタグ AWS AWS を作成するため、 でタグキーを開始することはできませんが、編集または削除することはできません。
+ タグキーの長さは 1～128 文字 (Unicode) にする必要があります。
+ タグキーは、次の文字で構成する必要があります。Unicode 文字、数字、空白、特殊文字 (`_ . / = + - @`)。

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

## Kinesis Data Streams コンソールを使用してストリームにタグ付けする
<a name="tagging-console"></a>

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

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

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

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

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

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

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

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

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

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

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

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

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

   キャパシティモードの詳細については、[適切なストリームモードを選ぶ](how-do-i-size-a-stream.md) を参照してください。

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

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

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

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

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

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

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

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

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

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

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

1. [**タグ**] で、次のいずれかを実行します。
   + 新しいタグを追加するには、[**新しいタグを追加**] を選択し、タグの [**キー**] と [**値**] を入力します。このステップを必要な回数繰り返します。

     ストリームあたり追加できるタグの最大数は 50 です。
   + 既存のタグを更新するには、そのタグの [**キー**] の [**値**] フィールドに新しいタグ値を入力します。

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

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

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

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

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

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

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

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

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

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

## を使用してストリームにタグを付ける AWS CLI
<a name="tagging-cli"></a>

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

 [create-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/create-stream.html)   
タグ付きのストリームを作成します。

 [add-tags-to-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/add-tags-to-stream.html)   
指定したストリームのタグを追加または更新します。

 [list-tags-for-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/list-tags-for-stream.html)  
指定したストリームのタグを一覧表示します。

 [remove-tags-from-stream](https://docs.aws.amazon.com/cli/latest/reference/kinesis/remove-tags-from-stream.html)  
指定したストリームからタグを削除します。

## Kinesis Data Streams API を使用したストリームにタグを付ける
<a name="tagging-api"></a>

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

 [CreateStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_CreateStream.html)   
タグ付きのストリームを作成します。

 [AddTagsToStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_AddTagsToStream.html)   
指定したストリームのタグを追加または更新します。

 [ListTagsForStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_ListTagsForStream.html)  
指定したストリームのタグを一覧表示します。

 [RemoveTagsFromStream](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_RemoveTagsFromStream.html)  
指定したストリームからタグを削除します。

## を使用してコンシューマーにタグを付ける AWS CLI
<a name="tagging-consumers-cli"></a>

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

[register-stream-consumer](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/register-stream-consumer.html)  
タグを使用して Kinesis データストリームにコンシューマーを登録します。

[tag-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/tag-resource.html)  
指定された Kinesis リソースのタグを追加または更新します。

[list-tags-for-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/list-tags-for-resource.html)  
指定された Kinesis リソースのタグを一覧表示します。

[untag-resource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kinesis/untag-resource.html)  
指定された Kinesis リソースからタグを削除します。

## Kinesis Data Streams API を使用してコンシューマーにタグ付けする
<a name="tagging-consumers-api"></a>

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

[RegisterStreamConsumer](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_RegisterStreamConsumer.html)  
タグを使用して Kinesis データストリームにコンシューマーを登録します。

[TagResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_TagResource.html)  
指定された Kinesis リソースのタグを追加または更新します。

[ListTagsForResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_ListTagsForResource.html)  
指定された Kinesis リソースのタグを一覧表示します。

[UntagResource](https://docs.aws.amazon.com/kinesis/latest/APIReference/API_UntagResource.html)  
指定された Kinesis リソースからタグを削除します。