Amazon MSK クラスターのタグ付け

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

タグの基本

次のタスクを実行する際に、 Amazon MSK API を使用できます。

• Amazon MSK リソースにタグを追加します。

• Amazon MSK リソースのタグを一覧表示します。

• Amazon MSK リソースからタグを削除します。

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

次に示すのは、いくつかのタグの例です。

• Project: Project name

• Owner: Name

• Purpose: Load testing

• Environment: Production

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

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

タグの制限

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

基本制限

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

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

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

タグキーの制限

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

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

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

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

タグ値の制限

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

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

Amazon MSK API を使用したリソースのタグ付け

次のオペレーションを使用して、Amazon MSK リソースへのタグの追加と削除をしたり、特定の リソースの現在のタグセットを一覧表示したりできます。

• ListTagsForResource

• TagResource

• UntagResource