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

# Amazon MSK クラスターをタグ付ける
<a name="msk-tagging"></a>

独自のメタデータは、*タグ*の形で MSK クラスターなどの Amazon MSK リソースに割り当てることができます。タグは、リソースに対して設定するキーと値のペアです。タグの使用は、 AWS リソースを管理し、請求データを含むデータを整理するためのシンプルで強力な方法です。

**Topics**
+ [Amazon MSK クラスターのタグの基本](msk-tagging-basics.md)
+ [タグ付けを使用して Amazon MSK クラスターのコストを追跡する](msk-tagging-billing.md)
+ [タグの制限](msk-tagging-restrictions.md)
+ [Amazon MSK API を使用してリソースをタグ付ける](msk-tagging-howto.md)

# Amazon MSK クラスターのタグの基本
<a name="msk-tagging-basics"></a>

次のタスクを実行する際に、 Amazon MSK API を使用できます。
+ Amazon MSK リソースにタグを追加します。
+ Amazon MSK リソースのタグを一覧表示します。
+ Amazon MSK リソースからタグを削除します。

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

次に示すのは、いくつかのタグの例です：
+ `Project: Project name`
+ `Owner: Name`
+ `Purpose: Load testing` 
+ `Environment: Production` 

# タグ付けを使用して Amazon MSK クラスターのコストを追跡する
<a name="msk-tagging-billing"></a>

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

# タグの制限
<a name="msk-tagging-restrictions"></a>

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

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

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

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

# Amazon MSK API を使用してリソースをタグ付ける
<a name="msk-tagging-howto"></a>

次のオペレーションを使用して、Amazon MSK リソースへのタグの追加と削除をしたり、特定の リソースの現在のタグセットを一覧表示したりできます。
+ [ListTagsForResource](https://docs.aws.amazon.com//msk/1.0/apireference/tags-resourcearn.html#ListTagsForResource)
+ [TagResource](https://docs.aws.amazon.com//msk/1.0/apireference/tags-resourcearn.html#TagResource)
+ [UntagResource](https://docs.aws.amazon.com//msk/1.0/apireference/tags-resourcearn.html#UntagResource)